Saltar al contenido

Funciones

Menús

Menús de inventario integrados para jugadores y staff, y menús propios escritos en menus.yml con acciones, permisos y placeholders.

El módulo menus ofrece los menús integrados y los menús personalizados. Los diseños, iconos, sonidos y menús propios están en menus.yml; los textos en lang/menus/<idioma>.yml.

Menús integrados

Tienda, reportes, preferencias, ignorados, color de nombre, perfil, panel de jugador, historial de sanciones, cola de reportes, rangos del jugador, editor de rangos, plantillas VIP, bossbars, anuncios de red, ajustes de moderación, lista de staff y lista de jugadores. Consulta Comandos de menús.

Los menús nunca se saltan una regla: cada acción usa el mismo servicio que su comando (jerarquía, permisos, validación, auditoría). Las acciones irreversibles piden confirmación.

Menús personalizados

menus.ymlYAML
custom:
  servidor:
    title: "&8Menú del servidor"
    rows: 3
    permission: ""            # vacío = todos; por defecto sofycore.menus.open.<id>
    items:
      spawn:
        slot: 11
        material: "COMPASS"
        name: "&aSpawn"
        lore: ["&7Ir al spawn"]
        actions: ["[player] spawn", "[close]"]
      tienda:
        slot: 15
        material: "GOLD_INGOT"
        glow: true
        actions: ["[open] vip-shop"]

Se abre con /menu servidor.

Acciones

AcciónEfecto
[player] <comando>Ejecuta un comando como el jugador
[console] <comando>Ejecuta un comando como la consola ({player} es el nombre validado del jugador)
[message] <texto>Envía un mensaje
[sound] <clave>Reproduce un sonido configurado
[open] <menú>Abre un menú personalizado o integrado
[close]Cierra el menú

right-actions se usa con clic derecho (si no está, actions). Otros campos de ítem: slots: "0-8,18-26", amount, model, own-head y un permission por ítem.

Materiales entre versiones

Los materiales admiten varios nombres separados por |; gana el primero que exista. "LIME_WOOL|WOOL:5" funciona en 1.8 y en 26.x.

Protección y rendimiento

  • Los ítems del menú no se pueden sacar, mover, arrastrar, soltar ni intercambiar; los restos se borran al cerrar el menú.
  • Todas las consultas son asíncronas: el menú se abre al instante con "Cargando" y se completa en el mismo inventario.
  • Las cabezas muestran primero la skin por defecto y se actualizan cuando llega la real.
  • Una acción que cambia datos bloquea el menú hasta terminar, así un doble clic nunca la ejecuta dos veces.