This plugin is a loot system for your server. You can modify content of all the containers and do whatever you want!
WARNING! This plugin restores all the containers' loot after it's unload.
Container is a configuration entry that describes a group that can contain different containers that match specified shortnames, regex and etc.
Entity Shortnames are entries that let you select certain containers or exclude in case you do not need some. Use "global" to include all containers.
Process Corpses is whether this container should process corpses at all. Notice that it always ignores players' corpses.
Process Loot Containers is whther this container should process loot containers (not all containers tho).
Monument Prefabs is a list of monument prefabs. Notice that some of them cannot be detected because of in-game limitations.
Shuffle Items is whether to shuffle items. Should be enabled in case you want to randomize items order, else there may be less specific items than stated in configuration.
Allow Duplicate Items is whether to allow duplicate items when any added or no.
Allow Duplicate Items lets same items with different skips be added.
Remove Container is whether to remove container.
Item Container Indexes are container indexes used mostly for corpses. Your main inventory is 0, clothes container is 1 and belt is 2.
Replace Items is a mode toggle for replacing items completely in a container.
Add Items is a mode toggle for simply adding items to existing ones in a container.
Modify Items is a mode toggle for modifying existing loot.
Modify Ignores Blueprint State is whether modify should ignore blueprint states (no need for duplicate items with Is Blueprint true and false).
Fill With Default Items is whether the container should be filled with default items. Use with Replace to refill whole container and with Add to refill only empty slots.
Online Condition is an option to limit this container usage to a specific online, for example you can add a specific item to barrels when online is low and only to elite crates when you have high online.
Maximal Failures To Add An Item is a number of maximal failures. Increase it if something does not work, usually numbers up to a few hundreds are fine.
Capacity is a setting for capacity in a container. When using Add mode, it adds slots and with Replace it replaces number of free slots completely.
Item is an entry in a container that describes a certain group of items that match specified regex and etc..
Item Shortnames are entries that allow you to specify what items you want to change or add or exclude by providing their shortname, rarity and category. Use "global" to include all items, rarities or categories.
Item Name is a custom item name.
Is Blueprint is whether this item is a blueprint or not.
Allow Stacking is whether to allow stacking or not when adding an item.
Ignore Max Stack is whether to ignore max stack on this item or not when modifying or adding an item.
Ignore Max Condition is whether to exceed or not the in-game condition limits when you add or modify an item.
Remove Item lets you simply remove an item in Modify mode.
Replace Item With Default Loot replaces an item you want in Modify mode with a random item from default loot.
Conditions are settings for this item conditions that can be randomized when necessary. You can specify minimal and maximal condition so that it is random, change item's maximal condition and use rates on both. Use -1 to prevent it from being changed.
Skins are item skins.
Amount is an amount of this item that can be random if you provide different minimal and maximal amounts. Use -1 to ignore and not change it.
WARNING! This plugin restores all the containers' loot after it's unload.
Permissions
This plugin uses the permission system. To assign a permission, use oxide.grant <user or group> <name or steam id> <permission>. To remove a permission, use oxide.revoke <user or group> <name or steam id> <permission>.- lootplus.lootsave - Permission for lootsave command.
- lootplus.lootrefill - Permission for lootrefill command.
- lootplus.loadconfig - Permission for lootconfig command.
Commands
This plugin provides both chat and console commands using the same syntax. When using a command in chat, prefix it with a forward slash: `/`.- lootsave - Fill your inventory with items you want to be in the container and use this command. You need to look at the container/etc.
- lootrefill - Refill all loot, without any kind of restarts, etc.
- lootconfig - Load the config without refilling all loot, restarting the plugin, etc. Helpful for enabling debug without spam on plugin load.
Localization
The default messages are in the LootPlus file under the lang/en directory. To add support for another language, create a new language folder (e.g. de for German) if not already created, copy the default language file to the new folder and then customize the messages.English
Configuration
The settings and options can be configured in the LootPlus file under the config directory. The use of an editor and validator is recommended to avoid formatting issues and syntax errors.Default Configuration
How-To
Refill Loot On Plugin Load is whether to refill loot on plugin load. Disable to prevent unnecessary changes and performance improvement but only on a test server. On your real server you should turn it on.Container is a configuration entry that describes a group that can contain different containers that match specified shortnames, regex and etc.
Entity Shortnames are entries that let you select certain containers or exclude in case you do not need some. Use "global" to include all containers.
Process Corpses is whether this container should process corpses at all. Notice that it always ignores players' corpses.
Process Loot Containers is whther this container should process loot containers (not all containers tho).
Monument Prefabs is a list of monument prefabs. Notice that some of them cannot be detected because of in-game limitations.
Shuffle Items is whether to shuffle items. Should be enabled in case you want to randomize items order, else there may be less specific items than stated in configuration.
Allow Duplicate Items is whether to allow duplicate items when any added or no.
Allow Duplicate Items lets same items with different skips be added.
Remove Container is whether to remove container.
Item Container Indexes are container indexes used mostly for corpses. Your main inventory is 0, clothes container is 1 and belt is 2.
Replace Items is a mode toggle for replacing items completely in a container.
Add Items is a mode toggle for simply adding items to existing ones in a container.
Modify Items is a mode toggle for modifying existing loot.
Modify Ignores Blueprint State is whether modify should ignore blueprint states (no need for duplicate items with Is Blueprint true and false).
Fill With Default Items is whether the container should be filled with default items. Use with Replace to refill whole container and with Add to refill only empty slots.
Online Condition is an option to limit this container usage to a specific online, for example you can add a specific item to barrels when online is low and only to elite crates when you have high online.
Maximal Failures To Add An Item is a number of maximal failures. Increase it if something does not work, usually numbers up to a few hundreds are fine.
Capacity is a setting for capacity in a container. When using Add mode, it adds slots and with Replace it replaces number of free slots completely.
Item is an entry in a container that describes a certain group of items that match specified regex and etc..
Item Shortnames are entries that allow you to specify what items you want to change or add or exclude by providing their shortname, rarity and category. Use "global" to include all items, rarities or categories.
Item Name is a custom item name.
Is Blueprint is whether this item is a blueprint or not.
Allow Stacking is whether to allow stacking or not when adding an item.
Ignore Max Stack is whether to ignore max stack on this item or not when modifying or adding an item.
Ignore Max Condition is whether to exceed or not the in-game condition limits when you add or modify an item.
Remove Item lets you simply remove an item in Modify mode.
Replace Item With Default Loot replaces an item you want in Modify mode with a random item from default loot.
Conditions are settings for this item conditions that can be randomized when necessary. You can specify minimal and maximal condition so that it is random, change item's maximal condition and use rates on both. Use -1 to prevent it from being changed.
Skins are item skins.
Amount is an amount of this item that can be random if you provide different minimal and maximal amounts. Use -1 to ignore and not change it.