Sub-Botones

Configuración de los sub-botones del botón principal

Para entender esta página de la wiki se requiere tener conocimiento sobre acciones y condiciones de TrMenu.

Los sub-botones es una forma de mostrar el botón actual de diferente manera si se cumple cierta condición.

Las acciones de los sub-botones son independientes a las acciones el botón principal, en otras palabras, dependiendo como se muestre el botón sus acciones serán ejecutadas de la manera en como se muestra.

Formas de escribirlo

Normal: Icons
RegEx: (sub|priority)?icons?

Buttons:
  'A':
    display:
      material: REDSTONE_BLOCK
      name: '&cNo tienes el permiso'
    actions:
      all:
        - 'close'
    icons:
      - condition: 'perm *permiso.123.asd'
        display:
          material: EMERALD_BLOCK
          name: '&aDale click'
        actions:
          all:
            - 'close'
            - 'tell: &aSi tienes el permiso!'

Configuración en TrMenu v2

Buttons:
  'A':
    display:
      material: REDSTONE_BLOCK
      name: '&cNo tienes el permiso'
    actions:
      all:
        - 'close'
    icons:
      - condition: 'hasPerm.permiso.123.asd'
        display:
          material: EMERALD_BLOCK
          name: '&aDale click'
        actions:
          all:
            - 'close'
            - 'tell: &aSi tienes el permiso!'

Configuración en TrMenu v1

Buttons:
  'A':
    display:
      material: REDSTONE_BLOCK
      name: '&cNo tienes el permiso'
    actions:
      all:
        - 'close'
    icons:
      - condition: 'player.hasPermission("permiso.123.asd")'
        display:
          material: EMERALD_BLOCK
          name: '&aDale click'
        actions:
          all:
            - 'close'
            - 'tell: &aSi tienes el permiso!'

Prioridad

En caso de que se puedan cumplir más de una condición al mismo tiempo existe la opción de añadirle prioridad al sub-botón.
En TrMenu v1 y v2 entre mayor sea su prioridad se verificará su condición primero.
Desde TrMenu v3 la prioridad es solamente el orden de los sub-botones, por lo que los números más pequeños serán verificados primero.

Buttons:
  'A':
    display:
      material: REDSTONE_BLOCK
      name: '&cNo ningun permiso'
    actions:
      all:
        - 'close'
    icons:
      - condition: 'perm *permiso.abc'
        priority: 2
        display:
          material: EMERALD_BLOCK
          name: '&aDale click'
        actions:
          all:
            - 'close'
            - 'tell: &aTienes el permiso 1!'
      - condition: 'perm *permiso.123'
        priority: 1
        display:
          material: GOLD_BLOCK
          name: '&eDale click'
        actions:
          all:
            - 'close'
            - 'tell: &eTienes el permiso 2!'

Configuración en TrMenu v2

Buttons:
  'A':
    display:
      material: REDSTONE_BLOCK
      name: '&cNo ningun permiso'
    actions:
      all:
        - 'close'
    icons:
      - condition: 'hasPerm.permiso.abc'
        priority: 1
        display:
          material: EMERALD_BLOCK
          name: '&aDale click'
        actions:
          all:
            - 'close'
            - 'tell: &aTienes el permiso 1!'
      - condition: 'hasPerm.permiso.123'
        priority: 2
        display:
          material: GOLD_BLOCK
          name: '&eDale click'
        actions:
          all:
            - 'close'
            - 'tell: &eTienes el permiso 2!'

Configuración en TrMenu v1

Buttons:
  'A':
    display:
      material: REDSTONE_BLOCK
      name: '&cNo ningun permiso'
    actions:
      all:
        - 'close'
    icons:
      - condition: 'player.hasPermission("permiso.abc")'
        priority: 1
        display:
          material: EMERALD_BLOCK
          name: '&aDale click'
        actions:
          all:
            - 'close'
            - 'tell: &aTienes el permiso 1!'
      - condition: 'player.hasPermission("permiso.123")'
        priority: 2
        display:
          material: GOLD_BLOCK
          name: '&eDale click'
        actions:
          all:
            - 'close'
            - 'tell: &eTienes el permiso 2!'

Display heredado

Disponible desde la versión 2.01 de TrMenu

Es una forma de establecer que el sub-botón tomará el nombre y lore del botón principal en caso de no ser especificada en el sub-botón.
Esta opción está siempre activada por defecto en TrMenu v1.

Formas de escribirlo

Normal: Inherit
RegEx: inherits?

Buttons:
  'A':
    display:
      material: REDSTONE_BLOCK
      name: '&cNombre principal'
      lore:
        - '&7Lore principal'
    icons:
      - condition: 'perm *permiso.abc'
        inherit: true
        # En este caso el sub-botón está tomando el lore principal
        display:
          material: EMERALD_BLOCK
          name: '&aNombre del sub-botón'
      - condition: 'perm *permiso.123'
        inherit: true
        # En este caso el sub-botón está tomando el nombre principal
        display:
          material: GOLD_BLOCK
          lore:
            - '&7Lore del sub-botón'

Configuración adjunta

Disponible desde la versión 3.3.1 de TrMenu

A diferencia del display heredado, aquí se puede establecer una forma más compleja de heredar cierta configuración del botón principal.
Se requiere especificar lo que se busca adjuntar mediante el nombre de su parámetro en forma única o en forma de lista.
La forma de adjuntar configuración puede ser mediante herencia o agregado.

Formas de escribir la herencia

Se escribe igual que en el display heredado, pero su configuración es distinta.
Normal: Inherit
RegEx: inherits?

Formas de escribir el agregado

Normal: Append
RegEx: appends?

Tipos de parámetros

Parámetro

Descripción

DISPLAY_NAME

Nombre del botón

DISPLAY_LORE

Descripción o lore del botón

DISPLAY_AMOUNT

Cantidad del botón

DISPLAY_SHINY

Condición o estado de brillo del botón

DISPLAY_FLAGS

Flags o banderas adjuntas al material del botón

DISPLAY_NBT

Data interna del botón

ACTIONS

Acciones que ejecuta el botón

El parámetro ACTIONS al ser heredado NO reemplaza las acciones del sub-botón, sino que hace que las acciones del botón principal se incluyan primero en la lista de acciones del sub-botón para luego ejecutar las del sub-botón.

Mientras que al incluir el parámetro ACTIONS como un agregado, hace que las acciones del sub-botón se ejecuten primero y luego se ejecuten las de botón principal.

Buttons:
  'A':
    display:
      material: REDSTONE_BLOCK
      shiny: true
      name: '&cNombre principal'
      lore:
        - '&7Lore principal'
    icons:
      - condition: 'perm *permiso.abc'
        # Herencia escrita en forma única
        inherit: DISPLAY_LORE
        # Herencia escrita en forma de lista
        inherit:
          - DISPLAY_LORE
          - DISPLAY_SHINY
        # En este caso el sub-botón está tomando el lore principal
        display:
          material: EMERALD_BLOCK
          name: '&aNombre del sub-botón'

AnteriorAcciones SiguienteInformación

Última actualización hace 1 año

¿Te fue útil?