About Instant Collect
InstantCollect
A complete quality-of-life automation suite for resource gathering and container looting.
One configurable menu. Granular permissions. Modern flat UI. Built for both Carbon and Oxide.
Why InstantCollect
QuotePlayers spend hours running between furnaces, looting barrels by hand, and waiting for cooked meat. InstantCollect removes the friction, letting your community focus on what matters: building, raiding, and survival itself.
Every feature is opt-in per player through the in-game UI and gated by permissions - you decide who gets what.
Features
- Instant Smelting - Ore mined from any resource node is converted into its smelted form the moment it enters the inventory. Metal ore, sulfur ore, HQM ore, wood - fully configurable, with custom ratios.
- Auto-Cooking - Raw meat from killed animals (wolf, bear, deer, chicken, boar, fish, human) is cooked automatically. Saves the campfire trip.
- Auto-Loot Containers - 12+ pre-configured container categories supported out of the box: basic crates, military crates, elite, medical, food, tool, ammo, heli crate, Bradley crate, hackable crates, supply drops, animals, player bags, vehicle parts, all five Underwater Lab crate variants, mission tackleboxes and treasure chests.
- Quick Mining - One-hit resource gathering. Hit a stone node, get the full yield instantly - no more chip-by-chip mining for impatient players.
- Smart Loot Resolution - Distinguishes between identical-named prefabs at different locations using full prefab paths - surface barrels and underwater lab crates handled separately.
Modern Configurable UI
- Two-tab interface: Smelt + Containers
- Live ON / OFF toggles per category
- VIP badges on locked features (drives premium sales)
- Sortable by access - available items shown first
- Custom logo support with full positioning control
- Every UI color exposed as hex in config (no recompile required)
Performance
- O(1) prefab and category lookups via pre-built dictionaries
- Lazy per-player data loading - only active players in memory
- Per-player JSON files - no monolithic database file
- Pool-based UI string generation, zero GC churn on renders
- Rate-limited toggle clicks (0.5s) - protects against spam
Permissions
Quoteinstantcollect.smelt.metal - instant smelt metal ore
instantcollect.smelt.sulfur - instant smelt sulfur ore
instantcollect.smelt.hqm - instant smelt HQM ore
instantcollect.smelt.wood - instant burn wood to charcoal
instantcollect.cook.wolf - auto-cook wolf meat
instantcollect.cook.bear - auto-cook bear meat (per meat type)
instantcollect.autoloot.barrel - auto-loot barrels
instantcollect.autoloot.basic - auto-loot basic crates (per container category)
instantcollect.quickmining - one-hit resource nodes
Build VIP tiers by granting subsets - give donators the high-tier crates (heli, bradley, hackable) and basic users the lower-tier ones.
Configuration
Everything is configurable without touching code. Click below to expand the full default config.
{
"Open command": "ipro",
"Quick mining enabled": true,
"Quick mining permission": "InstantCollect.quickmining",
"Logo": {
"URL or path": "",
"Width (px)": 44,
"Height (px)": 44,
"Left offset (px)": 12,
"Top offset (px)": 12,
"Gap to text (px)": 12
},
"UI colors": {
"Panel background": "#1E2020",
"Text primary (warm white)": "#EDE0D8",
"Accent green (ON state)": "#809655",
"Accent green light (ON text)": "#A5D673",
"Accent red (OFF state)": "#CB4029",
"Accent red light (OFF text)": "#EB7366",
"VIP gold": "#DABD44",
"VIP gold text": "#E8C864",
"Switch knob ON (dark green)": "#1A260D",
"Switch knob OFF (dark red)": "#330D0A"
},
"Smelt entries": [
{
"Source shortname": "metal.ore",
"Result shortname": "metal.fragments",
"Permission": "InstantCollect.smelt.metal",
"Ratio": 1.0,
"Source icon URL": "InstantCollect/Images/metal-ore.png",
"Result icon URL": ""
},
{
"Source shortname": "sulfur.ore",
"Result shortname": "sulfur",
"Permission": "InstantCollect.smelt.sulfur",
"Ratio": 1.0,
"Source icon URL": "InstantCollect/Images/sulfur-ore.png",
"Result icon URL": ""
},
{
"Source shortname": "hq.metal.ore",
"Result shortname": "metal.refined",
"Permission": "InstantCollect.smelt.hqm",
"Ratio": 1.0,
"Source icon URL": "InstantCollect/Images/metal-ore.png",
"Result icon URL": ""
},
{
"Source shortname": "wood",
"Result shortname": "charcoal",
"Permission": "InstantCollect.smelt.wood",
"Ratio": 0.75,
"Source icon URL": "",
"Result icon URL": ""
},
{
"Source shortname": "wolfmeat.raw",
"Result shortname": "wolfmeat.cooked",
"Permission": "InstantCollect.cook.wolf",
"Ratio": 1.0,
"Source icon URL": "",
"Result icon URL": ""
},
{
"Source shortname": "bearmeat",
"Result shortname": "bearmeat.cooked",
"Permission": "InstantCollect.cook.bear",
"Ratio": 1.0,
"Source icon URL": "",
"Result icon URL": ""
},
{
"Source shortname": "chicken.raw",
"Result shortname": "chicken.cooked",
"Permission": "InstantCollect.cook.chicken",
"Ratio": 1.0,
"Source icon URL": "",
"Result icon URL": ""
},
{
"Source shortname": "deermeat.raw",
"Result shortname": "deermeat.cooked",
"Permission": "InstantCollect.cook.deer",
"Ratio": 1.0,
"Source icon URL": "",
"Result icon URL": ""
},
{
"Source shortname": "humanmeat.raw",
"Result shortname": "humanmeat.cooked",
"Permission": "InstantCollect.cook.human",
"Ratio": 1.0,
"Source icon URL": "",
"Result icon URL": ""
},
{
"Source shortname": "fish.raw",
"Result shortname": "fish.cooked",
"Permission": "InstantCollect.cook.fish",
"Ratio": 1.0,
"Source icon URL": "",
"Result icon URL": ""
},
{
"Source shortname": "meat.boar",
"Result shortname": "meat.pork.cooked",
"Permission": "InstantCollect.cook.boar",
"Ratio": 1.0,
"Source icon URL": "",
"Result icon URL": ""
}
],
"Loot categories": [
{
"Category key": "Barrel",
"Prefabs": [ "loot-barrel-1", "loot-barrel-2", "loot_barrel_1", "loot_barrel_2", "oil_barrel" ],
"Permission": "InstantCollect.autoloot.barrel",
"Loot on destroy": true,
"Source icon shortname": "diesel_barrel",
"Result icon shortname": "scrap"
},
{
"Category key": "BasicCrate",
"Prefabs": [ "crate_basic", "crate_basic_jungle" ],
"Permission": "InstantCollect.autoloot.basic",
"Loot on destroy": false,
"Result icon shortname": "scrap",
"Source icon URL": "InstantCollect/Images/crate-basic.png"
},
{
"Category key": "MilitaryCrate",
"Prefabs": [ "crate_normal", "crate_normal_2", "crate_normal_2_military" ],
"Permission": "InstantCollect.autoloot.military",
"Loot on destroy": false,
"Source icon shortname": "metal.fragments",
"Result icon shortname": "rifle.ak"
},
{
"Category key": "EliteCrate",
"Prefabs": [ "crate_elite" ],
"Permission": "InstantCollect.autoloot.elite",
"Loot on destroy": false,
"Result icon shortname": "explosive.satchel",
"Source icon URL": "InstantCollect/Images/elite-crate.png"
},
{
"Category key": "MedicalCrate",
"Prefabs": [ "crate_medical" ],
"Permission": "InstantCollect.autoloot.medical",
"Loot on destroy": false,
"Result icon shortname": "largemedkit",
"Source icon URL": "InstantCollect/Images/medical-crate.png"
},
{
"Category key": "FoodCrate",
"Prefabs": [ "crate_food_1", "crate_food_2", "foodbox" ],
"Permission": "InstantCollect.autoloot.food",
"Loot on destroy": false,
"Result icon shortname": "can.beans",
"Source icon URL": "InstantCollect/Images/food-crate.png"
},
{
"Category key": "ToolCrate",
"Prefabs": [ "crate_tools" ],
"Permission": "InstantCollect.autoloot.tool",
"Loot on destroy": false,
"Result icon shortname": "jackhammer",
"Source icon URL": "InstantCollect/Images/tool-crate.png"
},
{
"Category key": "AmmoCrate",
"Prefabs": [ "crate_ammunition" ],
"Permission": "InstantCollect.autoloot.ammo",
"Loot on destroy": false,
"Source icon shortname": "ammo.rifle",
"Result icon shortname": "ammo.rocket.basic"
},
{
"Category key": "HeliCrate",
"Prefabs": [ "heli_crate" ],
"Permission": "InstantCollect.autoloot.heli",
"Loot on destroy": false,
"Source icon shortname": "rocket.launcher",
"Result icon shortname": "lmg.m249"
},
{
"Category key": "BradleyCrate",
"Prefabs": [ "bradley_crate" ],
"Permission": "InstantCollect.autoloot.bradley",
"Loot on destroy": false,
"Source icon shortname": "explosive.timed",
"Result icon shortname": "rifle.bolt"
},
{
"Category key": "HackableCrate",
"Prefabs": [ "codelockedhackablecrate", "codelockedhackablecrate_oilrig" ],
"Permission": "InstantCollect.autoloot.hackable",
"Loot on destroy": false,
"Source icon shortname": "blueprintbase",
"Result icon shortname": "scrap"
},
{
"Category key": "SupplyDrop",
"Prefabs": [ "supply_drop" ],
"Permission": "InstantCollect.autoloot.supply",
"Loot on destroy": false,
"Source icon shortname": "supply.signal",
"Result icon shortname": "rifle.ak"
},
{
"Category key": "Animals",
"Prefabs": [ "wolf-corpse", "bear-corpse", "boar-corpse", "stag-corpse", "chicken-corpse", "horse-corpse" ],
"Permission": "InstantCollect.autoloot.animals",
"Loot on destroy": false,
"Source icon shortname": "skull.wolf",
"Result icon shortname": "wolfmeat.raw"
},
{
"Category key": "PlayerBags",
"Prefabs": [ "item_drop", "item_drop_backpack" ],
"Permission": "InstantCollect.autoloot.bags",
"Loot on destroy": false,
"Source icon shortname": "largebackpack",
"Result icon shortname": "cloth"
}
],
"Config version": { "Major": 1, "Minor": 0, "Patch": 0 }
}
Localization
Ships with English and Russian translations. Standard Oxide language file system - add any language by dropping a JSON file into /lang/<lang>/InstantCollect.json.
{
"Msg.NoPermission": "You don't have permission to use this feature.",
"Msg.Looted": "Auto-looted <color=#7BAA47>{0}</color> items.",
"UI.Title": "Instant Collect",
"UI.Subtitle": "Auto-loot and instant smelt",
"UI.Tab.Smelt": "SMELT",
"UI.Tab.Loot": "CONTAINERS",
"UI.VipBadge": "VIP",
"UI.Sec.Smelt.Title": "Automatic smelting",
"UI.Sec.Smelt.Desc": "Ores you mine are smelted into the final material instantly.",
"UI.Sec.Loot.Title": "Container auto-looting",
"UI.Sec.Loot.Desc": "Containers you open drop their contents into your inventory.",
"UI.QuickMining": "Quick mining",
"Item.metal.ore": "Metal ore",
"Item.sulfur.ore": "Sulfur ore",
"Item.hq.metal.ore": "HQ metal ore",
"Item.wood": "Wood",
"Cat.Barrel": "Barrels",
"Cat.BasicCrate": "Basic Crate",
"Cat.MilitaryCrate": "Military Crate",
"Cat.EliteCrate": "Elite Crate",
"Cat.MedicalCrate": "Medical Crate",
"Cat.FoodCrate": "Food Crate",
"Cat.ToolCrate": "Tool Crate",
"Cat.AmmoCrate": "Ammo Crate",
"Cat.HeliCrate": "Heli Crate",
"Cat.BradleyCrate": "Bradley Crate",
"Cat.HackableCrate": "Hackable Crate",
"Cat.SupplyDrop": "Supply Drop",
"Cat.VehicleParts": "Vehicle Parts",
"Cat.MissionTacklebox": "Mission Tacklebox",
"Cat.MissionTreasure": "Mission Treasure",
"Cat.UWLBasic": "UWL Blue Crate",
"Cat.UWLAdvanced": "UWL Yellow Crate",
"Cat.UWLMedical": "UWL Medical",
"Cat.UWLRation": "UWL Ration Box",
"Cat.UWLTool": "UWL Tool Box",
"Cat.Animals": "Animals",
"Cat.PlayerBags": "Player Bags",
"Item.wolfmeat.raw": "Raw wolf meat",
"Item.bearmeat": "Raw bear meat",
"Item.chicken.raw": "Raw chicken",
"Item.deermeat.raw": "Raw deer meat",
"Item.humanmeat.raw": "Raw human meat",
"Item.fish.raw": "Raw fish"
}
Compatibility
-
Carbon - full support, uses
imageDatabasefor image loading -
Oxide - full support, requires
ImageLibraryplugin - Optional integration paths kept minimal - no hard dependencies
Installation
-
Drop the contents of the
data/folder into/data/InstantCollect/ -
Drop
InstantCollect.csintooxide/plugins/(orcarbon/plugins/) -
Configure permissions through your favorite GUI or
o.grant/c.grant
Defaults are sane and the plugin works out of the box.
Support
Bugs, feature requests, and integration help - drop a message in the Codefling thread or DM. Updates are pushed regularly with bug fixes and new container categories as Facepunch adds them.
Stop wasting time. Start collecting.

