VortixUnboxing
Classic loot box implementation into Unturned

VortixUnboxing is an advanced plugin that introduces randomized loot boxes with a graphical UI, inspired by the classic ParadoxUnboxing mod. It features a full virtual inventory system powered by either MySQL or LiteDB, allowing you to configure custom boxes, keys, costs, and dynamic drop chances.
Features
- Virtual Inventories: Players have virtual "balances" of Crates and Keys saved in a database.
- MySQL & LiteDB Support: Use MySQL for cross-server syncing, or LiteDB for an easy, zero-setup local database.
- Physical to Virtual Conversion: Configure in-game items to automatically convert into virtual crates and keys as soon as a player picks them up off the ground.
- Full UI Integration: Fully compatible with Unturned UI Effects (e.g., Effect ID 28280). Intercepts precise UI buttons for the Store, Inventory, and Unboxing tabs.
- Advanced Rewards: Crates can reward items, money, execute server commands, give permission groups, or even reward more crates/keys!
- Economy Integrations: Supports both standard Experience (XP) and Uconomy for purchasing crates and keys.
Commands & Permissions
Player Commands
| Command | Permission | Description |
|---|---|---|
/unbox | vortix.unbox | Opens the main Unboxing UI on the player's screen. |
Admin Commands
| Command | Permission | Description |
|---|---|---|
/crate add <SteamID> <CrateID> [Amount] | vortix.crate | Gives a player a specific amount of virtual crates in their database inventory. |
/crate remove <SteamID> <CrateID> [Amount] | vortix.crate | Removes virtual crates from a player's database inventory. |
/key add <SteamID> <KeyID> [Amount] | vortix.key | Gives a player a specific amount of virtual keys. |
/key remove <SteamID> <KeyID> [Amount] | vortix.key | Removes virtual keys from a player's inventory. |
Configuration (VortixUnboxing.configuration.xml)
Database Setup
UseLiteDB: (Default:true) Uses a local database file (UnboxingData.db). Perfect if you don't have a MySQL server.ConnectionString: If you setUseLiteDBtofalse, the plugin will use this MySQL connection string to sync data (e.g.,server=localhost;user=root;database=unturned;port=3306;password=root).
In-Game Item Pickups
You can link physical in-game items to your virtual crates and keys using the ItemCrates and ItemKeys lists.
For example, if you add an ItemCrate mapping where ItemID is 2 and CrateID is 1:
Whenever a player picks up item #2 off the floor, the physical item is instantly destroyed, they receive Crate #1 in their /unbox inventory, and they get a chat message!
Crates & Rewards
Cost: The amount of XP/Uconomy required to buy the crate.KeyID: If the crate requires a key to open, specify the Key's ID here. (Set to0if no key is needed).Chance: The drop chance weight. If Item A has a chance of 80 and Item B has a chance of 20, Item A has an 80% chance of dropping.RewardCommands: A list of commands the server runs from console if they win this item (e.g.,pay {playerID} 500).
Installation
- Ensure RocketMod is installed on your Unturned server.
- Place
VortixUnboxing.dllinto yourServers/YourServerName/Rocket/Plugins/directory. - Restart your server to generate the configuration file and database.
- Edit the configuration file to add your desired boxes, keys, and item pickups.
- Make sure you have the UI
.masterbundle(Effect 28280) installed in your server's workshop/mods directory so players can see the UI.
Vortix Casino Pack
All of your casino minigames in one sleek bundle brought to you by VortixStudios @ 30% discount!
Bundle Price:
VortixUnboxing
Required Workshop
Latest Changes
v1.0.3