Instalar ExyliaSandBox
Instala el plugin y sus dependencias, supera el reinicio que provoca el primer arranque, fija el lobby y localiza los archivos que crea.
Al final de esta página ExyliaSandBox está funcionando, tus cinco mundos por defecto están generados y el lobby está fijado. Cuenta con dos arranques del servidor: el primero genera los mundos y después detiene el servidor a propósito.
Antes de empezar#
Necesitas un servidor Paper, Spigot o Folia con Minecraft 1.21.4 o superior, y estos plugins:
| Plugin | Necesario | Para qué |
|---|---|---|
Chunky | Sí | Pregenerar cada mundo hasta su borde antes de dejar entrar a nadie. El servidor se niega a cargar ExyliaSandBox sin él. |
ExyliaLib | Sí | Menús, configuración, base de datos, placeholders, hologramas, barras laterales, regiones, copias de inventario y asistentes. |
PlaceholderAPI | No | Usar los placeholders del plugin en otros plugins. |
ExyliaPracticeCore | No | Que un kit predefinido use los kits de PracticeCore. Mira el aviso de abajo. |
Worlds | Solo en Folia | Folia no puede crear un mundo de la forma habitual; ExyliaLib pasa por Worlds. Sin él, un mundo en Folia se queda en UNAVAILABLE. |
packetevents | No | Sin él solo se apagan los extras dibujados con paquetes. |
| LuckPerms u otro plugin de permisos | No | Dar más ranuras de kit a los rangos con exyliasandbox.max_kits.<n>. |
Con ExyliaPracticeCore instalado, ExyliaSandBox nunca guarda ni restaura el inventario del jugador al entrar, salir, morir o conectarse: el lobby de práctica lo viste. El plugin se detecta solo por su nombre. Decídelo antes de abrir el servidor; instalarlo a mitad es lo que deja a un jugador con un kit de sandbox en el lobby.
Pasos#
Pon los jars
Copia ExyliaSandBox.jar, ExyliaLib.jar y Chunky.jar en plugins/.
Arranca el servidor y deja que se pare
El primer arranque escribe config.yml, las carpetas de idiomas y las tablas de la base de datos, crea cinco mundos y cinco categorías de la sala de kits, y después pregenera todos los mundos con Chunky. Cuando termina el último, el plugin apaga el servidor. Vuelve a arrancarlo y los mundos estarán listos.
Fija el lobby
Ejecuta /sandboxadmin, pulsa Fijar lobby, camina hasta donde deban llegar los jugadores y haz clic agachado. Ahí vuelven todos al morir, salir o desconectarse. Nada funciona bien hasta que lo fijas.
Fija la sala del creador de kits
En /sandboxadmin, pulsa Fijar creador y haz lo mismo en la sala donde los jugadores montarán sus kits.
No ocurre solo en el primer arranque. Siempre que la cola de pregeneración se vacía, también al crear un mundo desde el panel en un servidor en marcha, el plugin detiene el servidor y registra All worlds pregenerated. Restarting server.... Crea los mundos en una ventana de mantenimiento, o ejecuta el servidor bajo un gestor de procesos que lo vuelva a levantar.
Comprueba que funciona#
Tras el segundo arranque, ejecuta /sandboxadmin y pulsa Mundos: desert, plains, snowy, mushroom y badlands aparecen listados y listos. Después ejecuta /rtp como jugador: deberías aparecer en un mundo sandbox. Si no fijaste el lobby, te lo dice. Siguiente: Tu primer sandbox.
Ir más lejos#
Usar una base de datos compartida#
Por defecto el plugin usa H2: un archivo en la carpeta del plugin, sin servidor que mantener. Para compartir mundos, kits y estadísticas entre servidores, apunta todos al mismo servidor de base de datos en plugins/ExyliaSandBox/database.yml:
database:
type: mysql
mysql:
host: 127.0.0.1
port: 3306
database: minecraft
username: root
password: ""Los motores admitidos son h2, mysql, mariadb, postgresql y mongodb. El archivo es de ExyliaLib; mira su página de base de datos. Las columnas de las tablas están en la página Base de datos.
Cambiar el idioma#
language en config.yml elige entre en, es, pt, fr, ru o tr. Mira Configuración y, para colores y mensajes, Mensajes e idiomas.
Actualizar el plugin#
Sustituye el jar y reinicia. Tus cambios en config.yml, messages.yml, scoreboards.yml y menus/user/ se conservan; menus/admin/ se refresca desde el jar. Un servidor que viene de 1.0.x ve sus archivos adoptados en lang/custom/ en el primer arranque. Mundos, kits y estadísticas viven en la base de datos y una actualización nunca los toca.
Para releer los archivos de configuración y recompilar los menús sin reiniciar, ejecuta /sandboxadmin reload desde la consola, o pulsa Recargar en el panel de administración.
Archivos generados
Todos viven en plugins/ExyliaSandBox/.
| Archivo | Contenido |
|---|---|
config.yml | Idioma, números de RTP y de la cola, tiempo límite del TPA, espera del rekit, holograma de las plataformas, lista de comandos permitidos. |
lang/<idioma>/messages.yml | Cada línea que envía el plugin, las barras de la cola y los efectos de las plataformas, y cada etiqueta de pantalla. |
lang/<idioma>/scoreboards.yml | La única barra lateral, que ve quien esté en un mundo sandbox. |
lang/<idioma>/menus/user/ | Las seis pantallas del jugador. Son tuyas para editar; una versión añade lo que falte y nunca pisa tus cambios. Un valor por defecto cambiado espera en /exylialib updates. |
lang/<idioma>/menus/admin/ | Las catorce pantallas de admin. Se reescriben desde el jar en cada arranque, así que un botón añadido en una versión llega a los servidores existentes; cada archivo lleva un aviso que lo dice. |
database.yml | Motor de base de datos y Redis, escrito por ExyliaLib. |
No hay ningún config.yml dentro del jar: el archivo se genera a partir del esquema del plugin en la primera ejecución, con sus comentarios. Por eso una clave desconocida se avisa una vez y luego se elimina.
Las ocho tablas, todas con el prefijo sandbox_: sandbox_worlds, sandbox_player_kits, sandbox_predefined_kits, sandbox_kitroom_categories, sandbox_kitroom_items, sandbox_player_stats, sandbox_settings y sandbox_tp_regions.
plugin.yml también nombra ViaVersion, Multiverse-Core, PhantomWorlds, ExyliaEvents y ExyliaFFA, pero este plugin nunca los lee. ExyliaLib figura solo como dependencia blanda para que pueda cargar antes el cargador que lo instala; el plugin no funciona sin él.
¿Falta algo en esta página? Dínoslo en Discord