RUST Magic Loot v1.0.5

Simple loot system without large loot tables and everything else commonly associated with loot plugins.

Usage​

General Multipliers​

All multipliers are set to 1 by default.

There are 2 types of General Multipliers you can set if you want to modify all item yields at once.

1. 'General Item List Multiplier' - This option multiplies all Items listed in the 'Manual Item Multipliers' list below. You can freely add/remove items from this list.
2. 'Non Item List Multiplier' - This option multiplies all items that are NOT listed in the Manual Item Multipliers' list below.

In other words if you want to multiply your whole server by lets say 3, you would fill in '3' on both options mentioned above.

Manual Multipliers​

In this section 'Manual Item Multipliers' you can list all items you want to either NOT have multiplied at all or have a custom multiplication factor. (NOT would mean setting the multiplier to 0)

Keep in mind though, all multipliers set will in the end be multiplied with each other.For example if you have set the General Multiplier to 2, but also set the Manual Scrap Multiplier to 2, the final multiplier for the item of Scrap will result in x4.

Container Multipliers​

In the 'Containers Data' section you can manually adjust each containers additional loot multiplier. This is unique to the container.

Extra Loot​

Extra Items can be added to containers by having 'Enabled' set to true under the 'Extra Loot' section.Furthermore you need to also specify how many items should at least be added 'Extra Items Min' and how many items should at most be added 'Extra Items Max'. A random number inclusive in the range will be selected.

1. 'Prevent Duplicates' - if enabled, tries to remove all duplicate extra items and replaces them with new ones.
2. 'Prevent Duplicates Retries' - defines the amount of retries a single duplicate item can have (to be changed to another) before it gets skipped and remains a duplicate.

Loot Containers​

1. 'Enabled' - if set to false, the plugin will ignore this container type.

Extra items will be added to the specific container, independant of if the global 'Extra Loot' is enabled.In case it is enabled however, it will add both specified 'Extra Items Min' & 'Extra Items Max' together.

1. 'Utilize Vanilla Loot Tables on Default Loot' - if enabled, the containers will be populated with default rust loot spawn tables.
2. 'Utilize Vanilla Loot Tables on Extra Loot' - if enabled, the containers EXTRA loot will consist of the rust default loot spawn tables.

If any of the above mentioned options are set to false, the plugin will then utilize its own loot tables.For this there are a few different options to customize the loot.

1. 'Utilize Random Rarity' - if enabled, a custom rarity will be randomly used of an item ALREADY in the container (this is the original way of the plugin prior version 1.0.0)
2. 'Rarity To Use' - in here you can specify rarities a container can choose from. If multiple are provided, it will randomly choose one.

Rarities​

Rarities are Rust based values in which each Item is grouped in. They consist of None, Common, Uncommon, Rare and Very Rare.

Other General Settings​

1. 'Limit Multipliers to Stacksizes' - if enabled, limits the item to its Rust default Stacksize.
2. 'Multiply Blueprints' - if enabled, allows for blueprints to be given out multiple times (depending on the current multipliers)
3. 'Random Workshop Skins' - if enabled, adds random workshop skins to the items

Modifying Items To Spawn​

Working with existing Loot Tables​

You can go into 'oxide/data/MagicLoot.json' to modify all items that can possibly be spawned. Here you will find a dictionary of all items containing as the key the 'Item Shortname' and as the value the 'Stacksize' it can be spawned in. If you change the 'Stacksize' to 0, the item will not be spawned.

Blacklisted Items​

You can manally add item shortnames to the Blacklisted Items to block these from spawning.

Configuration​

The settings and options can be configured in the MagicLoot file under the config directory. The use of an editor and validator is recommended to avoid formatting issues and syntax errors.