Custom Droptables

A V-Rising server plugin allowing more control over loot spawns in containers. Add items to or entirely replace existing droptables, applicable for chests, drawers and other containers that spawn in the world with randomized loot.

Features

• Extensive modification of droptables via configuration file.
• Adjust spawn chance of individual items from below 1% up to 100%
• Add multiple items to any droptable.
• Replace the droptable entirely, leaving you in control of all items spawned.

Limitations

• Most droptables are not unique, meaning multiple containers in the world share the same droptable. However there are some exceptions, check the Google Sheets link below for an overview.
• You can only set fixed quantities for individual items (for now). You can theoretically bypass this by adding multiple items to the same droptable with different spawn chances.
• If you add too many items or the containers doesnt fit, the rest will be dropped on the floor next to it. Due to this you should keep in mind order of item-objects in the config, first one will spawn in the next available slot and so on until the next one cant fit.
• The plugin only overrides the specific drop tables once the container is spawned in, meaning if you put the plugin on an existing world you have to wait until the container a) respawns b) is looted or deleted.

Planned updates

• Prevent dropping excess items on floor.
• Custom droptables that can be assigned to any container.
• Cleanup commands / general in-game administration of configuration.

Configuration

The configuration file is automatically created in \%SERVER_FOLDER%\BepInEx\config\CustomDropTables\ as Configuration.json and will contain some boilerplate to get you going.

{
  "1049541583": {             <       Drop table GUID value.
    "replace_all": false,     <       False to add on items to existing droptable, true to replace all items.
    "add_items": {            <       List of items to add
      "-257494203": {         <       Item group, specify the Prefab GUID you want to spawn as the "Key" value of the group.
        "quantity": 100,      <       Define amount of items to spawn
        "spawnchance": 1.0    <       Define chance of spawning. 1.0 is 100%, 0.5 is 50%, 0.25 is 25% and so on.
      },                               
      "-1913156733": {        <       Easily repeat the pattern for more items.
        "quantity": 15,
        "spawnchance": 0.5
      },
      "-850142339": {
        "quantity": 1,
        "spawnchance": 0.25
      }
    }
  },
  "-600923884": {             <       Add more drop tables with different items.
    "replace_all": true,
    "add_items": {
      "-257494203": {
        "quantity": 10,
        "spawnchance": 0.44
      },
      "-1913156733": {
        "quantity": 100,
        "spawnchance": 0.01
      },
      "-850142339": {
        "quantity": 5,
        "spawnchance": 0.05
      }
    }
  }
}

Information about Prefab & Droptable GUID values.

More information about GUID values can be obtained on the V-Rising Mod Wiki. You can also check my google-sheets document for more information about the droptables.

Disclaimer

This plugin is not tested in a live-enviroment with lots of players so beware bugs or other issues that could arise, to report them you can raise an issue here on github or join the V-Rising modding community discord to speak with me directly.

Dependencies

• Bloodstone by Deca.

Credits

• Mitch (zfolmt) for general questions / help.

• Odjit for initialization patch / core structure.

• V Rising Modding Community

License

This project is licensed under the GPL-3.0 license.