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

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:

The lootbox can be opened infinitely — probabilities never change unless you edit them.

🔒 Permissions

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

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:

La lootbox se puede abrir infinitas veces — las probabilidades no cambian a menos que las edites.

🔒 Permisos

Hecho para NeoForge 1.21.1