Menús
Los dos archivos de menú editables, a qué está conectado cada botón, el vocabulario completo de acciones y los placeholders que puede leer un menú.
Renombra, mueve, recolorea o reconecta los botones de /bot y de su pantalla de Ajuste fino. Las dos
pantallas son archivos YAML que te pertenecen, y /botadmin reload aplica tus cambios sin reiniciar.
Antes de empezar#
Los menús usan el YAML declarativo de ExyliaLib, así que lee una vez Editar menús para las claves de ítem, el bloque de relleno y los sonidos. Los colores están en Colores.
Pasos#
Abre el archivo
Abre plugins/ExyliaPracticeBotV3/lang/<code>/menus/user/main.yml (el hub de /bot) o advanced.yml
(Ajuste fino), donde <code> es el idioma fijado en config.yml.
Edita el ítem
Busca el botón en las tablas de abajo y cambia su name, lore, material o slot. Su lista
actions dice qué hace un clic.
Recarga
Ejecuta /botadmin reload. Los menús se vuelven a leer junto con config.yml y messages.yml.
Comprueba que funciona#
Ejecuta /bot otra vez: el botón muestra tu texto o su nueva posición y un clic sigue cambiando el
mismo ajuste. Si un clic no hace nada, el nombre de la acción está mal; mira
las listas de campos.
Los dos archivos#
/bot abre una pantalla y esa pantalla abre una más:
| Archivo | Pantalla |
|---|---|
plugins/ExyliaPracticeBotV3/lang/<code>/menus/user/main.yml | El hub que abre /bot: modo, dificultad, armadura, manos, pociones y los botones de generar y eliminar el bot. |
plugins/ExyliaPracticeBotV3/lang/<code>/menus/user/advanced.yml | Ajuste fino: los deslizadores numéricos y los interruptores de sandbox. |
<code> es el idioma fijado en config.yml. Un archivo que falta se vuelve a escribir y un botón
nuevo llega con la actualización, pero lo que editaste nunca se sobrescribe: un valor por defecto
cambiado espera en /exylialib updates para que lo revises. /botadmin reload vuelve a leer ambos, junto con config.yml y
messages.yml. El formato es el YAML declarativo de menús de ExyliaLib — ver la
página de menús de la librería para las claves de ítem, el bloque de relleno
y los sonidos.
El id de un menú es su ruta bajo menus/ sin la extensión, y por eso los dos archivos viven en
user/. Es la disposición que usa cada plugin de Exylia. Mover un archivo fuera de user/ cambia su
id y el plugin ya no lo encuentra. El centro de ajustes del staff vive en una carpeta admin/
(admin/settings, admin/settings_bot, admin/settings_spawning, admin/settings_fighting); esos
archivos se reescriben desde el jar en cada arranque, así que no los edites.
Estilo de menú Screen#
En un servidor cuyo estilo de menú de ExyliaLib es SCREEN, /bot y la pantalla de Ajuste fino se
dibujan como pantallas completas en lugar de cofres: el bot aparece en el círculo con el equipo que
lleva, y cada pieza, el modo, la dificultad y los interruptores quedan a un clic (clic izquierdo para el
siguiente valor, clic derecho para el anterior o el segundo ajuste). Las pantallas son
screens/bot.html (que enruta user/main) y screens/bot_tuning.html; sus textos salen de
lang/<code>/screens/bot.yml y bot_tuning.yml, y ejecutan las mismas acciones que los menús de cofre,
así que un clic cambia el mismo ajuste. Pon tus reglas de estilo en custom.css, junto a theme.css.
Un archivo de pantalla que no se puede leer deja el menú de cofre y registra el motivo;
/exylialib screens check lista lo que falla.
main.yml#
size: 54, type: SIMPLE, un relleno de cristal gris y refresco ON_CLICK, para que un botón muestre
su nuevo valor en el momento en que lo pulsas.
| Ítem | Ranura | Clic izquierdo | Clic derecho |
|---|---|---|---|
mode | 3 | cycle mode | cycle mode back |
difficulty | 4 | cycle difficulty | cycle difficulty back |
advanced | 5 | open_advanced_settings | |
helmet | 10 | cycle helmet | cycle helmet_enchant |
chestplate | 19 | cycle chestplate | cycle chestplate_enchant |
leggings | 28 | cycle leggings | cycle leggings_enchant |
boots | 37 | cycle boots | cycle boots_enchant |
main-hand | 16 | cycle main_hand | cycle knockback |
off-hand | 25 | cycle off_hand | |
potions | 34 | cycle strength | cycle speed |
teleport | 43 | tp_to_bot | tp_bot_to_me |
toggle-shield | 13 | toggle shield_up | |
toggle-attack | 22 | toggle attack | |
toggle-follow | 31 | toggle follow | |
spawn | 48 | spawn | |
reset | 49 | reset_settings | |
remove | 50 | remove |
advanced.yml#
El mismo armazón, más parent: "user/main" — que es lo que hace funcionar el botón Volver de la
ranura 49.
| Ítem | Ranura | Clic izquierdo | Clic derecho |
|---|---|---|---|
attack-damage | 10 | adjust attack_damage 0.5 | adjust attack_damage -0.5 |
toggle-anti-knockback | 13 | toggle anti_knockback | |
follow-distance | 16 | adjust follow_distance 0.5 | adjust follow_distance -0.5 |
attack-reach | 19 | adjust attack_reach 0.1 | adjust attack_reach -0.1 |
toggle-slow-falling | 22 | toggle slow_falling | |
max-health | 25 | adjust max_health 2 | adjust max_health -2 |
attack-speed | 28 | adjust attack_speed 0.1 | adjust attack_speed -0.1 |
toggle-fire-resistance | 31 | toggle fire_resistance | |
shield-disable | 34 | adjust shield_disable 0.5 | adjust shield_disable -0.5 |
movement-speed | 37 | adjust movement_speed 0.1 | adjust movement_speed -0.1 |
totems | 40 | adjust totems 1 | adjust totems -1 |
toggle-instant-totems | 41 | toggle instant_totems | |
toggle-invincible | 43 | toggle invincible | |
back | 49 | back |
back es una acción de la propia ExyliaLib, no de este plugin; necesita la clave parent de arriba y
nada más.
Escribir una acción#
Las acciones van en la lista actions de un ítem, con el clic que las dispara como prefijo opcional:
actions:
- "left: cycle helmet"
- "right: cycle helmet_enchant"Una entrada sin prefijo se dispara con cualquier clic. Las acciones se escriben sin prefijo de espacio
de nombres y se resuelven en el de este plugin, practicebot, así que cycle mode y
practicebot:cycle mode son lo mismo.
El vocabulario completo#
| Acción | Qué hace |
|---|---|
spawn | Invoca el bot del jugador donde está de pie. Necesita exyliapracticebot.spawn; se niega en un mundo fuera de worlds, y se niega si ya tiene uno. |
remove | Manda al bot fuera. Nunca necesita nodo. |
tp_to_bot | Teletransporta al jugador hasta su bot. Necesita exyliapracticebot.teleport. |
tp_bot_to_me | Teletransporta al bot hasta el jugador. Necesita exyliapracticebot.teleport. |
open_advanced_settings | Abre user/advanced. Necesita exyliapracticebot.advanced. |
open_main | Abre user/main. Ningún archivo incluido la usa; está para tus propios botones. |
reset_settings | Pide confirmación y después devuelve cada ajuste al valor por defecto del servidor, kit incluido, y reabre el menú principal. |
set_mode <modo> | Fija el modo directamente. Un nombre no reconocido cae en NONE. Necesita exyliapracticebot.mode.<modo>, salvo para NONE. |
set_difficulty <dificultad> | Fija la dificultad directamente. Un nombre no reconocido cae en NORMAL. Necesita exyliapracticebot.difficulty.<dificultad>. |
toggle <campo> | Invierte un booleano. Los cuatro interruptores de Ajuste fino necesitan exyliapracticebot.advanced. |
cycle <campo> [back] | Avanza un ajuste a su siguiente valor, o al anterior con back. mode y difficulty se saltan los valores para los que el jugador no tiene nodo. |
adjust <campo> <delta> | Suma delta a un número, con recorte y redondeo. Necesita exyliapracticebot.advanced. |
Un clic para el que el jugador no tiene nodo responde con bot.no-permission y no cambia nada. Ver
Permisos.
set_mode y set_difficulty están para un menú que quiera un botón por modo en lugar de un botón que
cicla. Ver Modos y
Dificultad para los nombres que aceptan.
toggle, cycle y adjust aceptan exactamente los campos de abajo. Un nombre que no esté en su lista
hace fallar la acción — el clic no hace nada y el ajuste queda intacto. No hay forma de añadir un campo
desde el YAML.
Listas de campos de toggle, cycle y adjust
toggle <campo>#
| Campo | Ajuste |
|---|---|
attack | Si el bot devuelve los golpes o no. |
follow | Si sigue a su dueño. |
shield_up | Práctica de stun slam: el bot nunca golpea y mantiene un escudo levantado hacia ti. Ver Comportamiento. |
invincible | Nunca muere. |
instant_totems | Un tótem gastado vuelve a la mano en el siguiente tick. |
anti_knockback | Ignora el empuje por completo. |
slow_falling | Caída Lenta permanente. |
fire_resistance | Resistencia al Fuego permanente. |
cycle <campo> [back]#
| Campo | Recorre |
|---|---|
helmet, chestplate, leggings, boots | NONE → DIAMOND → NETHERITE |
helmet_enchant, chestplate_enchant, leggings_enchant, boots_enchant | NONE → PROTECTION → BLAST_PROTECTION |
main_hand | SWORD → AXE → MACE → TOTEM |
off_hand | NONE → TOTEM → SHIELD |
knockback | NONE → KNOCKBACK_1 → KNOCKBACK_2 |
strength | NONE → STRENGTH_1 → STRENGTH_2 |
speed | NONE → SPEED_1 → SPEED_2 |
mode | Los siete modos de combate |
difficulty | Las cinco dificultades |
Todas las listas vuelven al principio al terminar. back solo significa algo para mode y
difficulty — el resto es lo bastante corto como para que adelante sea la única dirección que alguien
necesita, y ahí el argumento se ignora.
adjust <campo> <delta>#
| Campo | Ajuste |
|---|---|
attack_damage | Daño de un golpe cargado del todo y no crítico. |
attack_reach | Bloques desde los que puede golpear. |
attack_speed | Multiplicador sobre la cadencia que eligió el modo. |
movement_speed | Multiplicador sobre la velocidad al andar y al correr. |
follow_distance | Cómo de cerca se queda cuando no está peleando. |
max_health | Vida máxima, en medios corazones. |
totems | Tótems de repuesto por vida. |
shield_disable | Segundos que un hachazo mantiene su escudo abajo. |
delta puede ser negativo, y así es como los archivos que trae el plugin escriben sus botones de
bajada. Cada resultado se recorta al par correspondiente del bloque limits de config.yml y luego se
redondea a un decimal, así que un botón con un delta más fino que 0.1 parecerá no hacer nada.
totems se redondea a un número entero después del recorte. Ver
Límites.
Placeholders#
Un archivo de menú puede leer los ajustes actuales del jugador con estos nombres. %name% es la
etiqueta que se imprime y %name_material% es el ícono que se dibuja — que es cómo la columna de
armadura muestra la pieza que el bot lleva de verdad y cambia bajo el cursor.
Todos los placeholders de menú
| Placeholder | Contiene |
|---|---|
%bot_active% | Si el jugador tiene un bot fuera, como ON u OFF. |
%mode% | La etiqueta del modo. |
%mode_material% | El ítem con el que se dibuja el modo. |
%mode_summary% | La línea que explica con qué pelea el modo. |
%difficulty% | La etiqueta de la dificultad. |
%difficulty_material% | El ítem con el que se dibuja la dificultad. |
%difficulty_summary% | La línea que explica qué cambia la dificultad. |
%attack_mode% | Si el bot devuelve los golpes, como ON u OFF. |
%follow_owner% | Si sigue a su dueño, como ON u OFF. |
%shield_up% | Si Escudo arriba está activado, como ON u OFF. |
%invincible% | Si puede morir, como ON u OFF. |
%anti_knockback% | Si ignora el knockback, como ON u OFF. |
%slow_falling% | Si tiene Caída Lenta permanente, como ON u OFF. |
%fire_resistance% | Si tiene Resistencia al Fuego permanente, como ON u OFF. |
%helmet% | La etiqueta del casco. |
%helmet_material% | El casco que lleva el bot de verdad, como ítem. |
%helmet_enchant% | La etiqueta del encantamiento del casco. |
%helmet_enchant_material% | El ícono de ese encantamiento. |
%chestplate% | La etiqueta de la pechera. |
%chestplate_material% | La pechera que lleva el bot de verdad, como ítem. |
%chestplate_enchant% | La etiqueta del encantamiento de la pechera. |
%chestplate_enchant_material% | El ícono de ese encantamiento. |
%leggings% | La etiqueta de los pantalones. |
%leggings_material% | Los pantalones que lleva el bot de verdad, como ítem. |
%leggings_enchant% | La etiqueta del encantamiento de los pantalones. |
%leggings_enchant_material% | El ícono de ese encantamiento. |
%boots% | La etiqueta de las botas. |
%boots_material% | Las botas que lleva el bot de verdad, como ítem. |
%boots_enchant% | La etiqueta del encantamiento de las botas. |
%boots_enchant_material% | El ícono de ese encantamiento. |
%main_hand% | La etiqueta del arma. |
%main_hand_material% | El arma como ítem. |
%off_hand% | La etiqueta de la mano secundaria. |
%off_hand_material% | La mano secundaria como ítem. Una barrera cuando está vacía. |
%knockback% | El nivel de Empuje del arma, como etiqueta. |
%strength% | El nivel de Fuerza, como etiqueta. |
%speed% | El nivel de Velocidad, como etiqueta. |
%attack_damage% | Daño de un golpe cargado del todo, con un decimal. |
%attack_reach% | Alcance de ataque en bloques, con un decimal. |
%attack_speed% | El multiplicador de cadencia, con un decimal. |
%movement_speed% | El multiplicador de velocidad de movimiento, con un decimal. |
%follow_distance% | Distancia de seguimiento en bloques, con un decimal. |
%max_health% | Vida máxima en medios corazones, con un decimal. |
%shield_disable% | Segundos que un hachazo mantiene el escudo bajado, con un decimal. |
%totems% | La reserva de tótems, o la etiqueta unlimited cuando está por debajo de cero. |
Cada etiqueta sale del bloque placeholders de messages.yml, así que renombrar Diamond o
recolorear Strength II es trabajo de ese archivo y nunca de este. %bot_active% no lo usa ninguno de
los dos archivos que trae el plugin; está ahí para un dueño que quiera que Generar bot y Eliminar bot
digan en qué estado están.
El plugin no registra ninguna expansión de PlaceholderAPI. Cada nombre de arriba lo resuelve el
menú que se está dibujando y no existe en ningún otro sitio — ni en un scoreboard, ni en un holograma,
ni en el mensaje de otro plugin. No hay ningún %practicebot_...% que puedas poner en ninguna parte.
¿Falta algo en esta página? Dínoslo en Discord