Contenido generado con IA — puede contener errores.

ExyliaSurvivalCore/GuíasActualizada en v1.2.2

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.

Página 8 de 3811 min de lectura

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.Blocks es mines.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.yml que no son contadores (kills, deaths, kdr, playtime y el resto de estadísticas INTERNAL, COMPUTED, PAPI y VAULT) no son claves de contador y aquí leen 0. Usa kills.players, no kills.

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.

yaml
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
ClavePor defectoQué hace
display-nameLa clave del bloqueEl nombre en pantalla
iconPAPERUn material. Si es desconocido, PAPER
descriptionningunaLíneas bajo el nombre
statningunoLa clave de contador. Obligatoria
amountningunoUn número, o un rango como 300-700 que se sortea una vez por rotación. Obligatoria, mayor que 0
poolDAILYDAILY o WEEKLY
money0Se paga al cobrar, en la moneda por defecto
commandsningunoSe 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.

Un rango que empieza en 0 puede entregar una misión ya terminada

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-count y weekly-count misiones 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 con missions-rotated y 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.

  • money es un número, o {amount: 50, currency: gems} para pagar otra moneda. Pasa por los potenciadores de dinero de missions (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.
  • commands reciben %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.completed o missions.weekly.completed, y missions.earned por 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.

El cobro automático se salta los anuncios

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:

AjustePor defectoQué hace
settings.daily-count3Misiones diarias por jugador
settings.weekly-count2Misiones semanales por jugador
settings.reset-hour0Hora, de 0 a 23, a la que cambian las dos rotaciones
settings.weekly-reset-dayMONDAYDí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-claimfalseCobra las misiones terminadas sin pasar por el menú
settings.broadcast-weeklytrueAnuncia una misión semanal terminada. Las diarias nunca
settings.check-interval-seconds20Segundos entre comprobaciones. Nunca menos de 5; se lee al arrancar, así que un cambio pide reinicio
sounds.mission-completedENTITY_PLAYER_LEVELUP|0.6|1.0Una misión terminada
sounds.mission-claimedENTITY_PLAYER_LEVELUP|1.0|1.4Una misión cobrada
sounds.missions-rotatedBLOCK_NOTE_BLOCK_CHIME|1.0|1.2Un 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.

PlaceholderMuestraEjemplo
%exyliasurvivalcore_missions_daily_done%Misiones diarias del lector completadas o reclamadas2
%exyliasurvivalcore_missions_daily_total%Misiones diarias que tiene3
%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 reclamar1
%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.

yaml
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
ClavePor defectoQué hace
display-nameEl idEl nombre en pantalla
description""Una línea en /seasons
iconNETHER_STAREl objeto en /seasons
counterningunoLa clave de contador. Obligatoria; una clave que empiece por seasons. se rechaza
periodWEEKLYDAILY, WEEKLY o MONTHLY. Si es desconocido, WEEKLY, sin aviso
formatNUMBERNUMBER, DECIMAL, MONEY o TIME, cómo se escriben las puntuaciones. Si es desconocido, NUMBER, sin aviso
prizesningunoPor 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.

Los contadores de mejor marca nunca clasifican

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:

  1. Cada servidor intenta borrar la fila de la temporada; el que lo consigue es el único que sigue.
  2. Clasifica los primeros leaderboard-size puestos, o tantos como pagan los premios si son más. Una puntuación de 0 no se coloca.
  3. Guarda los resultados, paga los premios, abre la siguiente temporada y borra el contador de la temporada.
  4. Cada servidor anuncia los tres primeros a los jugadores con season-announcements encendido 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#

PeriodoNombreEmpieza
DAILY20260912Cada día a la reset-hour
WEEKLY2026w37El lunes a la reset-hour. No se configura, a diferencia de las misiones
MONTHLY202609El día 1 a la reset-hour

modules/seasons/config.yml:

AjustePor defectoQué hace
settings.timezone""La zona en que se cuentan días, semanas y meses. Vacía o desconocida es la del servidor
settings.reset-hour0Hora, de 0 a 23, a la que empieza un día
settings.close-delay-minutes2Minutos 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-size10Puestos 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.

PlaceholderMuestraEjemplo
%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 él7
%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