Crea rangos, hitos de farming y reclamos
Escribe la escalera de rangos con requisitos y prestigio, paga a los jugadores por farmear y matar mobs, y configura secciones de /reclaim por rango. Las recompensas por tiempo jugado viven en ExyliaRewards.
Tres módulos dan a los jugadores algo que escalar: una escalera de rangos con prestigio (rankup),
recompensas por farmear (farming) y un comando /reclaim para ventajas compradas fuera del juego
(reclaim). Cada uno se enciende en config.yml (Enciende y apaga módulos).
Rankup#
Añade un rango#
Abre el archivo de la escalera
Edita modules/rankup/ranks.yml. Cada bloque bajo ranks: es un rango, y su clave es el id que usan
/rankup y los placeholders.
Ordénalo y pon requisitos
Dale un order (la posición en la escalera) y una lista de requirements.
Di qué da
Pon comandos de consola en reward.commands (%player% es el jugador), y opcionalmente broadcast y
sound.
Recarga
Ejecuta /survivalcoreadmin reload.
ranks:
member:
display-name: "&7Miembro"
icon: IRON_INGOT
order: 1
description: []
requirements:
- type: money
amount: 250
- type: playtime
time: 2h
reward:
commands:
- lp user %player% parent set member
broadcast: ""
sound: ENTITY_PLAYER_LEVELUP|1.0|1.0
auto-rankup: false/rankup abre la escalera y muestra qué se cumple y qué no; /rankup claim sube al siguiente rango cuando
todo se cumple. settings.auto-rankup en modules/rankup/config.yml asciende sin preguntar, y un
auto-rankup por rango hace lo mismo para un solo escalón. settings.notify-on-login avisa al jugador al
entrar cuando puede subir de rango.
Elige los requisitos#
Un requisito es un type y un campo. Cualquier entrada puede llevar también display, la línea que se
muestra en el menú en lugar de una generada.
type | Campo | Significado |
|---|---|---|
money | amount (y un currency opcional) | Un saldo, a través de la economía. currency es un id del economy.yml de ExyliaLib; si se omite, la moneda por defecto |
playtime | time | Tiempo jugado: 30m, 1h, 5h |
placeholder | condition | Una comparación de PlaceholderAPI, por ejemplo %player_level% >= 30 |
permission | node | Un permiso que deben tener |
Un requisito con cualquier otro type se avisa en la consola y se ignora, así que un rango cuyo único
requisito tenga un tipo desconocido no cuesta nada. Mira Economía para las
monedas.
Todo ascenso, con /rankup claim o automático, sigue el mismo camino: primero se lanza RankUpEvent (uno
cancelado no cuesta nada), luego se cobra cada requisito money, todas las monedas o ninguna, y después se
ejecuta la recompensa. Si el ascenso pierde una carrera, el cobro se reembolsa.
Aquí ya no hay módulo de tiempo jugado ni comando /playtime: los tramos de tiempo son de
ExyliaRewards. El tiempo jugado lo mide el servicio de tiempo de
ExyliaLib, que leen el requisito playtime de los rangos y la estadística PLAYTIME.
Deja que los jugadores hagan prestigio#
Un jugador en lo alto de la escalera hace prestigio con /rankup prestige o con la estrella de la esquina
del menú /rankup. Cobra el coste del prestigio, le quita el rango, sube su nivel de prestigio en uno y
ejecuta las recompensas de prestigio. Después vuelve a subir la escalera desde el primer rango.
Cada requisito money se multiplica por prestige.cost-multiplier una vez por nivel de prestigio (1.5 por
defecto: un rango de 1.000 $ cuesta 1.500 $ en el prestigio 1 y 2.250 $ en el 2), y el menú muestra la
cantidad que de verdad necesitan. Pon 1.0 para que la escalera no cambie.
Un prestigio se rechaza cuando está desactivado, cuando el jugador no está en el último rango, cuando ya
está en max-level y cuando no puede pagar, incluido el caso en que cost es mayor que 0 y no hay economía.
Ajustes de prestigio (modules/rankup/config.yml)
| Ajuste | Por defecto | Qué hace |
|---|---|---|
enabled | true | Si alguien puede hacer prestigio |
max-level | 0 | Nivel de prestigio máximo. 0 significa sin límite |
cost | 25000 | Dinero que cuesta el prestigio. 0 es gratis |
cost-currency | vacío | La moneda en que se cobra cost: un id del economy.yml de ExyliaLib. Vacío es la moneda por defecto |
cost-multiplier | 1.5 | Mira arriba |
reward-commands | lp user %player% parent set member | Comandos de consola. %player% es el jugador, %level% el nivel recién alcanzado |
reward-sound | ENTITY_PLAYER_LEVELUP|0.6|1.0 | Se reproduce al jugador. Vacío para ninguno |
El anuncio de prestigio es la línea prestige-broadcast de modules/rankup/messages.yml; llega a todos los
que tienen activados los anuncios de ascenso, y vacío significa ninguno. %exyliasurvivalcore_rankup_can_prestige%
responde yes o no.
/rankupadmin (alias /rua, survivalcore.rankup.admin) tiene set <jugador> <rango> para mover a un
jugador por la escalera, prestige <jugador> <nivel> para fijar un nivel de prestigio directamente e
info <jugador>; set y prestige necesitan survivalcore.rankup.admin.set. Un id de rango que no está en
el archivo se rechaza. Borrar el progreso de un jugador es /exylialib resetplayer.
Farming#
Mientras ExyliaJobs esté instalado, este módulo se queda apagado y Jobs paga por las mismas acciones. Vuelve a cargarse si quitas Jobs.
El módulo de farming cuenta bloques rotos o mobs matados, y paga cada N y en hitos.
Recompensa una categoría de farming#
Edita las categorías
Abre modules/farming/categories.yml. Cada bloque bajo categories: es una categoría, y su clave es el
id que usan /farming y los placeholders.
Di qué cuenta
Pon type (BLOCK para romper, ENTITY para matar) y tracked (nombres de material o de tipo de
entidad).
Di qué paga
Pon reward-every y un bloque reward, y añade milestones para recompensas únicas.
Recarga
Ejecuta /survivalcoreadmin reload.
categories:
wheat_farming:
type: BLOCK
display-name: "&eTrigo"
icon: WHEAT
tracked: [WHEAT]
require-max-growth: true
count-above: false
reward-every: 50
reward: { money: 2, message: "", actionbar: "", sound: "" }
milestones:
novice: { display-name: "Granjero novato", required-count: 100, money: 10 }
infinite-milestone:
enabled: true
interval: 1000
money: 50Los bloques que un jugador colocó nunca cuentan, por mucho tiempo que haya pasado desde que se colocaron.
/farming muestra el progreso. /farmingadmin (alias /fa) tiene set, reset e info, todos tras
survivalcore.farming.admin; los dos que escriben necesitan además survivalcore.farming.admin.set.
settings.notify-on-login en modules/farming/config.yml envía un resumen corto al entrar.
Claves de categoría
| Clave | Qué hace |
|---|---|
type | BLOCK para romper, ENTITY para matar |
tracked | Los materiales o tipos de entidad que cuentan |
require-max-growth | Solo cuentan los cultivos totalmente crecidos |
count-above | En plantas que se apilan, como la caña de azúcar y el bambú, cuenta también los bloques de encima |
reward-every | Paga cada N. 0 apaga la recompensa por N |
milestones | Recompensas únicas en un required-count |
infinite-milestone | Sigue pagando cada interval cuando se acaban los hitos con nombre |
ignored-spawn-reasons | Para ENTITY, motivos de aparición cuyos mobs no cuentan. Si se omite, se ignora SPAWNER; una lista vacía cuenta todos |
Cada bloque de recompensa (reward, cada hito e infinite-milestone) admite money, commands,
message, actionbar y sound. Omite uno para saltártelo. money se paga en la moneda por defecto y lo
multiplican los potenciadores de dinero de farming (mira Economía).
Otra moneda se escribe money: {amount: 50, currency: gems}, un id del economy.yml de ExyliaLib.
Placeholders: %player%, %count% y %money% (lo que se pagó, tras los potenciadores).
Reclaim#
/reclaim entrega a un jugador un conjunto de recompensas ligado a un permiso, como un kit de donante o una
caja mensual. Necesita exyliasurvivalcore.reclaim (concedido a todos), y cada sección pide además su
propio permiso.
Añade una sección de reclaim#
Abre las secciones
Edita modules/reclaim/config.yml. Cada bloque bajo sections: es una sección, con el nombre que
quieras.
Elige quién y cada cuánto
Pon permission, priority y each.
Lista qué reciben
Rellena rewards y, para lo que una recompensa no pueda expresar, commands.
Recarga y concede el permiso
Ejecuta /survivalcoreadmin reload y concede el permiso de la sección al grupo que deba tenerlo.
sections:
vip:
permission: exyliasurvivalcore.reclaim.vip
priority: 1
each: "7d"
broadcast: true
rewards:
- type: ITEM
itemSnapshot: DIAMOND
itemAmount: 5
- type: ECONOMY
value: "50"
commands: []Las secciones se ordenan por prioridad, de mayor a menor, y se ejecuta la primera cuyo permiso tenga el
jugador. Un VIP recibe la sección VIP y nada más, no las dos. A un jugador sin ningún permiso de sección se
le dice que no hay nada para él, así que concede exyliasurvivalcore.reclaim.default solo al grupo que deba
tener la sección por defecto.
each es cada cuánto se puede ejecutar una sección: -1 significa una sola vez en la vida, y cualquier otra
cosa es una duración como 7d, 12h, 30m o 45s. rewards es la lista de recompensas estándar de
Exylia (mira Recompensas); los objetos que no caben se guardan para el
jugador en lugar de tirarse. commands son comandos de consola que se ejecutan también, sustituyendo
%player%. broadcast: true anuncia el reclamo a los jugadores con el ajuste de anuncios de compras
activado.
/reclaimadmin resetsection <jugador> <sección> (exyliasurvivalcore.reclaim.admin) borra el registro de
reclamo de una sección.
Comandos, permisos y placeholders#
Estas tablas incluyen también los comandos de misiones, temporadas, proyectos y reputación, que tienen sus propias páginas.
| Comando | Qué hace | Permiso |
|---|---|---|
/rankup | Abre la escalera de rangos | exyliasurvivalcore.rankup |
/rankup claim | Reclama una recompensa de rango pendiente | exyliasurvivalcore.rankup |
/rankup prestige | Hace prestigio, cuando la escalera lo permite | exyliasurvivalcore.rankup |
/rankupadmin | Imprime la línea de uso | survivalcore.rankup.admin |
/rankupadmin set <player> <rank> | Pone a un jugador en un rango | survivalcore.rankup.admin.set |
/rankupadmin prestige <player> <level> | Fija el nivel de prestigio de un jugador | survivalcore.rankup.admin.set |
/rankupadmin info <player> | Muestra el rango y el prestigio de un jugador | survivalcore.rankup.admin |
/farming | Abre el menú de progreso de farming | exyliasurvivalcore.farming |
/farmingadmin | Imprime la línea de uso | survivalcore.farming.admin |
/farmingadmin set <player> <category> <count> | Fija la cuenta de un jugador en una categoría | survivalcore.farming.admin.set |
/farmingadmin reset <player> <category> | Reinicia una categoría de un jugador | survivalcore.farming.admin.set |
/farmingadmin info <player> | Muestra las cuentas y niveles de un jugador | survivalcore.farming.admin |
/reclaim | Abre el menú de reclamaciones | exyliasurvivalcore.reclaim |
/reclaimadmin | Imprime la línea de uso | exyliasurvivalcore.reclaim.admin |
/reclaimadmin resetsection <player> <section> | Deja que un jugador vuelva a reclamar esa sección | exyliasurvivalcore.reclaim.admin |
/missions | Abre tus misiones diarias y semanales | exyliasurvivalcore.missions |
/seasons | Abre el menú de temporadas | exyliasurvivalcore.seasons |
/seasonsadmin close <season> | Cierra una temporada | exyliasurvivalcore.seasons.admin |
/project | Abre el proyecto comunitario actual | exyliasurvivalcore.projects |
/project give | Entrega todo lo que el proyecto aún necesita desde tu inventario | exyliasurvivalcore.projects |
/projectadmin reset <project> [confirm] | Reinicia el progreso de un proyecto | exyliasurvivalcore.projects.admin |
/reputation [player] | Muestra una ficha de reputación | exyliasurvivalcore.reputation |
/reputation rate <deal> <up|down> | Valora un trato; es el destino de los botones de un aviso de trato | exyliasurvivalcore.reputation |
/reputation pending | Lista tus tratos pendientes de valorar | exyliasurvivalcore.reputation |
| Permiso | Quién lo tiene | Qué permite |
|---|---|---|
exyliasurvivalcore.stats | Todos | Tus propias estadísticas con `/stats` |
exyliasurvivalcore.stats.others | Todos | Las estadísticas de otros jugadores |
exyliasurvivalcore.rankup | Todos | El menú de rangos, subir de rango y el prestigio |
exyliasurvivalcore.farming | Todos | `/farming` |
exyliasurvivalcore.missions | Todos | `/missions` |
exyliasurvivalcore.boosters | Todos | `/boosters` |
exyliasurvivalcore.reputation | Todos | `/reputation` |
exyliasurvivalcore.projects | Todos | `/project` |
exyliasurvivalcore.seasons | Todos | `/seasons` |
exyliasurvivalcore.reclaim | Todos | `/reclaim` |
| Placeholder | Muestra | Ejemplo |
|---|---|---|
%exyliasurvivalcore_rankup_rank% | Nombre visible del rango actual, o un `None` gris | Miner |
%exyliasurvivalcore_rankup_rank_id% | Su id, o `none` | miner |
%exyliasurvivalcore_rankup_rank_order% | Su posición en la escalera, `0` sin rango | — |
%exyliasurvivalcore_rankup_next_rank% | Nombre visible del siguiente rango, o un `Max rank reached!` verde | Digger |
%exyliasurvivalcore_rankup_next_rank_id% | Su id, o `none` | — |
%exyliasurvivalcore_rankup_prestige% | Nivel de prestigio | 1 |
%exyliasurvivalcore_rankup_can_prestige% | `yes` si el prestigio está activado, el jugador está en el último rango y no ha llegado al tope de prestigio; `no` en otro caso | — |
%exyliasurvivalcore_rankup_can_rankup% | `yes` / `no` | yes |
%exyliasurvivalcore_rankup_ranks_total% | Rangos configurados | 12 |
%exyliasurvivalcore_rankup_requirements_total% | Requisitos que pide el siguiente rango | 3 |
%exyliasurvivalcore_rankup_requirements_met% | Cuántos de esos ya cumple | 2 |
%exyliasurvivalcore_rankup_progress_bar% | Esos dos dibujados como barra; llena cuando no hay siguiente rango | — |
Contadores que alimentan estos módulos
Cuentan en los contadores de estadísticas que leen las clasificaciones, las misiones y las temporadas; mira Estadísticas.
| Contador | Qué cuenta |
|---|---|
rankup.ranks | Rangos subidos, a mano o automáticamente |
rankup.prestiges | Prestigios hechos |
farming.harvested | Cada bloque o mob que contó una categoría de farming |
farming.<categoría>.harvested | Lo mismo, para una categoría |
reclaim.claimed | Secciones de reclaim ejecutadas |
reclaim.<sección>.claimed | Lo mismo, para una sección |
¿Falta algo en esta página? Dínoslo en Discord