Elevator A.I.

v3.1.2 Sept 30th, 2021

Picard Patch Compatible
Read the note below about Multi Realms

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.
• Dynamic slider maximums
• Multi realm aware

Optional complementary mod: Rocket Stock
Optional complementary mod: Martian Clock

Multi Realm Aware
Elevator A.I. is aware of the multiple realms in the game. (Surface, Underground and Asteroid)
For the purposes of restocking, the A.I only counts the surface realm in stock inventory for the purposes of restock.
This way there is no guessing on where/how much stock you have colony wide.
Why not count underground at least? Because there is no automatic resupply for underground. You must manually do that yourself.
Can you make this restock the underground? No, that is a separate mod coming soon.

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

Dynamic slider maximums
New feature many people wanted was the ability to change the maximum slider values in Elevator A.I.
Now you can.
You will need Mod Config Reborn installed.
Go to Mod Config and change your maximums, then click the Apply button.
Check your sliders in the infopanel of the Space Elevator afterwards.
Mod Config Reborn is here -> Mod Config Reborn

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.

Polish, Spanish, French, German, Bulgarian, Russian

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