Contenido generado con IA — puede contener errores.

ExyliaPracticeBot/ReferenciareferenceActualizada en v1.5.0

Configuración

Dónde están config.yml y messages.yml, los pocos ajustes que suelen cambiar los dueños (mundos, límite de bots, reaparición, idioma) y cada clave con su valor por defecto.

Página 13 de 2119 min de lectura

ExyliaPracticeBot tiene dos archivos que editas: config.yml para cómo se comporta el plugin y messages.yml para lo que leen los jugadores. La mayoría de servidores cambia cuatro cosas y deja el resto.

Los dos se generan en plugins/ExyliaPracticeBotV3/ la primera vez que arranca el plugin, ya con comentarios dentro; messages.yml y los menús van en una carpeta de idioma, lang/<code>/. Edita los archivos de ahí, nunca las copias del jar, y ejecuta /botadmin reload: vuelve a leer config.yml, messages.yml y los dos archivos de menú. Los colores usan tokens de paleta como {primary} o {success} (colores).

Los ajustes que un admin toca con el servidor en marcha también se pueden cambiar en el juego: /botadmin settings, con exyliapracticebot.admin, abre un centro de páginas de ajustes (defaults, spawning, fighting) que guardan directamente en el mismo archivo; el resto sigue en el YAML. Ver Comandos.

Lo que suelen cambiar los dueños#

  1. worlds: los mundos donde se puede generar un bot. La lista por defecto trae los mundos sandbox de Exylia, así que en cualquier otro servidor se rechaza toda generación hasta que pongas aquí los nombres de tus mundos. Una lista vacía significa ningún sitio, no todos.
  2. bot.mode y bot.difficulty: el modo (POT_PVP) y la dificultad (NORMAL) con los que empieza un jugador. Cada jugador cambia los suyos desde /bot; editarlos después no toca a quien ya guardó ajustes. Ver Modos y Dificultad.
  3. max-bots y reserved-for-matches: cuántos bots corren a la vez en el servidor (16) y cuántos de esos huecos no pueden ocupar los jugadores por su cuenta (4). Ver Límites.
  4. respawn.enabled: ponlo en false y un bot al que matan se queda muerto hasta que el jugador genere otro.
  5. language: default sigue a ExyliaLib; en, es, pt, fr, ru o tr fijan solo este plugin. Ver Mensajes e idiomas.

El archivo es deliberadamente plano arriba: el modo decide el kit y qué técnicas existen, la dificultad decide con qué soltura se ejecutan, y todo lo que hay bajo advanced ya trae un valor que funciona.

config.yml#

Cada clave con su valor por defecto (config.yml)
plugins/ExyliaPracticeBotV3/config.yml
yaml
config-version: 4
 
language: default
 
bot:
  mode: POT_PVP
  difficulty: NORMAL
  skin: "%player%"
 
worlds:
  - exylia_sandbox_badlands
  - exylia_sandbox_desert
  - exylia_sandbox_mushroom
  - exylia_sandbox_plains
  - exylia_sandbox_snowy
 
respawn:
  enabled: true
  delay-seconds: 2.0
 
interaction:
  shift-click-opens-menu: true
 
