Progression

Rankup

A ladder of ranks in modules/rankup/ranks.yml. Each one has requirements to meet and a reward for meeting them.

ranks:
  member:
    display-name: "&7Member"
    icon: COAL
    order: 1
    description: []
    requirements: []
    reward:
      commands: []
      broadcast: ""
      sound: ""
    auto-rankup: false

/rankup opens the ladder, showing what is met and what is not; /rankup claim takes the next rank when everything is satisfied. settings.auto-rankup promotes without asking, and a per-rank auto-rankup does the same for one rung.

Requirements

A requirement is a type and one field. Any entry may also carry display, which is the line shown in the menu instead of a generated one.

A money amount grows with prestige: it is multiplied by prestige.cost-multiplier once per prestige level the player holds, and the menu shows the amount they actually need.

Prestige

A player at the top of the ladder can prestige with /rankup prestige, or with the star in the corner of the /rankup menu. It charges the prestige cost, takes their rank away, raises their prestige level by one and runs the prestige rewards. They then climb the ladder again from the first rank, with every money requirement scaled to the new level.

The prestige section of modules/rankup/config.yml:

A prestige is refused when it is disabled, when the player is not on the last rank, when they are already at max-level, and when they cannot pay — including when cost is above 0 and no economy is available. The menu's star shows the current and next level, the cost (Free at 0) and which of those applies. %exyliasurvivalcore_rankup_can_prestige% answers yes or no.

/rankupadmin prestige <player> <level> sets a prestige level directly; /rankupadmin set and reset move a player around the ladder, and /rankupadmin info reports where they are. A rank id that is not in the file is refused.

settings.notify-on-login tells a player on join when they can rank up.

Playtime rewards

Rewards unlocked by time played, claimed from /playtime.

rewards:
  newcomer:   { display-name: "…", icon: …, required-playtime: "30m",  commands: [], auto-claim: false }
  first_hour: { required-playtime: "1h",  … }
  five_hours: { required-playtime: "5h",  … }
  veteran:    { required-playtime: "25h", … }
  legend:     { required-playtime: "100h", … }

Farming

Counts blocks broken or mobs killed, and pays per N and at milestones.

categories:
  wheat_farming:
    type: BLOCK
    display-name: "&eWheat"
    icon: WHEAT
    tracked: [WHEAT]
    require-max-growth: true
    count-above: false
    reward-every: 50
    reward:      { money: 2, commands: [], message: "", actionbar: "", sound: "" }
    milestones:
      novice: { display-name: "…", required-count: 100, money: 10, … }
    infinite-milestone:
      enabled: true
      interval: 1000
      money: 50

Every reward block — reward, each milestone and infinite-milestone — takes money, commands, message, actionbar and sound. money is paid in the default currency and multiplied by money boosters for farming (see Economy); %money% is what was paid, after boosters. The shipped categories pay through money rather than eco give commands.

/farming shows progress. /farmingadmin set, reset, resetall and info need survivalcore.farming.admin, and the three that write need survivalcore.farming.admin.set.

Reclaim

/reclaim runs a block of commands — a donor kit, a monthly crate, whatever you write. Sections are defined in modules/reclaim/config.yml.

sections:
  default:
    permission: exyliasurvivalcore.reclaim.default
    priority: 0
    each: "-1"
    broadcast: ""
    commands: []
  vip:
    permission: exyliasurvivalcore.reclaim.vip
    priority: 1
    each: "7d"
    commands: []

Sections are sorted by priority, highest first, and the first one whose permission the player holds is the one that runs. So a VIP gets the VIP section and nothing else, not both.

each is how often it may be run: -1 means once ever, and anything else is a duration — 7d, 12h, 30m, 45s. %player% is substituted into every command.

/reclaimadmin reset <player> and resetsection <player> <section> clear the record.

Counters

These four modules count into the stats counters, which leaderboards, missions and seasons read — see Statistics.