Instalar ExyliaClans
Qué poner en el servidor, qué revisar en el primer arranque y qué archivos y tablas se crean.
En unos diez minutos pasas del jar a un servidor donde los jugadores pueden crear clanes, llenar un banco y reclamar terreno.
Antes de empezar#
- Paper 1.21.1 o superior (Folia 1.21.4 o superior) con Java 21, y ExyliaLib instalado.
- Un plugin de economía si los clanes deben pagar por el terreno. WorldGuard es opcional: sin él, usa la protección integrada.
Pasos#
Suelta los jars
ExyliaClans.jar, más ExyliaLib, en plugins/ (añade packetevents para los extras con paquetes; es opcional).
Añade un plugin de economía
El banco paga los terrenos y se lee a través del puente de economía de ExyliaLib, en la moneda que
indica bank-currency (vacío es la moneda por defecto). Sin uno, /clan deposit y /clan withdraw
se niegan y no se puede comprar ningún terreno. ExyliaEconomy es una dependencia suave, así que sus
monedas están listas antes de que se active ExyliaClans.
Decide quién protege el terreno
claims.protection-mode viene como WORLDGUARD. Si WorldGuard no está instalado, ponlo en BUILTIN
antes de que nadie reclame nada — ver Terrenos.
Arranca el servidor
Escribe seis archivos de configuración y sesenta y cinco menús, y crea diecinueve tablas. Los menús y
los mensajes vienen en inglés, español, portugués, francés, ruso y turco; language: default sigue al de ExyliaLib.
Revisa los permisos
Todos los nodos de /clan vienen en true, así que los jugadores pueden usar el plugin desde el
primer momento y su rango en el clan decide el resto. /clanadmin viene para operadores. Ver
Permisos.
Comprueba que funciona#
Ejecuta /clan create Prueba en el juego. Deberías obtener un clan y /clan abre el menú del clan. Después sigue Tu primer clan.
Archivos#
Archivos de configuración e idioma
| Archivo | Contenido |
|---|---|
config.yml | language, límites, warmups, los trece interruptores de módulo, terrenos, DTR, niveles, bossbars, webhooks y default-roles. |
wars.yml | Guerras de clanes: tamaños de equipo, tiempos y los comandos permitidos en una guerra. |
lang/<idioma>/messages.yml | Cada línea que envía el plugin, en diecisiete secciones. |
lang/<idioma>/webhooks.yml | Lo que publica el webhook de Discord de un clan, evento por evento, y las líneas del juego que lo acompañan. |
lang/<idioma>/lfc.yml | Looking for clan: cooldowns, caducidad y las preguntas que responde un jugador. |
lang/<idioma>/lfp.yml | Looking for players: cooldowns, caducidad, límites de texto, límites de solicitudes y lo que puede pedir un clan. |
lang/<idioma>/menus/*.yml | Sesenta y cinco pantallas, las veintidós de /clanadmin en menus/admin/. |
database.yml | Lo escribe ExyliaLib. H2 por defecto; los otros motores son MySQL, MariaDB, PostgreSQL y MongoDB, con un bloque redis al lado que une varios servidores. |
<idioma> es lo que resuelve language en config.yml — ver
Configuración.
config.yml, wars.yml, messages.yml, webhooks.yml, lfc.yml y lfp.yml se escriben desde records tipados en el primer
arranque, comentarios incluidos. Una clave que el lector no reconoce se poda — salvo dentro de
default-roles, levels.level-definitions, levels.kill-streak-bonuses y los dos bloques categories,
que son tuyos y no se tocan nunca.
Tablas#
Tablas de la base de datos
| Tabla | Guarda |
|---|---|
clans | Una fila por clan: nombre, líder, saldo, abierto, friendly fire, home, baneados, DTR, EXP. |
clan_members | Una fila por jugador. La clave es su UUID, así que un jugador está en un clan por construcción. |
clan_roles | Cada rango de cada clan, con su peso y sus permisos separados por comas. |
clan_relations | Direccional. Dos filas hacen una alianza mutua; una fila hace una rivalidad. |
clan_invites | Invitaciones vigentes, con clave playerUuid:clanId, y cuándo se enviaron. |
clan_alliance_requests | Peticiones de alianza pendientes, con clave requestingClanId:targetClanId. |
clan_claims | Un rectángulo por clan: mundo, minX, minZ, maxX, maxZ y la altura a la que se hizo. |
clan_stats | Bajas, muertes y tiempo jugado por clan. |
clan_player_stats | Lo mismo por jugador y por clan, con clave playerUuid:clanId. Antes player_stats; la tabla vieja se lee y se renombra en el primer arranque. |
clan_logs | El registro de auditoría, indexado por clan y fecha descendente. |
clan_mails | El buzón, con leído/borrado por miembro como listas de UUID. |
clan_webhooks | Un webhook de Discord por clan, aparte de clans porque su URL es secreta. |
lfc_profiles | Una fila por jugador que se anuncia. |
lfp_postings | Una fila por clan que busca miembros. |
lfp_applications | Solicitudes, con clave playerUuid:clanId. |
Integraciones opcionales#
Plugins opcionales y qué cambian
| Plugin | Qué cambia |
|---|---|
PlaceholderAPI | Registra la expansión exyliaclans, relacionales incluidos. |
WorldGuard | Pasa a proteger los terrenos con protection-mode: WORLDGUARD, y bloquea reclamar sobre una región existente. |
TAB | Su gestión de equipos se pausa para un jugador mientras este plugin lo colorea, y se reanuda al salir del clan. |
| Economía | El banco, en la moneda que indica bank-currency. ExyliaEconomy es dependencia suave para que cargue antes. |
Apollo / FeatherServerAPI | Waypoints de cliente para el home del clan y para los marcadores de camp y rally. |
| Cliente SurvivalCore | Se lee a través de ExyliaLib, no hay nada que instalar en el servidor: un rally nativo, iconos de home y camp en el mapa, pestañas Clan y Allies en el chat, paneles de equipo con el nombre del clan y los rangos, y dos teclas. |
| Redis | Se pone en database.yml en cada servidor que comparte la base de datos, y los servidores funcionan como un solo sistema de clanes. Ver Base de datos. |
El primer arranque#
Lee la consola. Tres cosas se avisan ahí y en ningún otro sitio:
- Problemas de configuración. Una clave que no se pudo leer se nombra, una vez, con qué tenía mal.
default-roles is empty. Si vaciaste ese bloque,/clan createse niega en vez de crear un clan cuyo líder no tiene rango. No se reescribe nada en el archivo.- Backfill de DTR. En el primer arranque tras activar el módulo DTR, cada clan que esté a
0.0recibe su máximo, y se registra el número.
Actualizar#
Sustituye el jar y reinicia. /clanadmin reload vuelve a leer los seis archivos de configuración,
reconstruye la tabla de niveles, arranca o para módulos y recompila todos los menús. /exylialib reload
también recompila los menús, así que un cambio de paleta hecho desde la librería se ve sin reiniciar.
Una clave nueva que una versión añade a un menú llega a tu archivo al momento; un valor por defecto que
cambia espera en /exylialib updates a que lo apliques o te quedes con el tuyo; lo que cambiaste tú no
se toca nunca. Ver Menús.
El primer arranque de 1.2.0 mueve tus messages.yml, lfc.yml, lfp.yml y menus/ editados a
lang/custom/ y pone language: custom, mueve a messages.yml el texto que antes estaba en
config.yml, y da FOCUS, CAMP y RALLY a todos los rangos existentes. No hay nada que hacer a mano.
Cambiar default-roles solo afecta a los clanes creados después. Los que ya existen conservan los rangos
con los que se crearon, porque son filas de clan_roles que el clan ya ha editado.
¿Falta algo en esta página? Dínoslo en Discord