Saltar al contenido

Acciones de Ítem

ZenRewards permite asignar acciones especiales a los ítems de tus menús, lo que te da la posibilidad de ejecutar comandos o cerrar inventarios con un simple clic.
Estas acciones se definen dentro de la lista commands: de cualquier ítem decorativo o interactivo en menu.yml o streak-menu.yml.


AcciónUsoDescripción
[CLOSE][CLOSE]Cierra el inventario actual del jugador. Ideal para botones de salida.
[PLAYER] <comando>[PLAYER] spawnEjecuta un comando como si lo escribiera el jugador. Respeta sus permisos.
[CONSOLE] <comando>[CONSOLE] eco give %player% 100Ejecuta un comando desde la consola. Usa %player% para referirte al jugador.

💡 Consejo: Puedes combinar múltiples acciones en un mismo ítem.
El orden en la lista define el orden de ejecución.


A continuación, se muestran ejemplos prácticos de cómo aplicar estas acciones en ítems del menú:

items:
# 🔴 Botón para cerrar el menú
close_button:
slot: 49
material: BARRIER
name: "&c&lCerrar"
lore:
- "&7Haz clic para salir."
commands:
- "[CLOSE]"
# 💰 Ítem que otorga una pequeña bonificación
bonus_item:
slot: 40
material: SUNFLOWER
name: "&e¡Bonus!"
lore:
- "&7Haz clic para recibir 50 monedas."
commands:
- "[CONSOLE] eco give %player% 50"
- "[PLAYER] me ¡He recibido un bonus!"
# 🧭 Ítem que envía al jugador al spawn
go_spawn:
slot: 4
material: COMPASS
name: "&aIr al Spawn"
lore:
- "&7Vuelve al punto de inicio."
commands:
- "[PLAYER] spawn"
- "[CLOSE]"

  • Puedes usar placeholders en los comandos (%player%, %prefix%, etc.).
  • Las acciones no requieren permisos adicionales, a menos que el comando del jugador lo solicite.
  • Es posible combinar acciones de jugador + consola + cierre en un mismo ítem.
  • Ideal para crear botones de navegación, confirmaciones o accesos rápidos en tus menús.