advanced:
  attack:
    reach: 3.0
    damage: 7.0
    speed-multiplier: 1.0
  movement:
    speed-multiplier: 1.0
    follow-distance: 3.0
  health:
    max: 20.0
    invincible: false
    totems: -1
    instant-totems: false
  defense:
    shield: true
    shield-disable-seconds: 5.0
    anti-knockback: false
    slow-falling: false
  pot-pvp:
    apple-percent: 35.0
    potion-percent: 70.0
    enchanted-apples: false
  crystal-pvp:
    range: 5.0
    self-preservation-percent: 30.0
    anchor: true
    trap: true
    ender-pearls: true
    break-blocks: true
  mace-pvp:
    attribute-swap: true
    use-elytra: true
    prefer-density-height: 4.0
    breach-armor-threshold: 30.0
    shield-break-before-smash: true
    launch-range: 5.5
    wind-charge-cooldown-ticks: 38
    pearl-lift-cooldown-ticks: 110
    rocket-lift-cooldown-ticks: 90
    wind-charge-lift-min: 0.92
    wind-charge-lift-max: 1.14
    rocket-lift: 1.5
  uhc:
    apple-percent: 60.0
    cobweb: true
    lava: true
    water: true
  pathfinding:
    enabled: true
    max-search-radius-horizontal: 16
    max-search-radius-vertical: 10
    max-expanded-nodes: 200
    max-search-time-micros: 1500
    max-drop-height-safe: 3
    max-drop-height-protected: 10
    max-gap-jump-columns: 1
    stuck-check-interval-ticks: 10
    stuck-progress-epsilon: 0.5
    stuck-strikes-threshold: 2
    path-stale-distance: 5.0
    path-max-age-ticks: 60
    checkpoint-reached-radius: 0.6
    consecutive-failed-searches-before-cooldown: 3
    give-up-cooldown-ticks: 60
  practice-kits: {}
 
limits:
  min-attack-speed: 0.25
  max-attack-speed: 4.0
  min-movement-speed: 0.25
  max-movement-speed: 3.0
  min-attack-reach: 1.0
  max-attack-reach: 6.0
  min-follow-distance: 1.0
  max-follow-distance: 12.0
  min-attack-damage: 0.5
  max-attack-damage: 40.0
  min-max-health: 1.0
  max-max-health: 40.0
  min-shield-disable: 0.0
  max-shield-disable: 20.0
  min-totems: -1.0
  max-totems: 16.0
 
max-bots: 16
reserved-for-matches: 4

config-version lo escribe y lo mantiene el plugin; no lo toques. Un archivo escrito por la versión 1 se migra a esta disposición en el primer arranque en lugar de reemplazarse — cada valor que pudieras haber cambiado se mueve, y los deslizadores de probabilidad por modo se descartan a propósito, porque ahora la dificultad los deriva todos. La versión 3 añade language: custom a un servidor que ya usaba el plugin, apuntándolo a sus propios archivos movidos a lang/custom/; la versión 4 mueve bot.name a messages.yml, conservando el nombre que hubieras escrito.

language#

default. El idioma de los menús y mensajes del plugin. default sigue el idioma configurado en el config.yml de ExyliaLib; en, es, pt, fr, ru o tr lo fijan solo para este plugin. Cada uno es una carpeta dentro de lang/ que puedes editar. custom guarda los archivos que tenía un servidor antes de que existieran los idiomas: el primer arranque tras actualizar mueve los antiguos messages.yml y menus/ a lang/custom/ y pone language: custom, así que no se pierde nada de lo que editó el dueño. Una instalación nueva empieza en default.

bot#

ClavePor defectoQué hace
modePOT_PVPNONE, SWORD, POT_PVP, UHC, CRYSTAL_PVP, MACE_PVP o BOXING. Elegir un modo aplica el kit de ese modo y su modelo de combate. Un nombre no reconocido cae en NONE. Ver Modos.
difficultyNORMALEASY, NORMAL, HARD, INSANE o EXTREME. El tiempo de reacción, la puntería, la disciplina de enfriamiento y la técnica salen todos de aquí. Un nombre no reconocido cae en NORMAL. Ver Dificultad.
skin%player%Skin que lleva. %player% copia la skin del dueño.

El nombre sobre el bot es texto que lee un jugador, así que se traduce con el resto de mensajes: bot.name en messages.yml — {primary}Bot de %player% en español —, donde %player% es su dueño.

El propio bloque de comentarios del archivo generado resume los siete:

ModoCon qué pelea
SWORDEspada y escudo, casi ningún crítico, todo movimiento.
POT_PVPCríticos en casi cada golpe, pociones arrojadizas y manzanas.
UHCHacha y escudo, roturas de guardia, telaraña, lava, agua.
CRYSTAL_PVPObsidiana, cristales, anclas, perlas y tótems.
MACE_PVPCargas de viento y perlas hacia arriba, mazazos hacia abajo.
BOXINGLos golpes se cuentan, no se aplican. Práctica de combos.

