/// SUPPORTED THIRD-PARTY PLUGIN
Better Loot
Free guide for configuring this third-party plugin in the Hub. To install it, use its plugin page or official source.
Prepare your file
- Check the installed version
This guide describes Better Loot 4.5.2. Use the same version in the configurator.
- Get the settings
Choose your server: its settings are retrieved automatically. An existing draft is kept. You can also import files from this device or use the defaults.
- Edit and apply
Adjust settings, fix errors, then apply files to the selected server. A conflict blocks sending until you choose how to resolve it. You can still export only the files you need.
A configuration linked to the server has private backups when files are sent. Unsent edits remain in the editor. Keep your export too, to resume without connecting to the server.
Settings for this version
Appearance 2
- Chat prefix
- Text
Prefix placed before BetterLoot chat replies; Rust color tags are preserved.
JSON path
Chat Configuration → Chat Message Prefix - Steam icon ID (0 = none)
- Whole number
Profile SteamID shown as the chat icon; 0 disables it.
JSON path
Chat Configuration → Chat Message Icon SteamID (0 = None)
General 8
- Blueprint weight
- Number
Source documents a 0–1 scale and 0.5 as balanced.
JSON path
General Configuration → Blueprint Weight (0.0 = min bias, 1.0 = max bias, 0.5 = balanced) - Log updates on load
- On / off
Logs configuration updates detected while the plugin loads.
JSON path
General Configuration → Log Updates On Load - Remove stacked containers
- On / off
At load, removes loot containers stacked within 0.25 horizontal units of one another.
JSON path
General Configuration → Remove Stacked Containers - Update prefab list on wipe only
- On / off
Skips rebuilding the watched-container list on every startup; refreshes it on a new wipe.
JSON path
General Configuration → Only update prefab list on wipe day - Enable new prefabs on wipe
- On / off
On a new wipe, enables newly discovered container prefabs in the watched list.
JSON path
General Configuration → Auto enable new prefabs found on wipe - Watched prefabs
- JSON value
Keys are populated from game prefabs and unwrap items, plus entries present in loot tables.
JSON path
General Configuration → Watched Container Prefabs (true = monitor container loot, false = disabled) - Stand down rates when another gather plugin is loaded
- On / off
Suspends BetterLoot gather-rate changes when a listed gather plugin is loaded.
JSON path
General Configuration → Stand down gather rates if other gather plugins are loaded - Other gather plugins
- List
Plugin names whose presence triggers BetterLoot gather-rate suspension.
JSON path
General Configuration → Other gather plugin names
Loot 11
- Cycle loot on hammer hit
- On / off
Allows hammer hits to cycle a container’s loot; the interval is configured separately.
JSON path
Loot Configuration → Enable Hammer Hit Loot Cycle - Cycle duration (seconds)
- Number
Seconds between loot refreshes triggered by the hammer.
JSON path
Loot Configuration → Hammer Loot Cycle Time - Loot multiplier
- Whole number
Multiplies rolled loot-entry and bonus-item amounts; 1 keeps configured amounts.
JSON path
Loot Configuration → Loot Multiplier - Scrap multiplier
- Whole number
Multiplies scrap generated in loot; 1 keeps the base amount.
JSON path
Loot Configuration → Scrap Multipler - Allow duplicate items
- On / off
Allows the same item to be rolled more than once in a container; bonus-item and loot-group settings can override this.
JSON path
Loot Configuration → Allow duplicate items - Log attachment auto-balancing
- On / off
Logs automatic item-attachment probability balancing operations.
JSON path
Loot Configuration → Enable logging for item attachments auto balancing operations - Allow bonus-item duplicates
- On / off
Allows duplicates among bonus items even when ordinary loot duplicates are disabled.
JSON path
Loot Configuration → Always allow duplicate items from bonus items list (if set, will override 'Allow duplicate items option') - Enable blueprint conversion
- On / off
Converts item rolls into blueprints when the loot table allows blueprints.
JSON path
Loot Configuration → Enable Blueprint Conversion - Allow duplicate blueprints
- On / off
Allows multiple blueprints for the same target item in one container roll.
JSON path
Loot Configuration → Allow Duplicate Blueprints - Enable loot-pool locking
- On / off
Applies loot-pool locking only to containers that also enable that option.
JSON path
Loot Configuration → Enable Loot Pool Locking System - New tables use vanilla Rust RNG
- On / off
Uses vanilla Rust random loot rolls as the default for newly created loot tables.
JSON path
Loot Configuration → New loot tables use Vanilla Rust Loot RNG
Loot groups 4
- Create example group on load
- On / off
Adds an example loot group on load when no corresponding group exists.
JSON path
Loot Groups Configuration → Enable creation of example loot group on load? - Auto-balance profile probabilities
- On / off
Automatically balances probabilities in loot-group profiles.
JSON path
Loot Groups Configuration → Enable auto profile probability balancing? - Allow duplicates from loot groups
- On / off
Allows duplicates from loot groups even when ordinary loot duplicates are disabled.
JSON path
Loot Groups Configuration → Always allow duplicate items from loot groups (if true overrides 'Allow duplicate items option') - Allowed neighbor probability difference (%)
- Number
Maximum probability gap between neighboring entries when selecting an alternative to a duplicate.
JSON path
Loot Groups Configuration → Allowed probablity difference to select neighbour during duplicate item resolution.
Plugin instructions
Better Loot 4.5.2: configure container loot
The PimpMyRust configurator edits oxide/config/BetterLoot.json and four administrator Data files: Blacklist.json, LootTables.json, LootGroups.json, and GatherRates.json under oxide/data/BetterLoot/. Install the plugin separately. The public overview gives a quick 2× path; this guide explains which file to edit for a container.
Set a global 2× starting point
Open the Better Loot configurator, open Examples, and select 2× loot and added scrap. It sets Loot Multiplier and the plugin's Scrap Multipler field to 2 in BetterLoot.json. Export that file and apply it to a test server running 4.5.2. This example does not create a prefab entry or modify LootTables.json.
In the Vanilla overlay, multiplied non-scrap items remain subject to their stack limit. Vanilla scrap already in a container is unchanged; the multiplier affects scrap added by a loot table when its configured amount is positive. Reload and inspect an enabled, watched container before claiming a live 2× result.
Change one container's table
Import the server's current oxide/data/BetterLoot/LootTables.json into the configurator. Locate the actual LootContainer.PrefabName entry and edit its guaranteed, ungrouped or item-list records. Keep other entries, then export the native Data file. LootGroups.json defines reusable groups; Blacklist.json is a separate exclusion catalogue. Avoid inventing prefab paths or item shortnames: use values present on the server and test a spawned container.
Gather settings limitation
In Better Loot 4.5.2, the plugin can ignore edited amounts in GatherRates.json and keep its defaults. This occurred on the test server: a successful export or reload therefore does not confirm an effect on gathering. Container loot editing in LootTables.json is separate.
The config also has a named list of gather plugins for its stand-down behavior. An unlisted gather plugin is not automatically detected, so test coexistence deliberately.
Source and scope
Checked on 2026-10-17 against Better Loot 4.5.2 source, the uMod listing, and a live plugin test. Check a container in game to confirm the loot result.
Install the files
With a connected server, click Apply in the configurator. The result shows whether the files were sent and the plugin reloaded. Without RCON, reload the plugin from your server panel after sending.
Without a connected server: Keep a copy of the current files. Place each export in the folder shown before export, or follow the paths in the ZIP. Do not put data or translation files in the config folder.
Follow the plugin instructions above for dependencies and reloading. Exporting does not connect the site to your server.