Crear Cofres del Tesoro
Treasure Chests are a feature allows admins to make chests that can either drop loot or spawn a mimic (hostile) boss.
Values
isEnabled
Sets if a treasure chest is enabled.
| Key | Values | Default |
|---|---|---|
isEnabled | Boolean | false |
Los cofres desactivados se omiten por completo: no se colocan en el mundo y no se ofrecen (ni se aceptan) en /em place treasureChest. Establece esto en true antes de intentar colocar el cofre.
Example
isEnabled: true
chestType
Sets the type of chest material.
| Key | Values | Default |
|---|---|---|
chestType | Material | CHEST |
Example
chestType: CHEST
This needs to be a valid chest material such as CHEST or BARREL.
facing
Sets the facing direction of the chest.
| Key | Values | Default |
|---|---|---|
facing | Special [1] | NORTH |
Example
facing: NORTH
This sets the direction the chest faces. Valid values are NORTH, SOUTH, EAST, or WEST.
Special [1]
Expand Table
| Facing |
|---|
NORTH |
SOUTH |
WEST |
EAST |
dropStyle
Sets if the chest is meant to be dropped for one player or multiple players.
Los cofres SINGLE los consume el primer jugador que los abre: el bloque se reemplaza por aire, se escribe un restockTime y el bloque reaparece cuando han pasado restockTimer minutos. No hay seguimiento por jugador, así que quien llegue primero se lleva el cofre entero.
Los cofres GROUP nunca se eliminan del mundo. En su lugar, cada jugador que abre uno queda con su propio tiempo de reutilización, de modo que todos los jugadores pueden saquear el cofre una vez por periodo de reabastecimiento. Esos tiempos de reutilización se guardan en el campo restockTimers, que el plugin escribe en el archivo por ti.
| Key | Values | Default |
|---|---|---|
dropStyle | SINGLE / GROUP | SINGLE |
Example
dropStyle: SINGLE
lootList
Lists the loot that the treasure chest should drop when opened.
| Key | Values | Default |
|---|---|---|
lootList | EM Loot Table | none |
Example
lootList:
- filename=elite_scrap_tiny.yml:chance=0.90
- filename=magmaguys_toothpick.yml:chance=1.0
Si ninguna entrada de la lista supera su tirada de chance, se envía al jugador el mensaje treasureChestNoDropMessage de config.yml, de modo que el cofre no se quede simplemente en nada de forma silenciosa. El tiempo de reutilización se consume igualmente.
mimicChance
Sets the chance of spawning a hostile boss instead of dropping loot.
| Key | Values | Default |
|---|---|---|
mimicChance | Double | 0 |
La tirada ocurre en cada interacción, antes de generar cualquier botín. Cuando la tirada tiene éxito, el mímico aparece en lugar de soltar el botín: el cofre nunca hace ambas cosas. El tiempo de reutilización del cofre se consume en cualquier caso.
Example
mimicChance: 0.5
mimicCustomBossesList
Specifies the list of hostile bosses available for spawning. A single boss will be randomly selected from this list for spawning.
The list also supports a weight system that you can implement to ensure some bosses are picked more often that the others.
| Key | Values | Default |
|---|---|---|
mimicCustomBossesList | String List | none |
Example
mimicCustomBossesList:
- my_cool_mimic_boss.yml
- weak_mimic_boss.yml
If you wish to assign weights to the bosses, the list should be formatted as follows:
mimicCustomBossesList:
- my_cool_mimic_boss.yml:60
- weak_mimic_boss.yml:40
In this configuration, my_cool_mimic_boss.yml is more likely to be chosen for spawning than weak_mimic_boss.yml.
Tanto una entrada sin sufijo de peso como una entrada cuyo peso no pueda leerse como número recurren a un peso de 1.
¿A qué nivel aparece el mímico?
Eso depende del archivo del jefe al que apuntes, no del cofre:
level del jefe mímico | Nivel al que aparece |
|---|---|
| Un número fijo | chestTier × 10, más un valor aleatorio de 0-10 |
dynamic (-1) dentro de una mazmorra dinámica | El nivel seleccionado de la mazmorra, ±1 |
dynamic (-1) en cualquier otro sitio | El nivel de aparición natural del jugador que abre, ±1 |
Si no se encuentra el archivo del jefe indicado en la lista, no aparece ningún mímico y se registra una advertencia: el jugador no obtiene nada, ni siquiera el botín.
restockTimer
Sets the time, in minutes, before the chest refills with loot.
| Key | Values | Default |
|---|---|---|
restockTimer | Integer | 0 |
En los cofres SINGLE es el tiempo que el bloque permanece ausente antes de reponerse. En los cofres GROUP es el tiempo que cada jugador individual debe esperar antes de poder volver a saquear el cofre.
Dejar esto en el valor por defecto de 0 significa que en la práctica no hay ningún tiempo de reutilización, por lo que el cofre puede farmearse repetidamente. Establece un valor real en cualquier cofre que suelte algo que merezca la pena.
Example
restockTimer: 30
effects
Nota: Actualmente este ajuste no hace nada. La clave se sigue leyendo del archivo de configuración sin dar error, y se sigue escribiendo junto con el resto de los valores por defecto, pero nada en el plugin consume el valor procesado, así que los cofres del tesoro nunca generan partículas.
Si quieres partículas alrededor de un cofre, por ahora tendrás que generarlas desde otra fuente.
| Key | Values | Default |
|---|---|---|
effects | String List | none |
locations
Sets the locations where the treasure chest will spawn.
Las ubicaciones pueden añadirse usando /em place treasureChest <treasurechestfilename.yml> mientras estás en la ubicación deseada. Este comando añade automáticamente tu posición actual a la lista de ubicaciones del cofre y actualiza el archivo de configuración.
| Key | Values | Default |
|---|---|---|
locations | String List | none |
Cada entrada usa el formato worldName,x,y,z,yaw,pitch. También se acepta la forma abreviada worldName,x,y,z, en cuyo caso yaw y pitch se tratan como 0.
Las entradas pueden llevar un sufijo :unixTimestamp, que es como EliteMobs guarda el momento de reabastecimiento de esa colocación concreta del cofre. El plugin escribe este sufijo por sí mismo cuando se saquea un cofre SINGLE: no necesitas añadirlo, y puedes borrarlo para que el cofre esté disponible de inmediato.
Un mismo archivo puede contener tantas ubicaciones como quieras, y cada una se convierte en su propio cofre con su propio temporizador de reabastecimiento.
Example
locations:
- my_world,10,50,10,0,0
- my_nether_world,12,58,12,0,0
- my_world,80,64,-30,0,0:1707394380
chestTier
Establece el nivel (tier) del cofre, que es la base para el nivel del botín que suelta. El nivel base es chestTier * 10.
| Key | Values | Default |
|---|---|---|
chestTier | Integer | 0 |
Cuánto importa realmente chestTier depende de dónde esté el cofre y de qué tipo de objeto haya en la tabla de botín:
| Situación | Nivel al que sale el botín |
|---|---|
| Cofre abierto fuera de cualquier instancia | Los objetos élite scalable siguen el nivel del jugador que abre, ±1. Todo lo demás usa chestTier * 10. |
| Cofre dentro de una mazmorra dinámica | Se usa el nivel seleccionado de la mazmorra para todo, y los objetos élite scalable reciben ±1. chestTier se ignora. |
| Cofre dentro de cualquier otra instancia | chestTier * 10 para todo. |
Así que en un mundo de supervivencia normal chestTier fija sobre todo el nivel de tus objetos fixed y limited, mientras que los objetos scalable siguen al jugador que abrió el cofre. Ten en cuenta que el mímico usa una fórmula distinta: consulta mimicCustomBossesList.
Dejar esto en el valor por defecto de 0 da un nivel base de botín de 0.
Example
chestTier: 3
instanced
Sets if the chest should be instanced (for use in instanced dungeons). All restock timers are disabled when chests are placed in dungeons.
DO NOT SET THIS VALUE MANUALLY.
| Key | Values | Default |
|---|---|---|
instanced | Boolean | false |
Example
instanced: true
restockTime
After a chest has been looted, the plugin will write this key to track restock time.
Esto solo lo usa el formato antiguo de cofre único, en el que la posición del cofre vive en una clave location en lugar de la lista locations. En cuanto un archivo tiene alguna entrada en locations, el momento de reabastecimiento se escribe como sufijo :unixTimestamp en la entrada correspondiente de locations y esta clave se deja intacta.
DO NOT SET THIS VALUE MANUALLY.
| Key | Values | Default |
|---|---|---|
restockTime | Unix Timestamp | none |
Example
restockTime: 1707394380
restockTimers
Guarda los datos de tiempo de reutilización por jugador de los cofres en modo GROUP. El plugin lo escribe automáticamente y va eliminando las entradas caducadas a medida que las lee.
Los cofres instanciados no usan esta lista: dentro de una instancia, el tiempo de reutilización por jugador se mantiene en memoria solo mientras dure esa instancia.
DO NOT SET THIS VALUE MANUALLY.
| Key | Values | Default |
|---|---|---|
restockTimers | String List | none |
Example
restockTimers:
- '1234567890-abcd-efgh-ijkl-123456789012:1707394380'
- '0987654321-zyxw-vutr-sqpo-098765432109:1707395000'
Each entry contains a player UUID and Unix timestamp separated by a colon.
Treasure Chest Config Example
isEnabled: true
chestType: CHEST
facing: NORTH
chestTier: 3
dropStyle: GROUP
lootList:
- filename=elite_scrap_tiny.yml:chance=0.90
- filename=magmaguys_toothpick.yml:chance=0.95
mimicChance: 0.50
mimicCustomBossesList:
- balrog.yml
- killer_rabbit_of_caerbannog.yml
restockTimer: 1
locations:
- world,0.0,-60.0,-14.0,0.0,0.0
Fíjate en que todas las entradas de botín anteriores usan el prefijo filename=. Escribir magmaguys_toothpick.yml:chance=0.95 se interpretaría como el formato antiguo filename.yml:chance, y chance=0.95 no es un número, por lo que la entrada registraría una advertencia de análisis en cada arranque.
