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.
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
| Tipo | Comportamiento | Qué archivos |
|---|---|---|
| Con esquema | Claves fijas, generadas con comentarios. Una clave que el esquema no conoce se avisa una vez como UNKNOWN_KEY y se elimina | config.yml y cada modules/<id>/config.yml que tenga ajustes |
| De formato libre | Se escribe una vez con una cabecera y no se reescribe nunca. Nada se poda, nada de lo que borres vuelve | modules/reclaim/config.yml, modules/scheduled-commands/config.yml, modules/enchantments/rules.yml |
| Extraído | Una 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és | farming/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 |
| Traducido | Mensajes 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.ymlpara el núcleo ylang/<código>/modules/<id>/messages.ymlpara cada módulo. Nada de lo que ve el jugador está en el código. - Los menús son
lang/<código>/menus/ylang/<código>/modules/<id>/menus/. Los menús de administración sonlang/<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(odefaults-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#
| Clave | Por defecto | Qué hace |
|---|---|---|
language | default | Mira Idiomas |
debug | false | Salida extra por consola |
defer-to-exylia-lobby | true | Con ExyliaLobby activado, jumpads, join-leave y portals se quedan apagados y ExyliaLobby hace esos trabajos. El spawn no cambia. Necesita reinicio |
modules | todos true | Un interruptor por módulo — mira abajo |
teleport | Mira teleport | |
combat-blocks-teleports | true | Rechaza /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-seconds | 300 | Tiempo 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ódulo | Se queda apagado mientras |
|---|---|
farming | ExyliaJobs esté instalado |
item-spawners | ExyliaSpawners esté instalado |
jumpads, join-leave, portals | ExyliaLobby 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
| Clave | Por defecto | Rango | Qué hace |
|---|---|---|---|
warmup-seconds | 0.0 | Quedarse quieto antes del movimiento | |
cancel-on-move | true | Moverse cancela el warmup | |
cancel-on-damage | true | Recibir daño cancela el warmup | |
safe-search-radius | 5 | 0-32 | Hasta dónde buscar suelo seguro |
safe-max-attempts | 32 | 1-256 | Intentos para encontrar suelo seguro |
cross-server-ttl-seconds | 300 | 30-3600 | Cuánto sigue siendo válido un movimiento a otro servidor |
cross-server-settle-seconds | 0.5 | 0.05-5 | Pausa tras llegar a otro servidor |
back-history-size | 3 | 1-16 | Ubicaciones que recuerda /back |
back-history-minutes | 30 | 1-1440 | Cuánto tiempo se recuerdan |
tpa-expiry-seconds | 60 | 5-3600 | Mira abajo |
tpa-max-pending | 8 | 1-64 | Peticiones en espera por jugador |
random-max-attempts | 16 | 1-64 | Intentos 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.
| Forma | Claves |
|---|---|
| Título | text, subtitle, fade-in, stay, fade-out, time-style |
| Action bar | text, duration, time-style |
| Boss bar | text, 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ódulo | Archivos |
|---|---|
spawn, tpa, homes, back, warps | config.yml — el warmup, el nodo de bypass, los mundos en lista negra, los sonidos y los efectos |
rtp | config.yml más worlds.yml |
join-leave | config.yml más groups.yml |
rankup | config.yml más ranks.yml |
farming | config.yml más categories.yml |
stats | config.yml más stats.yml |
missions | config.yml más missions.yml |
seasons | config.yml más seasons.yml |
repair | config.yml más groups.yml |
enchantments | config.yml más rules.yml |
reclaim, scheduled-commands | solo config.yml, de formato libre |
player-utils, near, jumpads, kits, item-spawners, death, boosters, portals, optimization, reputation | solo config.yml |
projects | solo projects.yml |
player-settings, item-updater | Ningú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:
- configs —
config.ymlincluidosdebugyteleport, y cada archivo de módulo con esquema. - módulos — cada módulo activado declara de nuevo sus archivos y vuelve a leer lo que guarda:
escaleras, reglas,
missions.yml,seasons.ymly el resto. - 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