NONE es el ajuste vanilla puro: sin técnicas y sin consumibles.

Las dos claves son el valor por defecto del servidor. Cada jugador tiene su propio modo y su propia dificultad desde el momento en que abre /bot, y cambiarlas después no toca a un jugador que ya guardó ajustes.

worlds#

Una lista simple de nombres de mundo: los mundos donde se puede invocar un bot. Un jugador que lo intente en cualquier otro sitio recibe el mensaje world-not-allowed y ningún bot.

Una instalación nueva no invoca nada hasta que edites esto

Los cinco valores por defecto son los mundos sandbox de Exylia y no existen en ningún otro servidor, así que recién instalado se rechaza toda invocación. Sustituye la lista por tus propios nombres de mundo antes de que nada funcione. Una lista vacía no es un comodín — vacía significa en ninguna parte.

En la versión 1 la clave era restrictions.allowed-worlds. Un archivo escrito por esa versión la ve movida a worlds automáticamente en el primer arranque, con la lista intacta.

respawn#

ClavePor defectoQué hace
enabledtrueSi un bot muerto vuelve por su cuenta.
delay-seconds2.0Segundos antes de que lo haga. Se convierte a ticks y nunca baja de un tick.

interaction#

ClavePor defectoQué hace
shift-click-opens-menutrueHacer shift + clic derecho sobre tu propio bot abre su menú.

advanced#

Perillas de sandbox y ajuste por modo. Se puede ignorar sin problema.

Cuatro de estos son solo valores de partida

advanced.attack, advanced.movement, advanced.health y advanced.defense son los valores con los que empiezan los ajustes de un jugador y a los que los devuelve Reiniciar ajustes. A partir de ahí cada jugador tiene su propia copia y la mueve desde el menú de Ajuste fino. Los bloques por modo de más abajo — pot-pvp, crystal-pvp, mace-pvp, uhc —, pathfinding y practice-kits no son por jugador: los lee la IA en vivo y se aplican a todos los bots del servidor.

advanced.attack

ClavePor defectoQué hace
reach3.0Bloques desde los que puede golpear el bot. Los jugadores vanilla tienen 3.0.
damage7.0Daño de un golpe cargado del todo y no crítico, en medios corazones. El escalado por enfriamiento y los críticos se aplican encima, exactamente como en vanilla.
speed-multiplier1.0Multiplica la cadencia que eligió el modo; 1.0 la deja en paz. El modo ya elige el tempo correcto — una barra moderna para cristales y maza, una tasa de clics para pot PvP. Sube esto solo para empujar un modo más allá de lo que podría hacer un jugador.

advanced.movement

ClavePor defectoQué hace
speed-multiplier1.0Multiplica la velocidad al andar y al correr. 1.0 es un jugador vanilla.
follow-distance3.0Cómo de cerca se queda cuando no está peleando.

advanced.health

ClavePor defectoQué hace
max20.0Vida máxima, en medios corazones.
invinciblefalseNunca muere. Útil para practicar combos.
totems-1Tótems de repuesto con los que se rearma el bot después de consumir uno, por vida. Los saca como un jugador: de uno en uno, con un tiempo para llevarse el siguiente a la mano. 0 significa que el de su kit es el único que tiene, y -1 que nunca se le acaban.
instant-totemsfalseUn tótem consumido vuelve a su mano en el siguiente tick en vez de tras la pausa habitual. Para un maniquí de entrenamiento al que solo quieres practicar golpes. Cada jugador tiene su propio interruptor en Ajuste fino.

advanced.defense

