Instalación
El jar del cargador y la licencia, las dependencias, los archivos que escribe el plugin, la base de datos y cómo actualizar.
Conseguir el plugin
ExyliaTabletop es un plugin premium, a la venta en
BuiltByBit. Se distribuye con
el cargador de Lukittu, así que el archivo que instalas es el jar del cargador,
Exylia-Tabletop-Loader.jar. Comprado en BuiltByBit, la licencia va incluida en ese jar: no hay clave que
poner. El cargador comprueba la licencia en cada arranque y después le pasa el control al plugin.
Antes de empezar
| Plugin | Para qué |
|---|---|
packetevents | Obligatorio. Está en depend, así que sin él el servidor no carga ExyliaTabletop en absoluto. Cada tablero, la sala alrededor del jugador y mantenerlo dentro de ella se dibujan con paquetes. |
ExyliaLib | Obligatoria, versión 1.376.0 o superior. Configuración, menús y diálogos, el lobby, el depósito, la economía, la base de datos, el escenario, los paneles laterales, las mesas en el mundo y sus sillas, los anuncios y el catálogo de juegos. |
| Una economía | ExyliaEconomy, Vault con un plugin de economía, o PlayerPoints. Sin una no hay moneda con la que jugar, y cada juego responde "No hay ninguna moneda con la que puedas jugar." |
El plugin.yml del cargador pone ExyliaLib en softdepend a propósito: el cargador es quien la instala, así
que tiene que poder arrancar sin ella. En un servidor sin ExyliaLib descarga la última versión en
plugins/ y pide reiniciar. En un servidor con una versión más antigua prepara la última y lo dice en la
consola; reinicia una vez más para aplicarla.
Plugins opcionales
| Plugin | Qué añade |
|---|---|
PlaceholderAPI | Los placeholders del plugin en otros plugins: scoreboards, tab, hologramas. Consulta Placeholders. |
Instalar
Copia los jars
Exylia-Tabletop-Loader.jar y packetevents en plugins/, y una economía si el servidor no tiene.
Arranca el servidor
El cargador escribe loader.yml, comprueba la licencia e instala ExyliaLib si falta. Si tuvo que
instalarla, reinicia una vez más.
Deja que genere
El plugin escribe config.yml, un modules/<game>/config.yml por juego, sus mensajes y menús, y crea su
tabla. La consola termina con ExyliaTabletop enabled.
Juega
Cualquier jugador ya puede abrir el lobby de un juego, abrir una mesa e invitar a otros:
exyliatabletop.play, exyliatabletop.create y exyliatabletop.duel están activados para todos por
defecto. Consulta Jugar una partida.
Archivos generados
Todos están en plugins/ExyliaTabletop/.
| Archivo | Contenido |
|---|---|
loader.yml | Lo escribe el cargador. Una compra en BuiltByBit no necesita nada aquí: la licencia está en el jar. |
config.yml | Lo que comparten todos los juegos: idioma, importes, monedas y la comisión del servidor, tiempos de espera, lo que pueden hacer los jugadores mientras juegan, el aspecto de los tableros, la sala y los nombres de los comandos. Consulta Configuración. |
modules/<game>/config.yml | Uno por juego: si está activado, su nombre, icono, comandos, reglas, tiempos, aspecto y sonidos. Consulta Juegos. |
tables.yml | Las mesas colocadas en el mundo con /tabletopadmin table: el juego de cada una, dónde está y sus asientos. Lo escribe el plugin; una mesa en un mundo que no está cargado se conserva y se muestra cuando lo está. |
database.yml | Dónde se guardan las filas. Lo escribe ExyliaLib. |
lang/<language>/messages.yml | Las líneas compartidas: importes, mesas e invitaciones, la partida, los resultados, las tarjetas del catálogo de juegos, las líneas de administración y las etiquetas que muestran los menús. |
lang/<language>/modules/<game>/messages.yml | Los textos propios de cada juego: botones, encabezados y sus líneas durante la partida. Tic-Tac-Toe no tiene; usa solo las líneas compartidas. |
lang/<language>/menus/user/lobby.yml | El lobby que abre cada juego. Puedes reestilizarlo: una versión nueva solo añade lo que falta. |
lang/<language>/menus/admin/ | Las pantallas de administración hub, matches y match. Se reescriben desde el jar en cada arranque. |
La base de datos
El historial de cada jugador por juego — victorias, derrotas y empates — es una fila de tabletop_stats en
la base de datos a la que apunta database.yml: H2 en un archivo por defecto, o MySQL, MariaDB,
PostgreSQL o MongoDB a través de ExyliaLib. Las filas de los jugadores conectados se guardan en memoria; los
resultados se escriben como incrementos atómicos, así que varios servidores que comparten una base de datos
nunca pierden un resultado.
| Columna | Guarda |
|---|---|
id | El UUID del jugador y el id del juego, como <uuid>:<game> |
player | El UUID del jugador (indexado) |
game_id | El juego, como tictactoe |
wins, losses, draws | Los recuentos. Una pareja que gana al Truco cuenta una victoria para cada compañero. |
Los importes los retiene el depósito de ExyliaLib en la misma base de datos. Lo que un reinicio deja retenido se reembolsa en el siguiente arranque, y lo que no se puede entregar en el momento se entrega cuando el jugador vuelve a entrar. Hasta que el depósito termina con eso, las mesas están cerradas: "Las mesas están cerradas un momento. Inténtalo en breve."
Actualizar
Sustituye el jar del cargador y reinicia. Tu config.yml, los archivos de módulo, los mensajes y el menú del
lobby se conservan; las claves nuevas se añaden con sus valores por defecto.
¿Falta algo en esta página? Dínoslo en Discord