Contenido generado con IA — puede contener errores.

ExyliaPracticeBot/EmpezarActualizada en v1.5.0

Instalación

Dependencias, primer arranque, los archivos que genera el plugin y la única clave que hay que tocar.

Página 2 de 216 min de lectura

Al terminar esta página, ExyliaPracticeBot funciona con un mundo permitido, listo para tu primer bot. Instalar lleva un jar, un reinicio y una línea en config.yml.

Antes de empezar#

El servidor tiene que ser Paper o Folia 1.21.9 o superior — más nuevo que el resto de la suite de Exylia, porque cada bot es un maniquí, una entidad que aparece por primera vez en 1.21.9. Un servidor más antiguo se niega a cargar el jar. Ver Compatibilidad.

ExyliaPracticeBot necesita ExyliaLib en plugins/ antes del primer arranque; PacketEvents es opcional.

PluginPara qué
packeteventsOpcional, declarado en softdepend. Sin él el plugin funciona y solo se apagan los extras de ExyliaLib que se dibujan con paquetes.
ExyliaLibDeclarado en softdepend. Configuración, menús, acciones de menú, base de datos, tareas, texto y efectos. El plugin no funciona sin ella.
Por qué ExyliaLib es blanda

depend y softdepend son reglas de orden de carga, no una declaración de cuánto se necesita cada una. ExyliaLib está en softdepend a propósito, y es la que el plugin realmente no puede dejar de tener: el loader que instala ExyliaLib es justo lo que tiene que cargar para que esa instalación ocurra, y un depend duro impediría que el plugin cargara antes de que la librería pudiera llegar. Aquí "soft" significa "cárgame después de ella", no "opcional".

El único plugin opcional es ExyliaPracticeCore, y solo si quieres que el /bot de un jugador se vista con sus kits (advanced.practice-kits). El plugin no registra ningún placeholder de PlaceholderAPI, así que PlaceholderAPI no te aporta nada aquí.

Instalar#

Coloca el jar

Copia ExyliaPracticeBotV3.jar en la carpeta plugins/ del servidor, junto a ExyliaLib (y packetevents, opcional).

Arranca el servidor

En el primer arranque se escriben config.yml, messages.yml, los dos archivos de menú y la tabla de la base de datos.

Revisa la consola

Buscas ExyliaPracticeBotV3 enabled!. Si esa línea no aparece nunca, falta ExyliaLib o el servidor es anterior a 1.21.9 — son las dos cosas que impiden que el plugin cargue de entrada.

Permite un mundo

Abre config.yml y pon tu mundo en la lista worlds. Hasta que lo hagas, /bot spawn se rechaza en todas partes. Este es el paso que la gente se salta; ver más abajo.

Genera uno

/bot abre el menú. Todos los nodos de jugador valen true por defecto, así que no hay que conceder nada; ver Permisos para convertir funciones en ventajas de rango, y Primeros pasos.

Comprueba que funciona#

La consola muestra ExyliaPracticeBotV3 enabled!. En el juego, /bot abre el menú y Generar bot pone un bot a tu lado. Si responde "No puedes generar un bot en este mundo", el mundo todavía no está en worlds; mira más abajo.

Dónde se pueden generar bots#

La clave worlds, en el nivel superior de config.yml, es la lista blanca de mundos en los que un bot puede existir. Se comprueba en tres sitios —/bot spawn, el botón Generar bot del menú y el respawn automático—, así que no hay forma de rodearla.

plugins/ExyliaPracticeBotV3/config.yml
yaml
# Worlds where a bot may be spawned. Empty means nowhere.
worlds:
  - exylia_sandbox_badlands
  - exylia_sandbox_desert
  - exylia_sandbox_mushroom
  - exylia_sandbox_plains
  - exylia_sandbox_snowy
La lista por defecto no coincidirá con tu servidor

