Overview

SeasonPass is a full battle pass for Rust. A free track and a premium track, tiers your players climb by playing, daily and weekly challenges, and a season that rolls over on wipe.

The hard part of a battle pass is not the panel. It is the tuning. Almost every pass ever configured is either so slow nobody finishes or so fast it is over in four days, and the owner does not find out until the season has already ended.

SeasonPass measures itself. It tells each player how long the season will actually take them at the rate they are playing, and it tells you — from your own server's data — the median tier reached, the percentage of players finishing, and whether your curve is achievable at all. That is the part no other pass ships, and it is the reason this one is worth installing over the one you are already running.

Three templates ship with it, and they are three genuinely different interfaces — different layout, different chrome, different structure — not one panel in three colours.

Free, MIT, no dependencies. Works on a bare server with nothing else installed.

Features

• Free track and premium track, unlimited rewards on every tier
• 1 to 200 tiers, added one at a time or generated with an XP curve
• Three complete templates: The Runway, The Field Manual, The Ascent
• Live completion estimate — every player sees how long the season will take them
• Catch-up XP so players who join late or fall behind can still finish
• Admin health readout built from real server data, not guesswork
• 20 XP sources, each with its own value, on/off switch and daily cap
• Daily, weekly and season-long challenges drawn from a pool you write
• Every reward switches between an item, a server command and a currency payout with one button
• Economics and ServerRewards built in for both buying premium and paying rewards out
• Or scrap, any item, or your own economy plugin through three hook names
• Items support amount, skin, custom name and blueprints
• Retroactive premium — buying at tier 40 grants the first 39 too, on by default
• Premium XP multiplier and extra daily challenges
• Anti-farm caps: per source, per hour, per day
• Rewards that do not fit go to a holding area, never destroyed
• Season rolls on wipe, with reset, keep or carry-over behaviour
• Every visible string editable in game, unlimited languages, player language switcher
• Full in-game editor. Nothing needs a config file
• Free, MIT, no dependencies

Pacing, and why it matters more than the panel

This is the section worth reading before anything else, because it is where passes fail.

A battle pass has one number that decides whether it works: how many hours it takes a normal player to finish. Set it too high and players do the maths, realise they cannot get there, and stop caring by day three. Set it too low and the whole thing is over before the wipe is.

Nearly every pass leaves you to guess that number. SeasonPass calculates it three different ways.

1. Every player sees their own estimate

The panel shows a line like “finishes in 14 days at your rate”, worked out from that player's own XP history — not an average, not a guess. It is honest, and it is the number that decides whether they keep playing.

2. Players who fall behind earn more

Anyone more than a few tiers below the expected pace for the day earns bonus XP, scaling with how far behind they are, up to a ceiling you set. Late joiners are the single biggest source of churn on a seasonal system, and this is the fix.

3. You get told the truth about your own curve

Run pass.health and you get a readout built from your server, not from defaults:

SeasonPass health
  season 1 - 30 tiers, 70,200 XP total
  ends: 29d 23h
  players this season: 42
  median tier: 11
  finished: 3  (7%)
  loaded 240 min ago
  XP sources that have fired since load: 18 of 20

If more than a handful of players are in and nobody has finished, it says so directly. Most owners have no idea their pass is untunable until the season is already over.

The three templates

Pick one in the LAYOUT room and the entire pass is rebuilt. These are not colour schemes — the header, the tier rail, the reward cards, the progress display and the whole layout are different.

Every template is fully skinned — free and premium tracks, locked and claimable states, milestone tiers, challenges, the estimate line and the premium offer all have their own treatment in each one.

XP sources

Twenty sources ship enabled with sane values. Every one has its own XP amount, an on/off switch, and an optional daily cap.

Any other plugin can feed the pass with one call, so an event, an arena or a custom minigame can grant XP without SeasonPass needing to know it exists.

Challenges

Three pools, each with its own reset. Challenges are drawn at random from the pool you write, so no two players get the same list.

Each challenge has its own text, target, XP reward and difficulty. Because challenges are built on the same source list as XP, anything that can grant XP can also be a challenge — kill 20 scientists, gather 5,000 sulfur, upgrade 40 blocks to stone.

Premium accounts can be given extra daily challenges on top.

Rewards

Every reward on every tier switches between three kinds with one button.

Currency payouts are configured separately from the premium price, so premium can cost scrap while a tier pays out coins. The editor shows a live tick next to each currency confirming that plugin is actually loaded, so a typo is visible immediately rather than at claim time.

If a reward will not fit — a full inventory, or a currency plugin that is temporarily unloaded — it goes to a holding area and the player collects it later. Nothing is ever destroyed.

Premium

Premium can be granted by permission, bought in game, or both.

• Price in scrap, any item, Economics, ServerRewards, or your own plugin
• Retroactive unlock, on by default — buying at tier 40 grants every premium reward from the first 39
• Premium XP multiplier, default 1.25×
• Extra daily challenges for premium accounts
• Premium resets each season, or carries, your choice
• Admin command to grant it to anyone

The editor

Type /pass, press EDIT, and everything is in there. Eight rooms:

Nothing in the editor requires a config file, a server restart or a plugin reload. Changes apply on the spot.

Text and languages

Every visible string is editable in game and stored per language. Add as many languages as you like, and let players switch with a button in the header if you want them to.

Nothing is hardcoded — tier labels, button text, the estimate line, chat messages, the premium offer, all of it.

Commands and permissions

Setup

1. Drop SeasonPass.cs into oxide/plugins/
2. Grant yourself the editor with oxide.grant group admin seasonpass.admin
3. Type /pass and press EDIT

A thirty tier season is generated on first load with rewards on both tracks, so there is a working pass to look at immediately. Tiers, players and translations live in oxide/data/SeasonPass/, everything else in the config file, and all of it is editable from the panel.

Developer API

[PluginReference] private Plugin SeasonPass;

SeasonPass?.Call("OpenPass", player);
SeasonPass?.Call("ClosePass", player);
SeasonPass?.Call("GetTier", player);        // int
SeasonPass?.Call("GetXp", player);          // int
SeasonPass?.Call("IsPremium", player);      // bool
SeasonPass?.Call("GetTierCount");           // int
SeasonPass?.Call("GetSeasonName");          // string

SeasonPass?.Call("AwardXp", player, 250, "my-event");

AwardXp is the important one. Any plugin can feed the pass with a flat XP amount and a source tag, so an event, an arena or a minigame can grant progress without SeasonPass knowing it exists. There is also SeasonPassAward, which takes a source key and a unit count and applies that source's configured value and caps.

Four hooks fire:

void OnSeasonPassTierUp(BasePlayer player, int tier) { }
void OnSeasonPassClaim(BasePlayer player, int tier, bool premium) { }
void OnSeasonPassPremium(BasePlayer player) { }
void OnSeasonPassEnd(int finished) { }

Compatibility

Oxide and Carbon. No dependencies. Economics, ServerRewards and Notify are optional and detected automatically.

The class is named SeasonPass specifically so it can sit alongside the paid BattlePass plugin without colliding, if you want to run them side by side while you switch over.

Every visual effect is a setting, so if anything renders oddly on an unusual build you can switch it off. The symbols used in the interface are configurable characters, so if your server's font renders one as a box you can replace it with anything you like.