Contenido generado con IA — puede contener errores.

ExyliaSurvivalCore/ReferenciaActualizada en v1.2.2

Configuración

Dónde guarda ExyliaSurvivalCore sus archivos, lo que más se cambia (idioma, módulos, teletransportes), qué sobrevive a una edición y cómo recargar.

Página 19 de 388 min de lectura

Todo vive en plugins/ExyliaSurvivalCore/. config.yml guarda los interruptores de módulos, el idioma y las reglas de teletransporte. Cada módulo tiene su carpeta, modules/<id>/, y los mensajes y menús están bajo lang/<código>/. Después de editar, ejecuta /survivalcoreadmin reload (necesita survivalcore.admin.reload); mira Recarga. Los interruptores de módulos son lo único que una recarga no aplica: necesitan reinicio.

Los módulos que pasaron a otros plugins ya no tienen archivos aquí. Los colores y la sintaxis de los mensajes se comparten con todos los plugins Exylia: mira Colores y Mensajes e idiomas.

Tipos de archivo
TipoComportamientoQué archivos
Con esquemaClaves fijas, generadas con comentarios. Una clave que el esquema no conoce se avisa una vez como UNKNOWN_KEY y se eliminaconfig.yml y cada modules/<id>/config.yml que tenga ajustes
De formato libreSe escribe una vez con una cabecera y no se reescribe nunca. Nada se poda, nada de lo que borres vuelvemodules/reclaim/config.yml, modules/scheduled-commands/config.yml, modules/enchantments/rules.yml
ExtraídoUna lista que no cabe dentro de un registro del esquema, guardada en un archivo hermano. Se escribe desde el jar en la primera instalación y no se reescribe despuésfarming/categories.yml, join-leave/groups.yml, missions/missions.yml, projects/projects.yml, rankup/ranks.yml, repair/groups.yml, rtp/worlds.yml, seasons/seasons.yml, stats/stats.yml
TraducidoMensajes y menús, una copia por idioma bajo lang/<código>/lang/<código>/messages.yml, lang/<código>/modules/<id>/messages.yml, los menús bajo ellos

Un archivo extraído que ya existe se da por ya movido, así que uno que vaciaste a propósito se queda vacío en vez de que le escriban encima los valores por defecto. Todos salvo repair/groups.yml se traducen además por idioma: los rangos, categorías, misiones, temporadas, estadísticas y el resto se escriben en el idioma en el que corre el plugin.

Idiomas#