ClavePor defectoQué hace
shieldtrueSi un bot nuevo lleva escudo cuando el kit de su modo tiene uno, y lo que devuelve Reset settings. false deja esa mano vacía. Un jugador puede seguir dándole un escudo a su propio bot desde /bot, y el kit de una partida siempre decide por sí mismo.
shield-disable-seconds5.0Cuánto mantiene un hachazo el escudo del bot abajo.
anti-knockbackfalseIgnorar el empuje por completo. Apagado por defecto: el empuje es la mitad del PvP.
slow-fallingfalseCaída Lenta permanente.

advanced.pot-pvp

ClavePor defectoQué hace
apple-percent35.0Porcentaje de vida al que empieza a buscar un momento seguro para comer. Una manzana son treinta y dos ticks quieto, así que mantén esto bajo: es la cura de último recurso, no con la que se juega el combate.
potion-percent70.0Porcentaje de vida al que lanza Curación Instantánea II de inmediato. Es la cura de primera línea del bot y debería quedar bastante por encima de apple-percent — una arrojadiza le cuesta un tick y ningún terreno.
enchanted-applesfalseComer manzanas doradas encantadas en lugar de normales. Se ignora cuando otro plugin le envió un kit al bot: come la manzana que haya en él.

advanced.crystal-pvp

ClavePor defectoQué hace
range5.0Bloques respecto al rival dentro de los cuales empieza una cadena de cristales.
self-preservation-percent30.0Por debajo de esta vida deja de poner cristales pegados a sí mismo.
anchortrueUsar también anclas de resurrección cargadas.
traptrueEncerrar a un rival bajo de vida antes de detonar.
ender-pearlstruePerlar a los pies del rival para cerrar la distancia. El crystal PvP es un formato agresivo: el bot persigue, no kitea.
break-blockstrueCrystal PvP de verdad: las explosiones destruyen el terreno y la obsidiana que pone el bot se queda donde la puso. Apaga esto en un mundo que te importe — el bot recogerá lo suyo. Se aplica también al /bot propio de un jugador; un plugin que genera un bot de partida puede fijar su propio valor.

advanced.mace-pvp

Solo MACE_PVP. Casi todo importa solo a un bot que lleva los objetos: el attribute swap necesita una espada o un hacha junto a la maza, el despegue con cohete necesita élitros y cohetes, y elegir entre Density y Breach necesita más de una maza. Un /bot normal lleva solo una maza, así que esas claves cobran vida con un kit — uno que envía otro plugin, o uno de practice-kits.

ClavePor defectoQué hace
attribute-swaptrueCuando el kit lleva una espada o un hacha junto a su maza, pelea en el suelo con esa arma y se pone la maza en la mano solo en el tick del smash: el golpe conserva la barra de ataque y el daño del arma más rápida y suma el smash encima. Con qué frecuencia lo clava limpio depende de la dificultad.
use-elytratrueCuando el kit tiene élitros y cohetes de fuegos artificiales, a veces sube con un cohete: élitros puestos, impulso hacia arriba y la pechera de vuelta antes del smash.
prefer-density-height4.0Con más de una maza, una caída de al menos estos bloques usa la maza con Density; cualquier caída más corta, la de Breach.
breach-armor-threshold30.0Armadura más dureza de armadura del objetivo a partir de la cual se usa la maza con Breach sea cual sea la altura. 32 es netherite completa, 28 diamante completo.
shield-break-before-smashtrueQuita con un hacha el escudo levantado del objetivo antes de subir. Solo con un hacha en el kit, o siempre para un bot sin kit.
launch-range5.5Bloques hasta el objetivo dentro de los cuales despega. Más lejos, el objetivo simplemente se aparta de debajo de la caída.
wind-charge-cooldown-ticks38Ticks entre despegues de cualquier tipo.
pearl-lift-cooldown-ticks110Ticks entre subidas con perla, que llegan mucho más alto que una carga de viento.
rocket-lift-cooldown-ticks90Ticks entre subidas con cohete.
wind-charge-lift-min / wind-charge-lift-max0.92 / 1.14Velocidad hacia arriba que da una carga de viento, elegida entre los dos en cada despegue para que no haya dos caídas que peguen lo mismo.
rocket-lift1.5Velocidad hacia arriba que da una subida con cohete.

