Elevator A.I.
v2.2.1 Nov 14th, 2018

Gagarin Patch Compatible

The Elevator A.I. is logic you can install in to your Space Elevator to
automate restocking your colony and control rare metals exports.
Never run out of resources when you need them most.

Features

• Auto Restock Control - Checks for low levels of inventory and reorders it
• Auto Export Control - Controls exporting of rare metals
• Set a reorder schedule from 1 to 5 times a sol
• Granular control of quantity
• Works with all sponsors, game rules and mysteries
• Notifications when the A.I. is working
• Batches all orders for a complete restock.
• Works with multiple Space Elevators if you have them.
  

Inspiration
Inspiration for this mod came from Crysm's Elevator Resupply
and is produced with his permission.

Built from the ground up with all new code and Davinci patch in mind and is new or save game safe.
The mod can be enabled or disabled or removed at any time.

Optional complementary mod: Rocket Stock

How It Works
Automatic Export Control
Once the mod is installed and enabled, you must go to your Space Elevator and turn it on.
If the threshold setting for rare metals is set to zero then the rare metals export control is left alone in the manual state.
You can control the rare metals export as normal.
If the threshold setting for rare metals is greater than zero then the rare metals exporting is fully automatic.
The rare metals slider is the minimum amount of rare metals to always leave in stock in the colony.
If the stock of rare metals in your colony exceeds the threshold then exporting will be turned on.
Returning the rare metals slider to zero sets the exporting control back to what
is was before automation and you can now control it manually.
Exporting rare metals happens when there are rare metals on deck and the normal
once daily export schedule executes or when a restock request happens.
I highly suggest reading the developer notes below.

Automatic Restock Control
Once the mod is installed and enabled, you must go to your Space Elevator and turn it on.
Set your schedule and the threshold of each resource you want to automate restocking.
If the resource is below your set threshold, the Elevator A.I will place an order on the next scheduled check.
A resource set to zero means the A.I. never orders that resource.
Hover over the schedule section to see the schedule.
The threshold is also the reorder amount.
You can manually order any resource at any time by using the standard resupply controls.
If there are any rare metals on deck in the Space Elevator when the A.I. places an order, they are exported.
Regular once daily rare metal exports are unaffected and proceed if allowed.

Disabling the Elevator A.I
You can disable the A.I at any time by clicking the Elevator A.I. button.
Ctrl+Left Click will uninstall the A.I from that elevator if you want to move the
A.I. to another elevator (if you have two or more).

Gameplay

• Takes into consideration all cost modifiers, from sponsor and tech
• Takes into consideration working, maintenance needed and demolished status
• Takes into consideration hunger rules and resupply moratorium
• Takes into consideration mystery's that prevent resupply
• Takes into consideration all Locks and Blacklists for resources
  

Developers Notes
Something to understand about exports:
When rare metals are moved to the Space Elevator they are technically taken out of colony stock.
In order to keep the automatic exports for taking more rare metals from the colony the A.I watches the colony stock.
The elevator export storage will be modified if the colony's excess rare metals stock drops below the storage amount.
This will show in the space elevator as a reduced maximum export storage
amount until your colony's excess stock is greater than minimum
threshold plus the default export storage amount.
To keep the space elevator from flapping exports when the excess rare metals is low a
buffer is introduced - 5% of the minimum threshold amount set (rare
metals slider).
This will allow you to keep some exports going while consuming rare metals if you are close to the minimum threshold you set.
You can play with the amounts based on your consumption to find a sweet spot.
Once the colony's stock of rare metals reached the original export storage amount the buffer is removed.
What does all this look like? Example:
The initial export storage amount of a space elevator is 100.
You have 250 rare metals in your colony and the slider is set to keep a minimum of 200 in stock at all times.
You have an excess of 50 rare metals.
The elevators export storage is modified to be 50. So exports keep going while making sure you have 200 in stock.
The number will continue to drop if you consume more and go closer to 200.
If you start mining more, it will take 5% of 200 from the current excess amount to move it up.
So if you have 259 rare metals in stock, the exports will still be at 50 even though you have 59 excess.
If you hit 260 then you have excess + 5% (60) then the export storage
moves up to 60, and so on until the original maximum export storage.
This will keep your elevator from turning exports on and off during
mining/consuming operations with colony stock near the minimum
threshold.
Reminder: exports still only happen once a day or when a reorder happens and there are rare metals in storage.


Translations
Polish, Spanish, French, German, Bulgarian, Russian

Acknowledgements
Thank you Choggi as always for your support.

Report bugs in the bug report discussion
Feature requests in the feature requests discussion.

Enjoy the mod? Vote UP!

Please check out some of my other work:
SkiRich's Mod Collection