Menú

Tipos de acciones que interactúan con menus

1. Cerrar menú

Con este tipo de acción puedes cerrar el menú actual.

1.1 Cerrar con normalidad

• Cerrar el menú como si el jugador lo hiciera.

• Formas de escribirlo:

  • Normal: close

  • RegEx: close|shut

- 'close'

1.2 Cerrar silenciosamente

• Cerrar el menú sin activar los eventos de menú, esto quiere decir que si el jugador no puede cerrar el menú por alguna condición igualmente se cerrará.

• Formas de escribirlo:

  • Normal: silent-close

  • RegEx: (force|silent)-?(close|shut)

- 'silent-close'

2. Abrir menú

Con este tipo de acción pueden abrir otro menú de TrMenu.

2.1 Abrir con normalidad

• Abrir un menú de TrMenu.

• Formas de escribirlo:

  • Normal: gui

  • RegEx: opens?|(open)?-?gui|(tr)?menu

# El nombre o identificador el menú que será abierto es "example"
- 'gui: example'

# Abrir un menú en la página 2
- 'gui: example:1'

# Abrir un menú con los argumentos "hola" "naranja"
- 'gui: example hola naranja'

2.2 Abrir silenciosamente

• Abrir el menú sin activar los eventos de menú, esto quiere decir que si el jugador no puede abrir el menú por alguna condición igualmente se abrirá.

• Formas de escribirlo:

  • Normal: silent-open

  • RegEx: (force|silent)-?(open|menu)

# El nombre o identificador el menú que será abierto es "example"
- 'silent-open: example'

# Abrir un menú en la página 2
- 'silent-open: example:1'

# Abrir un menú con los argumentos "hola" "naranja"
- 'silent-open: example hola naranja'

3. Inventario

Acciones que afectan el menú actual.

3.1. Cambiar página

Disponible desde la versión 1.15 de TrMenu

• Con esta acción cambias la página actual del menú.

• Formas de escribirlo:

  • Normal: page

  • RegEx: (set|switch)?-?(layout|shape|page)s?

# La página 0 es la primera
# La página 1 es la segunda
# La página 2 es la tercera
# ... etc.
- 'page: 2'

3.2. Cambiar título

• Cambiar el título del menú actual.

• Formas de escribirlo:

  • Normal: set-title

  • RegEx: set-?title

- 'set-title: &eNuevo título'

3.3 Resetear botones

Disponible desde la versión 2.01 de TrMenu

• Esto hace que los botones del menú tengan un reset, en otras palabras, su material, nombre, lore y caché se reiniciará.

• Esto puede ser útil si alguna textura de las cabezas no carga correctamente o si quieres simular el volver a abrir el menú.

• Formas de escribirlo:

  • Normal: reset

  • RegEx: resets?

- 'reset'

3.4 Recargar inventario

Disponible desde la versión 3.0 de TrMenu

• Esto actualiza el inventario del jugador mientras el menú de TrMenu sigue abierto.

• Formas de escribirlo:

  • Normal: reload-inv

  • RegEx: (reload|rl)-?inv(entory)?s?

- 'reload-inv'

3.5 Limpiar inventario

Esto fue removido en la actualización 2.0 de TrMenu debido a que el bug ya no sucede.

Disponible desde la versión 1.12 de TrMenu

• En caso de que algún botón en el menú siga presente a pesar de querer ocultarlo, ya sea por una mala práctica del caché o bug visual, puedes utilizar esta acción para borrar los botones inexistentes.

• Formas de escribirlo:

  • Normal: clear-slots

  • RegEx: clear(-)?slot(s)?

- 'clear-slots'

4. Argumentos

Disponible desde la versión 2.01 de TrMenu

Con estas acciones puedes editar los argumentos del jugador.

4.1 Cambiar argumentos

• Cambiar los argumentos del jugador.

• Desde la versión 2.01 de TrMenu puedes encerrar entre `` los argumentos con más de 1 palabra.

• Desde la versión 3.0 de TrMenu, al usar esta acción el jugador recibe la metadata "FORCE_ARGS".

• Formas de escribirlo:

  • Normal: set-args

  • RegEx: set-?arg(ument)?s?

- 'set-args: argumento0 `argumento 1` arg2'

4.2 Eliminar argumentos

Disponible desde la versión 3.0 de TrMenu

• Eliminar los argumentos actuales del jugador.

• Formas de escribirlo:

  • Normal: clear-args

  • RegEx: (clear|cls|del|rem)-?arg(ument)?s?

- 'clear-args'

5. Botón

Acciones que afectan el botón presionado o botones del menú.

5.1 Revisar condiciones

• Hace una revisión manual a las condiciones de los sub-botones.

• Esto no afecta el chequeo automático.

• Desde la versión 3.0 de TrMenu puedes revisar botones en específico.

• Formas de escribirlo:

  • Normal: refresh

  • RegEx: (icon)?-?refresh

# Hacer una revisión en todos los botones del menú
- 'refresh'

# Hacer una revisión para el botón con el ID "A"
- 'refresh: A'

# Hacer una revisión para los botones "A", "asd" y "B"
- 'refresh: A;asd;B'

5.2 Actualizar botón

Disponible desde la versión 3.0 de TrMenu

• Actualiza manualmente el material, nombre, lore y slot del ítem del botón.

• Esto no afecta el actualizador configurado.

• Formas de escribirlo:

  • Normal: update

  • RegEx: (icon)?-?update

# Actualizar todos los botones del menú
- 'update'

# Actualizar el botón con el ID "A"
- 'update: A'

# Actualizar los botones "A", "asd" y "B"
- 'update: A;asd;B'

5.3 Cambiar slots

Esto fue removido en la actualización 2.0 de TrMenu

Disponible desde la versión 1.12 de TrMenu

• Cambia manualmente los slots donde se mostrará el botón presionado.

• Formas de escribirlo:

  • Normal: set-slots

  • RegEx: set(-)?slot(s)?

- 'set-slots: 10,3,15,7'

6. Agente

Acciones que afectan el agente del menú.

El agente es el jugador que se utiliza para procesar cualquier condición y placeholder en el menú, por defecto es el mismo jugador que abre el menú.

6.1 Cambiar el agente

Disponible desde la versión 3.01 de TrMenu

• Cambia el agente actual del menú por otro jugador.

• El nombre debe ser el de un jugador conectado.

• Si quieres que el menú se cierre en caso de que el agente se desconecte, se sugiere crear un task que detecte si el jugador sigue conectado.

• Formas de escribirlo:

  • Normal: set-agent

  • RegEx: (set|change)-?agent

# Hace que el agente cambie por "Rubenicos" (suponiendo que se encuentre conectado)
- 'set-agent: Rubenicos'

7. Propiedad

Acciones que afectan las propiedades del menú.

Las propiedades son la forma en como se muestra información extra en la visión del menú por parte del jugador que lo tiene abierto.

6.1 Cambiar propiedad

Disponible desde la versión 3.3.0 de TrMenu

• Cambia una propiedad del menú actual.

• Formas de escribirlo:

  • Normal: set-property

  • RegEx: set-?property

- 'set-property: BURN_TIME 10'