config.yml lleva language. default sigue el idioma de ExyliaLib; en, es, fr, pt, ru o tr fijan solo este plugin.

  • Los mensajes son lang/<código>/messages.yml para el núcleo y lang/<código>/modules/<id>/messages.yml para cada módulo. Nada de lo que ve el jugador está en el código.
  • Los menús son lang/<código>/menus/ y lang/<código>/modules/<id>/menus/. Los menús de administración son lang/<código>/menus/admin/* y se regeneran desde el jar al arrancar; los menús de jugador son tuyos para rediseñar.
  • Un servidor que ya usaba el plugin antes de que existieran los idiomas conserva sus archivos en lang/custom/.

Una línea puede empezar con una etiqueta de efecto como [sound:ENTITY_VILLAGER_NO|1.0|1.0], que es una instrucción y nunca llega a la pantalla. %prefix% se sustituye por el prefijo del plugin.

Qué sobrevive a una edición#

Los archivos incluidos se refrescan en cada arranque. Para cada archivo YAML el plugin compara tres cosas: tu archivo, el archivo incluido y los valores por defecto que revisaste por última vez, que se guardan en .defaults/files/ dentro de la carpeta del plugin.

  • Un archivo que falta se escribe — salvo que se instalara antes y lo borraras. Un menú borrado se queda borrado, y la consola nombra el menú que no pudo registrar.
  • Una clave que añade la nueva versión se escribe en tu archivo al instante, con sus comentarios.
  • Un valor por defecto que cambió o se eliminó, en una clave que sigue con el valor que revisaste por última vez, se deja como está y se lista en /exylialib updates, donde lo aplicas o lo mantienes.
  • Todo lo que cambiaste o borraste no se toca nunca.
  • Un archivo cuyo menu-version (o defaults-version) incluido es mayor que el tuyo se reemplaza entero; tu archivo anterior se conserva al lado como <nombre>.v<versión anterior>.

Un archivo que no se puede leer se deja intacto y se avisa.

config.yml#

ClavePor defectoQué hace
languagedefaultMira Idiomas
debugfalseSalida extra por consola
defer-to-exylia-lobbytrueCon ExyliaLobby activado, jumpads, join-leave y portals se quedan apagados y ExyliaLobby hace esos trabajos. El spawn no cambia. Necesita reinicio
modulestodos trueUn interruptor por módulo — mira abajo
teleportMira teleport
combat-blocks-teleportstrueRechaza /spawn, /home, /warp, /rtp, /back, /tpa y los teletransportes de portal durante el combate. Un permiso que se salta el warmup no se salta esto
idle-after-seconds300Tiempo inactivo (0-86400) tras el cual las recompensas por tiempo jugado dejan de contar al jugador. 0 lo desactiva

modules#

Un interruptor por módulo, todos true por defecto. Pon uno en false y reinicia para apagar ese módulo: no registra comandos, listeners ni tablas, y sus archivos se dejan como están. Las guías dicen qué hace cada uno.

Los treinta interruptores y cuándo un módulo se queda apagado igualmente

Los interruptores: spawn, tpa, homes, join-leave, rtp, scheduled-commands, rankup, player-utils, back, farming, reclaim, stats, portals, jumpads, kits, item-spawners, warps, near, repair, death, enchantments, player-settings, missions, boosters, seasons, optimization, item-updater, reputation, projects y mobs.

mobs es un interruptor heredado que no hace nada: los mobs personalizados pasaron a ExyliaMobs y ningún módulo lo registra. Sigue en el archivo para que las configuraciones antiguas se sigan leyendo.

Un módulo también se queda apagado, diga lo que diga su interruptor, cuando otro plugin hace su trabajo:

MóduloSe queda apagado mientras
farmingExyliaJobs esté instalado
item-spawnersExyliaSpawners esté instalado
jumpads, join-leave, portalsExyliaLobby esté activado y defer-to-exylia-lobby sea true

Un interruptor cambiado necesita reinicio; /survivalcoreadmin reload nombra los módulos que lo esperan.

teleport#

Son los ajustes de teletransporte de ExyliaLib. El plugin se los entrega al módulo de teletransporte de ExyliaLib, que los aplica a cada movimiento que hace el plugin. Los que más se cambian son warmup-seconds (quedarse quieto antes del movimiento, 0.0 por defecto) y cancel-on-move / cancel-on-damage (ambos true).

Todas las claves de teleport
ClavePor defectoRangoQué hace
warmup-seconds0.0Quedarse quieto antes del movimiento
cancel-on-movetrueMoverse cancela el warmup
cancel-on-damagetrueRecibir daño cancela el warmup
safe-search-radius50-32Hasta dónde buscar suelo seguro
safe-max-attempts321-256Intentos para encontrar suelo seguro
cross-server-ttl-seconds30030-3600Cuánto sigue siendo válido un movimiento a otro servidor
cross-server-settle-seconds0.50.05-5Pausa tras llegar a otro servidor
back-history-size31-16Ubicaciones que recuerda /back
back-history-minutes301-1440Cuánto tiempo se recuerdan
tpa-expiry-seconds605-3600Mira abajo
tpa-max-pending81-64Peticiones en espera por jugador
random-max-attempts161-64Intentos para una ubicación aleatoria

El plugin solo lee back-history-minutes (para /back). Una petición de TPA caduca de verdad según settings.request-expire-seconds en modules/tpa/config.yml (60 por defecto), no según tpa-expiry-seconds.

No hay sección de base de datos en config.yml: la base de datos se configura una sola vez para todos los plugins en el database.yml de ExyliaLib (mira Base de datos).

Formas compartidas#

Claves de título, action bar y boss bar

Varios módulos dibujan las mismas tres cosas, y en todas partes llevan las mismas claves.

FormaClaves
Títulotext, subtitle, fade-in, stay, fade-out, time-style
Action bartext, duration, time-style
Boss bartext, colour, overlay, count-up, progress, time-style

colour admite PINK, BLUE, RED, GREEN, YELLOW, PURPLE o WHITE. overlay admite PROGRESS, NOTCHED_6, NOTCHED_10, NOTCHED_12 o NOTCHED_20. time-style admite auto, seconds, tenths, hundredths, clock o full. Un stay o duration de 0 significa "hasta que algo lo detenga".

Los sonidos son siempre NOMBRE_DEL_SONIDO|VOLUMEN|TONO, y una cadena vacía lo desactiva.

Archivos por módulo#

Los ids de módulo usan guiones: join-leave, item-spawners, player-utils, scheduled-commands. Los archivos de un módulo están en modules/<id>/.

Qué archivos tiene cada módulo
MóduloArchivos
spawn, tpa, homes, back, warpsconfig.yml — el warmup, el nodo de bypass, los mundos en lista negra, los sonidos y los efectos
rtpconfig.yml más worlds.yml
join-leaveconfig.yml más groups.yml
rankupconfig.yml más ranks.yml
farmingconfig.yml más categories.yml
statsconfig.yml más stats.yml
missionsconfig.yml más missions.yml
seasonsconfig.yml más seasons.yml
repairconfig.yml más groups.yml
enchantmentsconfig.yml más rules.yml
reclaim, scheduled-commandssolo config.yml, de formato libre
player-utils, near, jumpads, kits, item-spawners, death, boosters, portals, optimization, reputationsolo config.yml
projectssolo projects.yml
player-settings, item-updaterNingún archivo de configuración

Lo que hace cada clave está en la página de ese módulo: Movimiento, Progresión, Misiones y temporadas, Kits y cajas, Zonas, Restricciones, Utilidades, Optimización y Reputación y proyectos.

Recarga#

/survivalcoreadmin reload, desde la consola o en el juego, ejecuta tres pasos en orden:

  1. configs — config.yml incluidos debug y teleport, y cada archivo de módulo con esquema.
  2. módulos — cada módulo activado declara de nuevo sus archivos y vuelve a leer lo que guarda: escaleras, reglas, missions.yml, seasons.yml y el resto.
  3. menús — los menús se refrescan como se describe arriba y cada menú se compila otra vez. Este paso también se ejecuta con /exylialib reload.

Un paso que falla se avisa por su nombre y los siguientes se ejecutan igualmente. La recarga no aplica un interruptor de módulo; cuando uno ya no coincide con lo que está en marcha, termina nombrando los módulos que necesitan un reinicio.

¿Falta algo en esta página? Dínoslo en Discord