DocsConfiguration —
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
| Activity | Default points | Example |
|---|---|---|
| Mining a block | 1 point | 1,000 blocks = 1,000 pts |
| Earning money | $1 = 0.1 points | $10,000 = 1,000 pts |
| Rankup | 1,000 points | Rankup to B = 1,000 pts |
| Prestige | 10,000 points | Prestige 1 = 10,000 pts |
| Clan contribution | $1 = 2 points | $5,000 deposit = 10,000 pts |
Season lifecycle
START → ACTIVE → (PAUSED → ACTIVE) → ENDED → (AUTO) START
- START: season created, timer running, point tracking active
- ACTIVE: players earn points, the leaderboard updates live
- PAUSED (optional): timer frozen, no points, end date adjusted
- ENDED: rewards handed out, data archived, backup created
- AUTO-START (if enabled): a new season 10 seconds later
Player commands
| Command | Aliases | Permission | Description |
|---|---|---|---|
/season | /seasons | pulseprison.season | Current season info |
/season info | pulseprison.season | Same information | |
/season top [page] | pulseprison.season | Leaderboard | |
/season rewards | pulseprison.season | Rewards | |
/season help | pulseprison.season | Help |
Admin commands
| Command | Permission | Description |
|---|---|---|
/season start [name] | pulseprison.season.admin | Start a new season |
/season pause | pulseprison.season.admin | Pause the active season |
/season resume | pulseprison.season.admin | Resume a paused season |
/season stop | pulseprison.season.admin | End the current season |
/season list | pulseprison.season.admin | List every season |
season reset confirm | Console only | Reset 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)