Drop Boxes

A customizable loot box system for Unturned. Players can earn boxes from various in-game activities and open them to receive random rewards.

Works With

• Uconomy
• Uconomy XP
• Uconomy To Advanced Economy

Features

• Customizable loot boxes with different rewards
• Boxes drop from various game events (killing zombies, finding resources, etc.)
• MySQL database storage for cross-server compatibility
• Simple command system for managing boxes

Commands

• /boxes - View all boxes you currently own
• /unbox <boxID> - Open a box to receive a random reward
• /givebox <player> <boxID> - Give a box to another player (admin command)

Configuration

Basic Settings

• MessageColor: Color of plugin messages in chat
• ConnectionString: MySQL database connection string

Box Configuration

Each box has the following properties:

• BoxId: Unique identifier for the box (used in commands)
• Name: Display name of the box
• Color: Text color for the box name in chat (hex format)
• Drop chance settings (1-1000):
  • PlayerKillChance: Chance to drop when killing another player
  • ZombieKillChance: Chance to drop when killing a normal zombie
  • MegaZombieKillChance: Chance to drop when killing a mega zombie
  • FoundPlantsChance: Chance to drop when harvesting plants
  • FoundResourcesChance: Chance to drop when gathering resources
  • FoundFishesChance: Chance to drop when catching fish

Rewards

Each box can contain multiple possible rewards:

• ItemId: Unturned item ID number
• Chance: Relative probability of getting this item (higher = more likely)

Example Configuration

<?xml version="1.0" encoding="utf-8"?>
<DropBoxesConfiguration xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <MessageColor>yellow</MessageColor>
  <ConnectionString>Server=127.0.0.1;Database=unturned;Uid=root;Password=YourPassword;</ConnectionString>
  <DropBoxes>
    <DropBox BoxId="epic" Name="Epic Chest" Color="#FFC0CB">
      <PlayerKillChance>50</PlayerKillChance>
      <ZombieKillChance>150</ZombieKillChance>
      <MegaZombieKillChance>1000</MegaZombieKillChance>
      <FoundPlantsChance>200</FoundPlantsChance>
      <FoundResourcesChance>500</FoundResourcesChance>
      <FoundFishesChance>50</FoundFishesChance>
      <Rewards>
        <DropBoxReward ItemId="363" Chance="30" />
        <DropBoxReward ItemId="254" Chance="50" />
        <DropBoxReward ItemId="17" Chance="80" />
        <DropBoxReward ItemId="519" Chance="20" />
      </Rewards>
    </DropBox>
  </DropBoxes>
</DropBoxesConfiguration>

How It Works

1. Players have a chance to earn boxes when performing various actions (killing zombies, finding resources, etc.)
2. When a player earns a box, they receive a notification and the box is added to their inventory
3. Players can view their boxes with the /boxes command
4. Opening a box with /unbox <boxID> gives the player a random item from the box's reward list

Note: For custom text formatting in translations, use {{ and }} instead of < and >. For example, use {{color=red}} instead of <color=red>.