Lanza misiones y temporadas
Añade misiones diarias y semanales y clasificaciones de temporada diarias, semanales o mensuales, medidas sobre contadores de estadísticas, con premios pagados una sola vez entre servidores.
Ni las misiones ni las temporadas cuentan nada por sí mismas. Cada módulo ya suma a un contador de
estadísticas cuando un jugador hace algo (un bloque roto, una cosecha, una baja, un trato cerrado), y una
misión o una temporada es un objetivo o una clasificación sobre uno de esos contadores. Las dos necesitan
el módulo stats; con él apagado todos los contadores leen cero, y cada módulo lo avisa una vez en el log.
Enciéndelas en config.yml (Enciende y apaga módulos).
Qué contadores se pueden usar#
El stat de una misión y el counter de una temporada son claves de contador, como mines.blocks,
farming.harvested, kills.players, kills.mobs o missions.completed. La lista completa, con lo que
cuenta cada una, está en Estadísticas.
- Las claves pasan a minúsculas, así que
Mines.Blocksesmines.blocks. - Nada comprueba que una clave exista. Una clave que nadie cuenta lee 0 para siempre: su misión no se termina nunca y su temporada no clasifica a nadie. No se avisa en el log.
- Los ids de
modules/stats/stats.ymlque no son contadores (kills,deaths,kdr,playtimey el resto de estadísticasINTERNAL,COMPUTED,PAPIyVAULT) no son claves de contador y aquí leen 0. Usakills.players, nokills.
Misiones#
Un jugador tiene un grupo de misiones diarias y otro de semanales. /missions (alias /mission,
exyliasurvivalcore.missions) las enseña, y una terminada se cobra desde ahí.
Añade una misión#
Abre el archivo
Edita modules/missions/missions.yml. Una sección missions que una versión anterior dejara en
config.yml se mueve aquí al arrancar.
Añade un bloque
La clave del bloque es el id de la misión. Pon stat (una clave de
contador), amount y pool.
Di qué paga
Pon money, commands o una lista rewards completa.
Recarga
Ejecuta /survivalcoreadmin reload. El archivo incluido trae siete misiones diarias y seis semanales
para copiar.
missions:
daily_mine:
display-name: 'Turno en la mina'
icon: IRON_PICKAXE
description:
- 'Rompe bloques en cualquiera de las minas del servidor.'
stat: 'mines.blocks'
amount: 250-600
pool: DAILY
money: 60
commands: []Claves de misión
| Clave | Por defecto | Qué hace |
|---|---|---|
display-name | La clave del bloque | El nombre en pantalla |
icon | PAPER | Un material. Si es desconocido, PAPER |
description | ninguna | Líneas bajo el nombre |
stat | ninguno | La clave de contador. Obligatoria |
amount | ninguno | Un número, o un rango como 300-700 que se sortea una vez por rotación. Obligatoria, mayor que 0 |
pool | DAILY | DAILY o WEEKLY |
money | 0 | Se paga al cobrar, en la moneda por defecto |
commands | ninguno | Se ejecutan al cobrar, desde la consola salvo que la línea empiece por player: |
Un bloque sin stat, con un amount que no sea un número o rango positivo, o con un pool que no sea
ninguno de los dos, se salta con un aviso.
En amount: 0-5, el sorteo puede caer en 0, y una misión con objetivo 0 está terminada en cuanto se
entrega.
Comprueba que funciona#
Ejecuta /missions tras recargar. Una misión nueva aparece en el siguiente grupo que reciba un jugador; el
que ya tiene el grupo de este periodo lo conserva hasta la siguiente rotación.
Cómo se elige un grupo#
- Qué misiones pide una rotación, y el objetivo de una misión con rango, se sacan de un generador con la rotación como semilla. Todo el servidor recibe las mismas misiones con los mismos números, y sobreviven a un reinicio.
- Se sacan
daily-countyweekly-countmisiones del grupo de cada rotación. Un grupo con menos misiones que eso las reparte todas. - El progreso es el contador ahora menos lo que marcaba cuando se entregó la misión. Lo que el jugador hizo antes no cuenta nunca, y el punto de partida solo se toma cuando sus contadores ya han cargado.
- Las rotaciones se calculan con el reloj. Un jugador recibe el grupo nuevo al entrar, al abrir
/missions, y en la siguiente comprobación mientras está conectado. Un grupo que sustituye a otro suena conmissions-rotatedy envía el mensaje NUEVAS MISIONES; el primer grupo de un jugador no.
La fila de una misión va por jugador, rotación y misión, así que un jugador no puede tener la misma misión dos veces en un periodo en ningún servidor.
Cobrar las recompensas#
Una misión terminada se cobra haciendo clic en ella, o con Recoger todo. La fila se marca como cobrada antes de pagar nada, así que un doble clic paga una sola vez.
moneyes un número, o{amount: 50, currency: gems}para pagar otra moneda. Pasa por los potenciadores de dinero demissions(mira Economía y potenciadores) y necesita una economía.rewards:es una lista de recompensas completa de Exylia (objetos, dinero, comandos; mira Recompensas). Lo que no cabe en el inventario se encola para el jugador.commandsreciben%player%,%player_name%,%mission%,%target%y%money%, el dinero realmente pagado o, si no se pagó nada, la cantidad configurada.- Cuenta
missions.completed,missions.daily.completedomissions.weekly.completed, ymissions.earnedpor el dinero pagado.
Cada check-interval-seconds el plugin busca misiones recién terminadas. Con auto-claim: false el
jugador recibe MISIÓN COMPLETADA una vez por sesión, y una semanal se anuncia a los jugadores con
mission-announcements encendido en /settings. Con
auto-claim: true se cobra en el acto.
Una misión cobrada por auto-claim solo envía la línea Cobraste. El mensaje MISIÓN COMPLETADA y el
anuncio semanal no se envían nunca.
Una misión que se quita de missions.yml mientras un jugador la tiene se dibuja como Misión retirada y
no se puede cobrar. Las misiones de un jugador se borran con las herramientas de limpieza y resetplayer de
ExyliaLib; la siguiente vez que mire se le entrega un grupo nuevo.
Cambia la rotación#
modules/missions/config.yml:
| Ajuste | Por defecto | Qué hace |
|---|---|---|
settings.daily-count | 3 | Misiones diarias por jugador |
settings.weekly-count | 2 | Misiones semanales por jugador |
settings.reset-hour | 0 | Hora, de 0 a 23, a la que cambian las dos rotaciones |
settings.weekly-reset-day | MONDAY | Día en que empieza la rotación semanal. Si es desconocido, MONDAY |
settings.timezone | "" | Zona IANA para las dos. Vacía o desconocida es la del servidor |
settings.auto-claim | false | Cobra las misiones terminadas sin pasar por el menú |
settings.broadcast-weekly | true | Anuncia una misión semanal terminada. Las diarias nunca |
settings.check-interval-seconds | 20 | Segundos entre comprobaciones. Nunca menos de 5; se lee al arrancar, así que un cambio pide reinicio |
sounds.mission-completed | ENTITY_PLAYER_LEVELUP|0.6|1.0 | Una misión terminada |
sounds.mission-claimed | ENTITY_PLAYER_LEVELUP|1.0|1.4 | Una misión cobrada |
sounds.missions-rotated | BLOCK_NOTE_BLOCK_CHIME|1.0|1.2 | Un grupo nuevo sustituyó al anterior |
La pantalla es modules/missions/menus/missions.yml. Su línea Recompensa muestra el dinero configurado
antes de los potenciadores; una misión que solo paga comandos dice Ventajas, y una de objetos dice
Ítems. Los botones son survivalcore:missions_open, survivalcore:missions_claim <fila> y
survivalcore:missions_claim_all.
| Placeholder | Muestra | Ejemplo |
|---|---|---|
%exyliasurvivalcore_missions_daily_done% | Misiones diarias del lector completadas o reclamadas | 2 |
%exyliasurvivalcore_missions_daily_total% | Misiones diarias que tiene | 3 |
%exyliasurvivalcore_missions_weekly_done% | Lo mismo para las semanales | — |
%exyliasurvivalcore_missions_weekly_total% | Misiones semanales que tiene | — |
%exyliasurvivalcore_missions_claimable% | Misiones completas aún sin reclamar | 1 |
%exyliasurvivalcore_missions_daily_resets% | Tiempo hasta que se reinician las diarias, corto — `3h` | 3h |
%exyliasurvivalcore_missions_weekly_resets% | Lo mismo para las semanales | — |
Temporadas#
Una temporada es una clasificación sobre un contador durante un día, una semana o un mes. Cuando termina, se
pagan los mejores puestos y se abre la siguiente. /seasons (alias /season,
exyliasurvivalcore.seasons) abre la lista.
Añade una temporada#
Abre el archivo
Edita modules/seasons/seasons.yml. Las claves que añada una versión posterior aparecen solas.
Añade un bloque
La clave del bloque es el id de la temporada: minúsculas, dígitos, _ y -, hasta 40. Cualquier otra
cosa se salta con un aviso. Pon counter y period.
Pon los premios
Bajo prizes, da a cada puesto o rango de puestos una lista de recompensas de Exylia.
Recarga
Ejecuta /survivalcoreadmin reload. El archivo incluido clasifica miners y farmers cada semana y
voters cada mes.
seasons:
voters:
display-name: '{primary}&lTOP VOTANTES'
description: 'Votos emitidos por el servidor'
icon: PAPER
counter: 'votes.total'
period: MONTHLY
format: NUMBER
prizes:
'1':
- type: ECONOMY
value: '1500'
- 'boostersadmin give %player_name% money 2 2h'
'2':
- type: ECONOMY
value: '900'Claves de temporada
| Clave | Por defecto | Qué hace |
|---|---|---|
display-name | El id | El nombre en pantalla |
description | "" | Una línea en /seasons |
icon | NETHER_STAR | El objeto en /seasons |
counter | ninguno | La clave de contador. Obligatoria; una clave que empiece por seasons. se rechaza |
period | WEEKLY | DAILY, WEEKLY o MONTHLY. Si es desconocido, WEEKLY, sin aviso |
format | NUMBER | NUMBER, DECIMAL, MONEY o TIME, cómo se escriben las puntuaciones. Si es desconocido, NUMBER, sin aviso |
prizes | ninguno | Por puesto |
Premios#
Cada clave bajo prizes es un puesto, '1', o un rango, '4-10', y su valor es una lista de recompensas de
Exylia (el mismo formato que Recompensas). Un puesto cubierto por dos claves
usa la primera escrita. Una clave que no es un puesto se avisa y se salta. El dinero de los premios no se
multiplica por potenciadores.
Comprueba que funciona#
Ejecuta /seasons. La temporada debe salir en la lista con su tiempo restante; /seasonsadmin close <temporada> la clasifica y la paga ahora mismo, que es la forma más rápida de probar una lista de premios
en un servidor de pruebas.
Cómo cuenta una temporada#
Mientras una temporada está abierta, cada suma a su contador se suma también bajo una clave propia,
seasons.<temporada>.<periodo>. Su clasificación es el ranking de esa clave, así que solo clasifica lo que
se cuenta con la temporada abierta, y una recarga no reinicia una temporada en marcha.
Solo alimentan una temporada los contadores a los que se suma. Un contador escrito como mejor marca personal
(votes.best_streak es el único incluido) nunca se suma a la clave de una temporada, así que una temporada
sobre él no clasifica a nadie.
El cierre, una sola vez entre servidores#
Cada servidor comprueba una vez por minuto, la primera diez segundos tras arrancar. Cuando termina el
periodo de una temporada y han pasado close-delay-minutes más:
- Cada servidor intenta borrar la fila de la temporada; el que lo consigue es el único que sigue.
- Clasifica los primeros
leaderboard-sizepuestos, o tantos como pagan los premios si son más. Una puntuación de 0 no se coloca. - Guarda los resultados, paga los premios, abre la siguiente temporada y borra el contador de la temporada.
- Cada servidor anuncia los tres primeros a los jugadores con
season-announcementsencendido en/settings.
Lo que se cuenta durante la espera del cierre sigue contando para la temporada que se cierra. Un premio para
un jugador conectado en el servidor que cierra se entrega en el acto con Terminaste en el puesto #N; los
demás, desconectados o en otro servidor, lo reciben al entrar. El anuncio viaja por el canal seasons, que
en una red necesita Redis.
Una temporada sin fila abierta la abre el primer servidor que lo nota, de inmediato en un primer arranque y a los cinco minutos en los demás casos, para que un servidor entre el cierre y la reapertura no compita.
/seasonsadmin close <temporada> (alias /seasonsa, exyliasurvivalcore.seasons.admin) clasifica y paga
la temporada ahora y abre la siguiente de inmediato. Se ejecuta desde la consola. La temporada que abre
llega hasta el fin normal del periodo, así que cerrar una semanal un jueves deja una corta hasta el lunes.
Periodos y ajustes#
| Periodo | Nombre | Empieza |
|---|---|---|
DAILY | 20260912 | Cada día a la reset-hour |
WEEKLY | 2026w37 | El lunes a la reset-hour. No se configura, a diferencia de las misiones |
MONTHLY | 202609 | El día 1 a la reset-hour |
modules/seasons/config.yml:
| Ajuste | Por defecto | Qué hace |
|---|---|---|
settings.timezone | "" | La zona en que se cuentan días, semanas y meses. Vacía o desconocida es la del servidor |
settings.reset-hour | 0 | Hora, de 0 a 23, a la que empieza un día |
settings.close-delay-minutes | 2 | Minutos que una temporada sigue abierta tras acabar su tiempo, para que se escriban las últimas cuentas. Nunca menos que el intervalo de escritura de estadísticas más 30 segundos |
settings.leaderboard-size | 10 | Puestos que enseña una clasificación |
modules/seasons/menus/seasons.yml lista cada temporada con sus tres primeros y el puesto y la puntuación
del jugador; al hacer clic en una se abre season_board.yml, la clasificación completa con el premio de
cada puesto y los ganadores de la última temporada. Las clasificaciones en pantalla tienen como mucho un
minuto. Los botones son survivalcore:seasons_open y survivalcore:seasons_board <temporada>.
Un id de temporada con guiones bajos se lee entero en los placeholders de abajo; en los top_ el puesto va
primero.
| Placeholder | Muestra | Ejemplo |
|---|---|---|
%exyliasurvivalcore_seasons_left_<season>% | Tiempo hasta que acaba esa temporada, o nada si no existe | — |
%exyliasurvivalcore_seasons_value_<season>% | La puntuación del lector en ella, escrita como la cuenta la temporada, o `0` | — |
%exyliasurvivalcore_seasons_position_<season>% | Su puesto en su ranking, `0` si no está en él | 7 |
%exyliasurvivalcore_seasons_top_name_<position>_<season>% | El jugador en ese puesto, o `—` | — |
%exyliasurvivalcore_seasons_top_value_<position>_<season>% | Su puntuación, o `—` | — |
¿Falta algo en esta página? Dínoslo en Discord