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?

default

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!'

v2

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!'

v1

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.

default

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!'

v2

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!'

v1

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'