Contenido generado con IA — puede contener errores.

ExyliaClans/EmpezarActualizada en v1.4.0

Instalar ExyliaClans

Qué poner en el servidor, qué revisar en el primer arranque y qué archivos y tablas se crean.

Página 2 de 296 min de lectura

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
ArchivoContenido
config.ymllanguage, límites, warmups, los trece interruptores de módulo, terrenos, DTR, niveles, bossbars, webhooks y default-roles.
wars.ymlGuerras de clanes: tamaños de equipo, tiempos y los comandos permitidos en una guerra.
lang/<idioma>/messages.ymlCada línea que envía el plugin, en diecisiete secciones.
lang/<idioma>/webhooks.ymlLo 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.ymlLooking for clan: cooldowns, caducidad y las preguntas que responde un jugador.
lang/<idioma>/lfp.ymlLooking for players: cooldowns, caducidad, límites de texto, límites de solicitudes y lo que puede pedir un clan.
lang/<idioma>/menus/*.ymlSesenta y cinco pantallas, las veintidós de /clanadmin en menus/admin/.
database.ymlLo 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.

El YAML se genera, no se copia

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
TablaGuarda
clansUna fila por clan: nombre, líder, saldo, abierto, friendly fire, home, baneados, DTR, EXP.
clan_membersUna fila por jugador. La clave es su UUID, así que un jugador está en un clan por construcción.
clan_rolesCada rango de cada clan, con su peso y sus permisos separados por comas.
clan_relationsDireccional. Dos filas hacen una alianza mutua; una fila hace una rivalidad.
clan_invitesInvitaciones vigentes, con clave playerUuid:clanId, y cuándo se enviaron.
clan_alliance_requestsPeticiones de alianza pendientes, con clave requestingClanId:targetClanId.
clan_claimsUn rectángulo por clan: mundo, minX, minZ, maxX, maxZ y la altura a la que se hizo.
clan_statsBajas, muertes y tiempo jugado por clan.
clan_player_statsLo 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_logsEl registro de auditoría, indexado por clan y fecha descendente.
clan_mailsEl buzón, con leído/borrado por miembro como listas de UUID.
clan_webhooksUn webhook de Discord por clan, aparte de clans porque su URL es secreta.
lfc_profilesUna fila por jugador que se anuncia.
lfp_postingsUna fila por clan que busca miembros.
lfp_applicationsSolicitudes, con clave playerUuid:clanId.

Integraciones opcionales#

Plugins opcionales y qué cambian
PluginQué cambia
PlaceholderAPIRegistra la expansión exyliaclans, relacionales incluidos.
WorldGuardPasa a proteger los terrenos con protection-mode: WORLDGUARD, y bloquea reclamar sobre una región existente.
TABSu gestión de equipos se pausa para un jugador mientras este plugin lo colorea, y se reanuda al salir del clan.
EconomíaEl banco, en la moneda que indica bank-currency. ExyliaEconomy es dependencia suave para que cargue antes.
Apollo / FeatherServerAPIWaypoints de cliente para el home del clan y para los marcadores de camp y rally.
Cliente SurvivalCoreSe 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.
RedisSe 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 create se 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.0 recibe 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.

Si vienes de 1.1.0

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.

El reload no reescribe los clanes existentes

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