advanced.uhc

ClavePor defectoQué hace
apple-percent60.0Porcentaje de vida al que se come una manzana dorada. UHC no tiene pociones arrojadizas, así que la manzana es la única cura que hay y esto queda mucho más alto que el equivalente de pot PvP.
cobwebtrueAtrapar al rival en una telaraña para dejarlo quieto y encadenar un combo.
lavatrueSoltar lava a los pies del rival. Se coloca sin actualización de bloque, así que la fuente nunca fluye, y se recoge con un temporizador.
watertrueLlevar un cubo de agua, para apagarse y para limpiar la lava.

advanced.pathfinding

Búsqueda local en rejilla que se usa solo cuando la dirección directa no consigue pasar el terreno. En campo abierto el bot camina recto hacia su objetivo y nada de esto se ejecuta.

ClavePor defectoQué hace
enabledtrueApaga la búsqueda por completo; el bot entonces solo apunta recto a su objetivo.
max-search-radius-horizontal16Bloques desde el bot que puede expandir la búsqueda, y la distancia a partir de la cual ni siquiera busca.
max-search-radius-vertical10El mismo techo y suelo, en vertical.
max-expanded-nodes200Nodos que puede expandir una búsqueda antes de rendirse.
max-search-time-micros1500Microsegundos que puede durar una búsqueda antes de rendirse. Es la clave que mantiene a los bots de un servidor lleno fuera del tick.
max-drop-height-safe3Bloques que el bot se dejará caer en una ruta.
max-drop-height-protected10Lo mismo, para un bot que sobreviviría a la caída — uno con Caída Lenta o invencibilidad.
max-gap-jump-columns1Cuántas columnas vacías de ancho puede tener un hueco para que la ruta lo salte.
stuck-check-interval-ticks10Ticks entre dos comprobaciones de avance.
stuck-progress-epsilon0.5Bloques que tiene que haberse movido en horizontal en ese intervalo para contar como avance.
stuck-strikes-threshold2Comprobaciones fallidas seguidas antes de contar como atascado y pedir una ruta.
path-stale-distance5.0Bloques que el objetivo puede alejarse de donde se construyó la ruta antes de tirarla.
path-max-age-ticks60Ticks que se conserva una ruta pase lo que pase.
checkpoint-reached-radius0.6Distancia horizontal a la que un punto de control cuenta como alcanzado.
consecutive-failed-searches-before-cooldown3Búsquedas fallidas seguidas antes de dejar de intentarlo.
give-up-cooldown-ticks60Ticks que espera antes de volver a intentarlo.

advanced.practice-kits#

Vacío por defecto. Viste el /bot propio de un jugador con un kit de ExyliaPracticeCore en lugar del equipo integrado del modo: nombre de modo a id de kit.

plugins/ExyliaPracticeBotV3/config.yml
yaml
advanced:
  practice-kits:
    MACE_PVP: mace
    CRYSTAL_PVP: crystal

El bot pelea entonces con los objetos, la armadura y los consumibles de ese kit, y los gasta como un bot de partida: lo que lleva se acaba. Se aplica sobre los ajustes del jugador cada vez que el bot aparece o cambia un ajuste, así que elegir en el menú un modo mapeado viste al bot con ese kit; los ajustes guardados del jugador y su propio inventario no se tocan nunca. Un modo que no está en la lista, un id de kit desconocido o un servidor sin PracticeCore mantienen el equipo integrado, y la consola nombra cada kit que no encontró una vez arrancado el servidor.

Límites y tope de bots (limits, max-bots, reserved-for-matches)

limits#

Los límites a los que el menú del juego recorta sus deslizadores. Cada par es el suelo y el techo de un campo de adjust, y un valor fuera de ellos no se puede alcanzar desde un menú.

