IngotVault

IngotVault - Shared virtual ingot/ore storage and vending machine.

Ingot Vault is a quality-of-life mod for Stationeers that introduces a custom Ingot/Ore Vault storage structure and a companion Remote Ingot Vault terminal. You can insert any size ingots or raw ores/ices into the vaults, and it will store them virtually. You can scroll through the stored metals and ores and vend them as clean, full stacks from either the central vault or a network-connected remote vault terminal. Nearby or network-connected (config based) fabricators instantly have the required ingots added to them when crafting from the vault, eliminating the need to manually move ingots between machines or to have chutes between the vault and the machines.

================================================== KEY FEATURES: ==================================================

- Virtual Ingot/Ore Storage: Unlimited storage of all Ingots, Ores, Ices merging each into one virtual count per type. Keeps your resources in one place and makes crafting easer at the start. - Clean Stack Vending: Select any metal, ore, or ice and output them in clean, maximum size stacks or a stack size of your choosing. - Remote Ingot Vault: Place compact remote terminals connected to the same logic data network to access, import, or vend items from your central vault from anywhere in your base! - Fabricator Pulling: Fabricators (Autolathe, Electronics Printer, etc.) can automatically check and pull reagents from the vault. (uses dimensional space to instantly transfer the exact amount need so no chutes needed) - Customizable Access Scope: Configure if fabricators pull globally, within wireless range (configurable), or only on the exact same logic cable data network. - Dynamic Power Usage: Vault power draw scales dynamically based on the weight of stored metals and ores (configurable). - Logic System Integration: Read stored reagent/ore levels using IC10 logic chips and logic mirrors!

================================================== DATA NETWORK INTEGRATION (MIPS / IC10): ==================================================

The Ingot Vault exposes several logic variables over the data network: - Setting (Read/Write): Gets/Sets the selected item index in the vault's active inventory list. - Quantity (Read): Returns the stored quantity of the currently selected item. - Ratio (Read): Returns the combined total weight (grams/units) of all stored items in the vault. - StackSize (Read/Write): Gets/Sets the vending stack size setting. Setting to 0 uses the item's default maximum stack size (up to 500 for ingots). Writing to this rotates the physical dial wheel. - TargetPrefabHash (Read): Returns the prefab hash of the currently selected item. - RequestHash (Write): Writing a prefab hash to RequestHash automatically selects that item and dispenses it (matching the vending machine protocol). - Activate (Write): Writing 1 triggers a vend request for the currently selected item. - Maximum (Read): Returns the total count of active items in the inventory selection list. - Error (Read): Returns 0.0 for success or 1.0 for failure/locked status of the last vend command.

================================================== VIRTUAL SLOT-LOGIC QUERIES: ==================================================

You can scan the entire vault inventory in a single tick using slot-logic: - Total slots is equal to (Maximum + 2). Slots 0 and 1 represent the physical import and export slots. - Virtual slots start at index 2 (representing stored items). - Query slot properties using 'ls' instructions on slot index (e.g. ls r3 d0 2 OccupantHash): * OccupantHash: Returns the stored item's prefab hash. * Quantity: Returns the stored quantity of that item. * Class: Returns the item's slot class. * MaxQuantity: Returns the item's maximum stack size (500 for ingots, 50 for ores). * SortingClass: Returns the item's sorting class.

================================================== CUSTOM STATIONEERSLUA API (LUA ONLY): ==================================================

If the StationeersLua mod is loaded, you can bypass network latency using custom direct C# bindings: - ic.get_vault_contents(vault_ref): Returns a Lua table of all stored items where keys are prefab hashes and values are quantities. Runs in 0 ticks. Example: local vault_ref = ic.find("Vault") local contents = ic.get_vault_contents(vault_ref) - ic.vault_vend(vault_ref, prefabHash, quantity): Directly requests the vault to vend a specific quantity of an item. Checks availability, immediately reserves/deducts stock from the vault, queues the request, and returns true. If stock is insufficient, returns false. Dispenses stack-by-stack on successive ticks to respect slot physical limits. Example: local vault_ref = ic.find("Vault") local success = ic.vault_vend(vault_ref, 1758427767, 150) - ic.vault_busy(vault_ref): Returns true if the vault is currently exporting or has items in its pending vend queue. Example: local vault_ref = ic.find("Vault") local busy = ic.vault_busy(vault_ref)

================================================== VERSION HISTORY: ================================================== - v1.3.0 (October 9, 2026): * Improved logic for handling recipes with for reagents not supported by the vault.

- v1.2.1 (August 2, 2026): * Bug Fixes: Resolved startup errors when loaded without StationeersLua. Fixed real-time ore/ice synchronization on dedicated servers.