Custom Lootbox
Create custom lootboxes from any items in your server. Configure probabilities, item counts, and distribute keys to your players.
🎁 What does it do?
Custom Lootbox lets server operators place lootbox blocks anywhere in the world using a simple command. Each lootbox holds a configurable pool of items with individual weights and counts. Players use keys to open them and receive a random reward with a firework celebration.
✨ Features
- Place lootboxes anywhere with
/lootbox create <x> <y> <z>
- Visual editor with 3 tabs: Items, Configuration, and Probabilities
- Add any item from your inventory directly into the lootbox pool
- Set individual weight (probability) and count per item
- Real-time percentage display for each item
- Generate and distribute keys to players — one key per open
- Keys are item-stack friendly: duplicate them in creative to distribute
- Each lootbox has a unique UUID — keys only work on their matching lootbox
- Lootboxes are indestructible in survival — only creative players can break them
- Firework effect on every opening
- Compatible with items from any mod (Create, Cobblemon, Apotheosis, etc.)
- Supports custom item names and NBT data
🔧 Requirements
| |
|
| Minecraft |
1.21.1 |
| Mod Loader |
NeoForge 21.1.x |
| Side |
Both (required on server and client) |
No other mods required.
🚀 How to use
1. Place a lootbox
Requires operator permission (level 2):
/lootbox create <x> <y> <z>
2. Configure it
In creative mode, Shift + Right Click the lootbox to open the editor.
Items tab — Click any item in your inventory (left side) to add it to the lootbox pool (right side). Click an item in the pool to remove it.
Configuration tab — Set the display name of the lootbox.
Probabilities tab — Click any row to edit its weight and count. Higher weight = higher chance. The % column updates in real time.
3. Get keys
Click "Get Key" in the editor to receive a key for that lootbox. Duplicate it in creative to distribute to players.
4. Opening a lootbox
Players right click the lootbox while holding the matching key. The key is consumed, a random item is awarded, and a firework launches from the block.
⚙️ Probability system
All items default to weight 1.0 (equal chance). You can set any positive decimal value per item.
Example:
| Item |
Weight |
Chance |
| Diamond |
0.5 |
10% |
| Gold Ingot |
2.0 |
40% |
| Iron Ingot |
2.5 |
50% |
The lootbox can be opened infinitely — probabilities never change unless you edit them.
🔒 Permissions
| Action |
Requirement |
Place lootbox (/lootbox create) |
OP level 2 |
| Edit lootbox (Shift + Right Click) |
Creative mode |
| Break lootbox |
Creative mode only |
| Open lootbox with key |
Any player |
Made for NeoForge 1.21.1
Custom Lootbox
Crea lootboxes personalizadas con cualquier ítem en tu servidor. Configura probabilidades, cantidades y distribuye llaves a tus jugadores.
🎁 ¿Qué hace?
Custom Lootbox permite a los operadores del servidor colocar bloques de lootbox en cualquier parte del mundo con un comando simple. Cada lootbox contiene un grupo configurable de ítems con pesos y cantidades individuales. Los jugadores usan llaves para abrirlas y reciben una recompensa aleatoria con fuegos artificiales.
✨ Características
- Coloca lootboxes con
/lootbox create <x> <y> <z>
- Editor visual con 3 pestañas: Ítems, Configuración y Probabilidades
- Agrega cualquier ítem de tu inventario directamente al grupo de la lootbox
- Configura el peso (probabilidad) y la cantidad por ítem individualmente
- Muestra el porcentaje de probabilidad en tiempo real
- Genera y distribuye llaves a los jugadores — una llave por apertura
- Las llaves son stackeables: duplícalas en creativo para distribuirlas
- Cada lootbox tiene un UUID único — las llaves solo funcionan en su lootbox correspondiente
- Las lootboxes son indestructibles en supervivencia — solo los jugadores en creativo pueden romperlas
- Efecto de fuegos artificiales en cada apertura
- Compatible con ítems de cualquier mod (Create, Cobblemon, Apotheosis, etc.)
- Soporta nombres personalizados y datos NBT
🔧 Requisitos
| |
|
| Minecraft |
1.21.1 |
| Mod Loader |
NeoForge 21.1.x |
| Lado |
Ambos (requerido en servidor y cliente) |
No se requieren otros mods.
🚀 Cómo usarlo
1. Colocar una lootbox
Requiere permiso de operador (nivel 2):
/lootbox create <x> <y> <z>
2. Configurarla
En modo creativo, haz Shift + Click derecho en la lootbox para abrir el editor.
Pestaña Ítems — Haz click en cualquier ítem de tu inventario (lado izquierdo) para agregarlo al grupo de la lootbox (lado derecho). Click en un ítem del grupo para eliminarlo.
Pestaña Configuración — Cambia el nombre visible de la lootbox.
Pestaña Probabilidades — Haz click en cualquier fila para editar su peso y cantidad. Mayor peso = mayor probabilidad. La columna % se actualiza en tiempo real.
3. Obtener llaves
Haz click en "Obtener Llave" en el editor para recibir una llave de esa lootbox. Duplícala en creativo para distribuirla a los jugadores.
4. Abrir una lootbox
Los jugadores hacen click derecho en la lootbox mientras sostienen la llave correspondiente. La llave se consume, se otorga un ítem aleatorio y se lanza un fuego artificial desde el bloque.
⚙️ Sistema de probabilidades
Todos los ítems tienen peso 1.0 por defecto (misma probabilidad). Puedes asignar cualquier valor decimal positivo por ítem.
Ejemplo:
| Ítem |
Peso |
Probabilidad |
| Diamante |
0.5 |
10% |
| Lingote de Oro |
2.0 |
40% |
| Lingote de Hierro |
2.5 |
50% |
La lootbox se puede abrir infinitas veces — las probabilidades no cambian a menos que las edites.
🔒 Permisos
| Acción |
Requisito |
Colocar lootbox (/lootbox create) |
OP nivel 2 |
| Editar lootbox (Shift + Click derecho) |
Modo creativo |
| Romper lootbox |
Solo modo creativo |
| Abrir lootbox con llave |
Cualquier jugador |
Hecho para NeoForge 1.21.1