CampoPar de clavesRango por defecto
attack_speedmin-attack-speed / max-attack-speed0.25 – 4.0
movement_speedmin-movement-speed / max-movement-speed0.25 – 3.0
attack_reachmin-attack-reach / max-attack-reach1.0 – 6.0
follow_distancemin-follow-distance / max-follow-distance1.0 – 12.0
attack_damagemin-attack-damage / max-attack-damage0.5 – 40.0
max_healthmin-max-health / max-max-health1.0 – 40.0
shield_disablemin-shield-disable / max-shield-disable0.0 – 20.0
totemsmin-totems / max-totems−1.0 – 16.0

Los tótems se detienen en -1, que es el ajuste ilimitado. Cada valor ajustado se redondea a un decimal después del recorte. Ver Límites.

max-bots#

16 por defecto. Cuántos bots pueden existir a la vez en el servidor. Cada bot piensa una vez por tick y busca su propia ruta, así que este es un techo real y no una formalidad — súbelo solo después de mirar el tiempo de tick con el actual lleno. Una invocación por encima del techo se rechaza con el mensaje limit-reached, y la API la rechaza con una BotLimitReachedException. Un valor por debajo de 1 se lee como 1.

reserved-for-matches#

4 por defecto. De los huecos de max-bots, cuántos no puede ocupar nunca el /bot propio de un jugador, para que una partida que necesite un bot siga encontrando un hueco libre. Los jugadores pueden llenar max-bots menos esto (al menos uno); los bots que generan otros plugins, y los jugadores con exyliapracticebot.bypass.limit, pueden usar el techo entero. Ver Límites.

messages.yml#

lang/<code>/messages.yml. Cada línea que ve un jugador, con la misma cabecera config-version. Los placeholders de color vienen de la paleta de ExyliaLib, así que recolorear la red nunca significa editar este archivo. Una línea puede abrir con una etiqueta de efecto que nunca llega a la pantalla — [sound:NOMBRE|volumen|tono] y [particle:NOMBRE|cantidad] — y los valores por defecto las usan por todas partes.

SecciónContiene
prefix{primary}&lPRACTICE BOT {letters_black}•<reset> por defecto. El %prefix% de cada línea se expande a esto.
botLas líneas que dice el plugin: spawned, removed, no-bot, already-has-bot, world-not-allowed, removed-death, removed-world-change, removed-too-far, teleported-to-bot, teleported-bot-to-you, respawning, respawned, settings-reset, reset-confirm (la pregunta que hace el botón de reinicio del menú), mode-changed (%mode%), difficulty-changed (%difficulty%), limit-reached (%limit%), boxing-score (%player_hits%, %bot_hits%, mostrada en la action bar durante una ronda de boxeo), bot-out-of-sight, stun-slam (%time% en milisegundos y %count% en esta sesión; ver Comportamiento) y no-permission (un jugador sin el nodo de esa función); más name, el nombre sobre el bot (%player% es su dueño).
placeholdersLas etiquetas que imprimen los menús: enabled, disabled, unlimited, y un bloque para cada uno de armor, enchant, main-hand, off-hand, knockback, strength, speed, mode y difficulty.

Los bloques mode y difficulty guardan dos cosas por valor: el nombre, y la línea de resumen que el menú muestra debajo — pot-pvp y pot-pvp-summary, hard y hard-summary. Esos resúmenes son lo que imprimen %mode_summary% y %difficulty_summary%, que es cómo un botón que cicla puede explicarse sin cuatro botones describiéndose cada uno a sí mismo.

Renombrar o recolorear cualquier cosa de aquí cambia solo lo que leen los jugadores. Los valores que guarda el plugin son los nombres de enum de Equipamiento, Modos y Dificultad, y no se ven afectados.

database.yml#

Lo escribe ExyliaLib la primera vez que arranca el plugin: H2 por defecto, con MySQL, MariaDB, PostgreSQL y MongoDB como alternativas. Una fila por jugador, con cada ajuste de la mitad por jugador de esta página. Ver la página de base de datos de la librería.

¿Falta algo en esta página? Dínoslo en Discord