Docs

Ranks and prestige

Each rank has a money cost, blocks mined and pickaxe level requirements, and commands that run on rankup. The rank and prestige sell multipliers live in prices.yml.

Module: rankup-system.

ranks.yml

yaml
ranks:
  A:
    next: B
    cost: 1000
    required-blocks: 500
    required-level: 0
    position: 1
    execute-on-rankup:
      - "broadcast &e{player} &aranked up to &e{rank}!"
      - "give {player} diamond 5"

  B:
    next: C
    cost: 2500
    required-blocks: 1500
    required-level: 5
    position: 2
    execute-on-rankup:
      - "broadcast &e{player} &aranked up to &e{rank}!"
      - "give {player} diamond 10"

  C:
    next: D
    cost: 5000
    required-blocks: 3000
    required-level: 10
    position: 3
    execute-on-rankup:
      - "broadcast &e{player} &aranked up to &e{rank}!"
      - "give {player} diamond 15"

  D:
    next: E
    cost: 10000
    required-blocks: 5000
    required-level: 20
    position: 4
    execute-on-rankup:
      - "broadcast &e{player} &aranked up to &e{rank}!"
      - "give {player} diamond 20"

  E:
    next: PRESTIGE
    cost: 25000
    required-blocks: 10000
    required-level: 30
    position: 5
    execute-on-rankup:
      - "broadcast &6&l{player} &aranked up to &e{rank}!"
      - "give {player} diamond 30"

prestige:
  cost: 50000
  required-rank: E
  reset-to: A
  rewards:
    - "give {player} diamond 64"
    - "give {player} emerald 32"

Default progression

The requirements of a rankup are those of the rank you move to: going from A to B uses the cost, required-blocks and required-level of B. Blocks are the total mined shown by the pickaxe (/pickaxe), so /rankup info and the pickaxe always match.

RankupCostBlocks mined (total)Pickaxe levelRewards (execute-on-rankup of the target)
A → B$2,5001,500510 diamonds
B → C$5,0003,0001015 diamonds
C → D$10,0005,0002020 diamonds
D → E$25,00010,0003030 diamonds
E → PRESTIGE$50,000 (prestige.cost)64 diamonds + 32 emeralds

The values of A only apply on first join (A is the starting rank).

Prestige

  • Requires rank E (the last one)
  • Cost: $50,000
  • Resets your rank to A
  • Raises your prestige level
  • Sell multipliers grow with every prestige
  • Server wide broadcast

Prestige multipliers

PrestigeMultiplierWith rank E (×1.25)
0×1.00×1.25
1×1.10×1.375
2×1.20×1.50
3×1.35×1.6875
4×1.50×1.875
5×1.75×2.1875

Automatic rankup

Rankup is automatic by default. Every check-interval-ticks, online players who have it on are checked and, if they meet the requirements, climb every rank they can afford at once. Each player can turn it off with /rankup auto off, and the preference is saved.

yaml
# config.yml
rankup:
  auto:
    enabled: true              # master switch; when false /rankup auto is hidden
    default: true              # starting state for players who never used /rankup auto
    check-interval-ticks: 40   # every 2 seconds
    broadcast-after-ranks: 10  # only announce jumps of 10+ ranks

Manual and automatic rankups use exactly the same checks and charges.

Commands

CommandAliasesPermissionDescription
/rankup/rupulseprison.rankupRank up once
/rankup maxpulseprison.rankupClimb every rank you can afford
/rankup auto [on|off]pulseprison.rankupToggle automatic rankup
/rankup info/rankup progresspulseprison.rankupMoney, blocks and pickaxe level still missing
/rankup list/rankup rankspulseprison.rankupFull rank ladder
/rankup helppulseprison.rankupHelp
/prestige/prestgpulseprison.prestigePrestige (requires rank E + $50K)
/rebirth/rb, /renacerpulseprison.rebirthThird progression tier. See Rebirth
/ranks · /rankup menuRank menu (menus/ranks.yml)

Rank mines

Mines created with /mine create <id> <rank> can only be mined and visited from that rank. See Mines.

Ranks and prestige | PulsePrison Core Docs