Docs

Seasons

Time limited competition where players earn points from several activities. At the end of each season, the top players get rewards.

Configuration — seasons.yml

yaml
storage:
  type: yml                  # "yml" or "database"
  auto-save-interval: 300    # seconds

settings:
  default-duration: 30       # days
  auto-start-next: true      # start the next season automatically
  reset-player-data: false   # reset data when a new season starts
  reset-options:
    ranks: false
    prestige: false
    balance: false
    tokens: false
    gems: false

points:
  blocks-mined: 1            # points per block
  money-earned: 0.1          # per dollar earned mining
  rankup: 1000               # per rankup
  prestige: 10000            # per prestige
  clan-contribution: 2       # per dollar deposited in the clan

rewards:
  1:
    display-name: "&6&l★ Season Champion"
    broadcast: true
    commands:
      - "give {player} diamond 128"
      - "give {player} emerald 64"
      - "eco give {player} money 100000"
  2:
    display-name: "&f&l★ Runner-Up"
    broadcast: true
    commands:
      - "give {player} diamond 96"
      - "give {player} emerald 48"
      - "eco give {player} money 75000"
  3:
    display-name: "&c&l★ Third Place"
    broadcast: true
    commands:
      - "give {player} diamond 64"
      - "give {player} emerald 32"
      - "eco give {player} money 50000"
  4-10:
    display-name: "&e⭐ Top 10"
    broadcast: false
    commands:
      - "give {player} diamond 32"
      - "eco give {player} money 25000"

naming:
  format: "Season {number}"
  custom-names: {}

Reward commands support {player}, {uuid}, {season}, {points} and {position}.

Point system

ActivityDefault pointsExample
Mining a block1 point1,000 blocks = 1,000 pts
Earning money$1 = 0.1 points$10,000 = 1,000 pts
Rankup1,000 pointsRankup to B = 1,000 pts
Prestige10,000 pointsPrestige 1 = 10,000 pts
Clan contribution$1 = 2 points$5,000 deposit = 10,000 pts

Season lifecycle

START → ACTIVE → (PAUSED → ACTIVE) → ENDED → (AUTO) START
  1. START: season created, timer running, point tracking active
  2. ACTIVE: players earn points, the leaderboard updates live
  3. PAUSED (optional): timer frozen, no points, end date adjusted
  4. ENDED: rewards handed out, data archived, backup created
  5. AUTO-START (if enabled): a new season 10 seconds later

Player commands

CommandAliasesPermissionDescription
/season/seasonspulseprison.seasonCurrent season info
/season infopulseprison.seasonSame information
/season top [page]pulseprison.seasonLeaderboard
/season rewardspulseprison.seasonRewards
/season helppulseprison.seasonHelp

Admin commands

CommandPermissionDescription
/season start [name]pulseprison.season.adminStart a new season
/season pausepulseprison.season.adminPause the active season
/season resumepulseprison.season.adminResume a paused season
/season stoppulseprison.season.adminEnd the current season
/season listpulseprison.season.adminList every season
season reset confirmConsole onlyReset every season's data (safety)

Season storage

  • YML: plugins/PulsePrison/seasons/season_{id}.yml
  • Backups: plugins/PulsePrison/seasons/backups/
  • Auto-save every 5 minutes (configurable)
Seasons | PulsePrison Core Docs