LootBox

Open mysterious boxes and receive fully configurable rewards, with adjustable chances, amounts, and item quality.
Perfect for servers looking to create progression systems, treasure events, or custom rewards in Valheim.

Features

• Fully Configurable
  Define custom drop tables directly in the configuration file, supporting individual chances, quantity ranges, and item quality.

• Independent Chances System
  Each item has its own independent drop chance.

• Server-Synced
  All configurations are synchronized via ServerSync, ensuring consistent behavior across all players.

• Modular Integration
  The mod does not automatically drop from creatures.
  It is designed to work together with other loot systems such as Drop That!

Configuration

• Automatic creation of folder and template file
  On first initialization, the mod automatically creates the LootBox folder inside BepInEx/config, along with a template configuration file to serve as a starting point. (This is only generated on server and single-player environments; it is not generated on clients.)

• Definitions via CFG files
  Lootboxes are configured through external .cfg files inside the BepInEx/config/LootBox folder, keeping the setup cleaner and easier to maintain.

• File naming
  Configuration files use this pattern:
  radamanto.LootBox.<anything>.cfg

• Multiple files supported
  You can split your lootboxes across multiple different files, and each file can contain multiple lootbox definitions, as long as they are placed inside the LootBox folder and follow the expected naming pattern.

• One section per lootbox prefab
  Each lootbox must be declared using the prefab name as the section header. Do not configure the same lootbox twice. Example:
  [rd_gold_lootbox_01]

• Reward line format
  Each line inside the section represents one possible reward, using this format:
  Item=Chance,Amount,Quality

• Fixed amount or range
  The amount field supports both fixed values and ranges:
  5 = fixed amount
  50-100 = random amount between 50 and 100

• Examples of valid configurations

  [rd_gold_lootbox_01]
  Coins=100,50-100,1
  Ruby=50,5,1
  SwordSilver=50,1,2
  
  [rd_gold_lootbox_02]
  Iron=100,25-50,1
  SwordBlackmetal=35,1,3
  ShieldBlackmetal=20,1,2
  
  [rd_gold_lootbox_03]
  Resin=100,10-30,1
  FreezeGland=40,3-8,1
  BowHuntsman=25,1,2
  
  

• Example explanation
  Coins=100,50-100,1 → 100% chance, amount between 50 and 100, quality 1
  Ruby=50,5,1 → 50% chance, fixed amount 5, quality 1
  SwordSilver=50,1,2 → 50% chance, amount 1, quality 2

• Important
  The section name must match the lootbox prefab exactly.
  The item name must also match the item's internal in-game name exactly.

Translations

• YML translation file included
  A .yml translation file is included with the plugin.

• Custom lootbox names per language
  Through this file, the names of the lootboxes can be changed or translated to the desired language.

• Simple language customization
  You can define custom display names for each lootbox, making it easier to adapt the mod to your server, modpack, or community language.

• Intended for display names
  This translation file is intended to control how lootbox names are shown to players in-game.

Administration Command

• Configuration reload
  The lootbox.reload command forces a reload of the .cfg files in BepInEx/config/LootBox.

• Runtime reapplication
  Valid definitions are reloaded and reapplied without restarting the game or server.

• Restricted usage
  This command is restricted to administrators.

Global Opening Effects

• Configurable opening effects
  The mod allows switching between different global visual and sound effects for lootbox opening.

• Global behavior
  The selected effects are applied globally to all lootboxes.

• Visual and sound selection
  You can choose which visual effect and which sound effect will be used during box opening through the plugin configuration.

How to Use

To open a Loot Box, simply hold SHIFT and right-click the item in your inventory.
When you do this, the box will be consumed, and its rewards will be placed into your inventory.
If any reward cannot fit in the inventory, the excess will be dropped on the ground.

Installation (manual)

• Place LootBox.dll inside your BepInEx\plugins\ folder.