Contenido generado con IA — puede contener errores.

ExyliaPracticeBot/ConfigurarguideActualizada en v1.5.0

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ú.

Página 7 de 2113 min de lectura

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:

ArchivoPantalla
plugins/ExyliaPracticeBotV3/lang/<code>/menus/user/main.ymlEl 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.ymlAjuste 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.

La carpeta user/ es deliberada

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.

ÍtemRanuraClic izquierdoClic derecho
mode3cycle modecycle mode back
difficulty4cycle difficultycycle difficulty back
advanced5open_advanced_settings
helmet10cycle helmetcycle helmet_enchant
chestplate19cycle chestplatecycle chestplate_enchant
leggings28cycle leggingscycle leggings_enchant
boots37cycle bootscycle boots_enchant
main-hand16cycle main_handcycle knockback
off-hand25cycle off_hand
potions34cycle strengthcycle speed
teleport43tp_to_bottp_bot_to_me
toggle-shield13toggle shield_up
toggle-attack22toggle attack
toggle-follow31toggle follow
spawn48spawn
reset49reset_settings
remove50remove

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.

ÍtemRanuraClic izquierdoClic derecho
attack-damage10adjust attack_damage 0.5adjust attack_damage -0.5
toggle-anti-knockback13toggle anti_knockback
follow-distance16adjust follow_distance 0.5adjust follow_distance -0.5
attack-reach19adjust attack_reach 0.1adjust attack_reach -0.1
toggle-slow-falling22toggle slow_falling
max-health25adjust max_health 2adjust max_health -2
attack-speed28adjust attack_speed 0.1adjust attack_speed -0.1
toggle-fire-resistance31toggle fire_resistance
shield-disable34adjust shield_disable 0.5adjust shield_disable -0.5
movement-speed37adjust movement_speed 0.1adjust movement_speed -0.1
totems40adjust totems 1adjust totems -1
toggle-instant-totems41toggle instant_totems
toggle-invincible43toggle invincible
back49back

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:

yaml
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ónQué hace
spawnInvoca 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.
removeManda al bot fuera. Nunca necesita nodo.
tp_to_botTeletransporta al jugador hasta su bot. Necesita exyliapracticebot.teleport.
tp_bot_to_meTeletransporta al bot hasta el jugador. Necesita exyliapracticebot.teleport.
open_advanced_settingsAbre user/advanced. Necesita exyliapracticebot.advanced.
open_mainAbre user/main. Ningún archivo incluido la usa; está para tus propios botones.
reset_settingsPide 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.

Las listas de campos son cerradas

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>#

CampoAjuste
attackSi el bot devuelve los golpes o no.
followSi sigue a su dueño.
shield_upPráctica de stun slam: el bot nunca golpea y mantiene un escudo levantado hacia ti. Ver Comportamiento.
invincibleNunca muere.
instant_totemsUn tótem gastado vuelve a la mano en el siguiente tick.
anti_knockbackIgnora el empuje por completo.
slow_fallingCaída Lenta permanente.
fire_resistanceResistencia al Fuego permanente.

cycle <campo> [back]#

CampoRecorre
helmet, chestplate, leggings, bootsNONE → DIAMOND → NETHERITE
helmet_enchant, chestplate_enchant, leggings_enchant, boots_enchantNONE → PROTECTION → BLAST_PROTECTION
main_handSWORD → AXE → MACE → TOTEM
off_handNONE → TOTEM → SHIELD
knockbackNONE → KNOCKBACK_1 → KNOCKBACK_2
strengthNONE → STRENGTH_1 → STRENGTH_2
speedNONE → SPEED_1 → SPEED_2
modeLos siete modos de combate
difficultyLas 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>#

CampoAjuste
attack_damageDaño de un golpe cargado del todo y no crítico.
attack_reachBloques desde los que puede golpear.
attack_speedMultiplicador sobre la cadencia que eligió el modo.
movement_speedMultiplicador sobre la velocidad al andar y al correr.
follow_distanceCómo de cerca se queda cuando no está peleando.
max_healthVida máxima, en medios corazones.
totemsTótems de repuesto por vida.
shield_disableSegundos 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ú
PlaceholderContiene
%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.

Son placeholders de menú y nada más

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