Instalación
Dependencias, primer arranque, los archivos que genera el plugin y la única clave que hay que tocar.
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.
| Plugin | Para qué |
|---|---|
packetevents | Opcional, declarado en softdepend. Sin él el plugin funciona y solo se apagan los extras de ExyliaLib que se dibujan con paquetes. |
ExyliaLib | Declarado en softdepend. Configuración, menús, acciones de menú, base de datos, tareas, texto y efectos. El plugin no funciona sin ella. |
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.
# 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_snowyEl 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/
| Archivo | Contenido |
|---|---|
config.yml | language, 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.yml | Cada 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.yml | La pantalla principal: modo, dificultad, armadura, manos, pociones, los interruptores, generar, eliminar y restablecer. |
lang/<code>/menus/user/advanced.yml | La pantalla de ajuste fino: daño, alcance, velocidades, vida, tótems y los interruptores de sandbox. |
database.yml | Motor 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:
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