El archivo viene con cinco mundos exylia_sandbox_*, que son los de Exylia. En cualquier otro servidor ninguno de esos mundos existe, así que el efecto práctico en una instalación nueva es el mismo que una lista vacía: ningún mundo está permitido y todo intento de generar un bot se rechaza con "No puedes generar un bot en este mundo" hasta que sustituyas la lista por los nombres de tus mundos. Una lista vacía no permite nada — no es un comodín.

Los nombres de mundo se comparan exactamente como los reporta world.getName(): el nombre de la carpeta, no un nombre visible. Después de editar, /botadmin reload relee el archivo sin reiniciar.

Archivos generados#

Todos los archivos de plugins/ExyliaPracticeBotV3/
ArchivoContenido
config.ymllanguage, bot.mode y bot.difficulty, la lista blanca de mundos, respawn, interacción, todo lo que hay bajo advanced (el ajuste de cada modo y practice-kits), los limits de los sliders, max-bots y reserved-for-matches. También editable en el juego con /botadmin settings.
lang/<code>/messages.ymlCada línea que ve el jugador, el nombre sobre el bot, más las etiquetas de modos, dificultades, armadura, encantamientos, manos, retroceso, fuerza y velocidad.
lang/<code>/menus/user/main.ymlLa pantalla principal: modo, dificultad, armadura, manos, pociones, los interruptores, generar, eliminar y restablecer.
lang/<code>/menus/user/advanced.ymlLa pantalla de ajuste fino: daño, alcance, velocidades, vida, tótems y los interruptores de sandbox.
database.ymlMotor de base de datos, escrito por ExyliaLib. H2 por defecto, embebido, nada que instalar.
dumps/La crea /botadmin export, y la lee /botadmin import <archivo>.

<code> es el idioma que fija language en config.yml: el plugin trae inglés, español, portugués, francés, ruso y turco. Un archivo de menú que falta se vuelve a escribir y un botón nuevo llega con la actualización; un valor por defecto cambiado espera en /exylialib updates en lugar de pisar tus ediciones. Cómo editar menús está en Editar menús.

Folia#

plugin.yml declara folia-supported: true, y el plugin está escrito para ello: cada bot tickea en el hilo dueño de su propia región, la aparición ocurre en el hilo dueño del destino, y cada bot mantiene un ticket de chunk sobre el chunk en el que está para seguir pensando aunque no haya nadie cerca. No hay nada extra que configurar.

Base de datos#

Por defecto el plugin usa H2: un archivo dentro de la carpeta del plugin, sin servidor, sin instalación y sin mantenimiento. Guarda una fila por jugador en practicebot_players con los ajustes de su bot.

Para compartir los ajustes entre servidores, edita database.yml:

plugins/ExyliaPracticeBotV3/database.yml
yaml
database:
  type: mysql
  settings:
    pool-size: 0
  mysql:
    host: 127.0.0.1
    port: 3306
    database: minecraft
    username: root
    password: ""

Motores soportados: h2, mysql, mariadb, postgresql y mongodb. Solo se lee el bloque que coincide con type. El archivo es de ExyliaLib; su referencia completa está en la página de base de datos de la librería.

Para borrarla, usa ExyliaLib: /exylialib wipe ExyliaPracticeBotV3 <table|*> para la tabla y /exylialib resetplayer <player> para un jugador. Ver los comandos de ExyliaLib.

Nada espera a la base de datos mientras el plugin se activa. La fila de un jugador se lee cuando entra y se escribe en el momento en que cambia un ajuste.

Actualizar#

Sustituye el jar y reinicia. Tus ediciones en config.yml, messages.yml y los dos archivos de menú se conservan, y los ajustes de los jugadores viven en la base de datos. Una configuración escrita por una versión anterior se migra en el sitio al arrancar — la antigua clave restrictions.allowed-worlds, por ejemplo, se mueve a worlds en vez de perderse.

Los bots en sí nunca sobreviven a un reinicio: son objetos de sesión, y todos se retiran al apagar.

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