Configura la caja
Da llaves a los jugadores, ajusta las probabilidades de cada rareza y deja que ganen efectos en vez de comprar un rango.
La caja deja que los jugadores gasten llaves, vean caer los carretes y se queden con el efecto en el que paran. Lo que ganan queda guardado en su propia cuenta, así que sobrevive a cualquier rango.
Antes de empezar#
La caja está activada por defecto (crate.enabled: true). Los jugadores la abren con /hiteffect crate, con el botón Caja del menú de efectos o con un bloque de caja, y todos tienen exyliahiteffect.crate por defecto. Empiezan con 0 llaves, así que da alguna primero.
Pasos#
Da una llave
Ejecuta /hiteffectsadmin keys give <jugador> 5. Es un número guardado en la cuenta del jugador, así que no se puede tirar, duplicar ni perder por un inventario lleno. Una tienda, un plugin de votos o de recompensas puede ejecutar el mismo comando desde la consola.
Abre la caja
Como ese jugador, ejecuta /hiteffect crate, elige cuántas abrir y haz clic en el botón de abrir. Una llave abre una caja.
Pon una caja en el mundo (opcional)
Mira un bloque y ejecuta /hiteffectsadmin crate block add. Al hacerle clic derecho se abre la caja. Un bloque enlazado no se puede romper, explotar ni empujar mientras esté en la lista.
Comprueba que funciona#
Ejecuta /hiteffectsadmin keys check <jugador>: muestra las llaves que tiene. Tras abrir, baja el número de llaves, el carrete para en un efecto y un efecto nuevo aparece como tuyo en /hiteffect. Si el carrete cae en un efecto que el jugador ya tiene, recupera crate.duplicate-refund llaves (por defecto 1).
Ir más allá#
Da llaves como objeto#
Una llave-objeto se puede vender en una tienda, meter en un kit o regalar a un amigo: /hiteffectsadmin item key <jugador> [1-64]. Al hacer clic derecho en un bloque de caja enlazado con una en la mano, se abre al momento, una llave y un carrete, y la llave sale de la mano cuando el carrete empieza a caer. El clic izquierdo nunca gasta una, y una llave no se puede colocar como bloque. El objeto lo fija key-item en config.yml, y su nombre y lore key-item en messages.yml.
Otros comandos de llaves: /hiteffectsadmin keys take <jugador> [cantidad] y /hiteffectsadmin keys set <jugador> <cantidad>. crate.start-keys es cuántas llaves recibe un jugador la primera vez que el plugin lo ve.
Cambia las probabilidades de una rareza#
Cada efecto tiene una rareza, escrita como tier: en el catálogo (Edita el catálogo de efectos). La rareza decide su color, cuántas veces para un carrete en él y qué concede exyliahiteffect.tier.<id>. Los pesos incluidos son common 60, rare 25, epic 12 y legendary 3, bajo tiers en config.yml.
chance es un peso, no un porcentaje: si borras epic, su parte se reparte entre las demás en vez de dejar un hueco. Puedes renombrar una rareza, inventar mythic o borrar legendary. Un efecto con una rareza que ya no existe cae en la primera, y uno sin tier: es común.
Deja que los rangos abran varias a la vez#
crate.max-at-once es cuántas cajas abre un jugador de una vez (por defecto 4, siete como máximo, que es lo que cabe en la pantalla). Para dar más a un rango, concede exyliahiteffect.crate.multi.<n>; vale el más alto que tenga el jugador. Mira Permisos. Varios carretes caen en paralelo, cada uno para crate.stagger-seconds (por defecto 2.0) después del anterior, y cada uno paga al llegar. Cerrar la ventana no cuesta nada: las llaves ya están gastadas y los premios llegan igual.
Abrirla en 3D#
Pon crate.opening: SPATIAL para cambiar los carretes que caen por una caja en el mundo delante del jugador: un carrete frena sobre el premio, se revela y el efecto ganado se prueba en un maniquí. Agacharse salta al final y entrega el premio al instante. Su aspecto es spatial/crate.yml. Un jugador con un cliente anterior a 1.21.4 recibe los carretes de inventario, y uno sin exyliahiteffect.preview ve el premio como icono, sin maniquí. El valor por defecto es INVENTORY.
Elige qué entrega una ganancia#
Pon crate.reward:
| Valor | Qué recibe el jugador |
|---|---|
UNLOCK | El efecto queda desbloqueado en su cuenta y se elige desde /hiteffect. No se puede intercambiar ni perder. El valor por defecto. |
ITEM | Solo la ficha, para atar a un arma, vender o regalar. No se desbloquea nada, así que no hay duplicados y duplicate-refund nunca se aplica. |
BOTH | Desbloqueado en la cuenta y además una ficha. |
ITEM y BOTH necesitan behaviour.mode en weapon o both, mira Modos y fichas.
Concede o quita a mano un efecto ganado#
Un efecto desbloqueado se escribe en la cuenta del jugador, no se concede como permiso, así que si caduca un rango se lleva su nodo de categoría pero nada de lo ganado. Un jugador tiene un efecto si un permiso se lo da o si su cuenta dice que lo desbloqueó. Los admins escriben la segunda mitad con /hiteffectsadmin unlocks grant <jugador> <efecto> y /hiteffectsadmin unlocks revoke <jugador> <efecto>.
Apaga la caja#
crate.enabled: false deja el botón en su sitio y hace que avise de que la caja está cerrada.
Detalles técnicos
crate:
enabled: true
start-keys: 0
duplicate-refund: 1
reward: UNLOCK
blocks: []
max-at-once: 4
spin-frames: 34
stagger-seconds: 2.0
opening: INVENTORY
tiers:
common:
name: "Común"
material: GRAY_DYE
color: "{muted}"
chance: 60.0
priority: 1| Clave de rareza | Qué hace |
|---|---|
name | Cómo llaman menús y placeholders a la rareza. |
material | El objeto con el que se dibuja la rareza. |
color | El color en que se escriben sus efectos, mira Colores. |
chance | Cuántas veces para un carrete en ella, relativo a las demás. |
priority | Su posición en los menús; el menor va primero. |
spin-frames es por cuántas caras pasa el primer carrete antes de parar; más es una caída más larga, con tope de 200 (unos once segundos). crate.blocks guarda server,world,x,y,z,yaw,pitch: enlaza los bloques en el juego, no a mano. Un bloque en un mundo que carga después responde en cuanto ese mundo carga. La llave-objeto se distingue por datos que lleva, no por su nombre ni su material.
Las llaves se gastan y los premios se deciden antes del primer fotograma, pero cada uno se entrega al parar su carrete. Si el jugador sale a mitad de la tirada, el carrete se resuelve al salir: el efecto queda desbloqueado y cualquier ficha espera en la cola de recompensas hasta su próxima entrada. Lo que quedó a un hueco de la línea sigue en pantalla al parar. Comandos de bloques: /hiteffectsadmin crate block add|remove|list|clear.
¿Falta algo en esta página? Dínoslo en Discord