Retrieve Items Order

Retrieve Items From Outposts

Adds a crew order for retrieving loot from abandoned outposts and beacon stations (should be found in the maintenance category).

Assign a crewmember (recommended not to assign more than 1 bot at a time) the retrieval order while docked to a valid abandoned outpost or beacon station then mark the containers you want searched with the contextual Mark Container For Retrieval order. The bot will search marked containers, collect valid items, return to the submarine when full or finished, and deposit the recovered items using Barotrauma’s normal item cleanup/sorting behavior.

Requirements

• LuaCs for Barotrauma (server for functionality, client for visuals)

Compatibility

• tested alongside "order to rest" so i expect other order mods affecting AI orders should be compatible
• non AI order mods should work fine also (tested with Barotraumatic, neurotrauma lite, and enhanced armaments)

Current Features

• New Retrieval crew order
• Contextual container marking for retrieval targets
• Visible marker overlay for marked containers
• Server-side container marking support
• Bots search marked outpost/beacon containers for retrievable items
• Bots return to the submarine when carrying loot or when no more marked loot is found
• Deposit behavior uses vanilla cleanup/sorting logic
• Marked containers are automatically unmarked once fully emptied
• Basic abort handling for severe injury, hostiles, missing targets, and storage failure

Notes

• Bots only retrieve from containers you mark.
• Deposit location is decided by vanilla sorting behavior, not by the marked source container.
• Items without a suitable storage target may be dropped on the sub floor as fallback behavior.
• This mod is intended to automate cleanup-style looting, not combat or hostile outpost clearing.
• Oxygen tanks are currently ignored because just in case the bot is wearing diving mask/suit and needs to swap tanks
• Recommended: assign only one bot to Retrieval at a time.

Known Issues:

• Multiple retrieval bots are not currently coordinated
• Bots may skip or unmark containers they cannot access, such as locked cabinets requiring an ID card. Inaccessible items may be treated as failed targets rather than remaining retrievable loot.
• bot currently does not add items to equipped backpack if carrying one before looting

I'm new to modding so let me know how it is, how to improve etc...