Configuration guide

Battle-Pass

Build a Standard pass and a Premium pass, set their cost, tiers and rewards, let the AI Assistant draft them for you, and manage player progress between wipes. This page covers every setting and admin tool.

Time
15 minutes
You need
Manage Server (website) or Owner, Co-Owner, Head Admin (Discord)
Applies to
Per Rust server

Overview

Each Rust server can offer two passes: a Standard Pass and a Premium Pass. Players earn points from kills, unlock tiers, and claim or sell the rewards. You set up the passes, tiers and rewards here. Players only need /battle-pass buy and /battle-pass view.

Before you start
  • Players must be linked (Account Linking) to earn points.
  • Rewards that give a kit need the kit to exist first (Kits).
  • A Premium role requirement needs the Discord role to exist first.

Setup & Configuration

On the website
  • Log in to the RustyWorks website, open Servers Configure, pick your server and select Battle-Pass.
  • Pick your server. The page has these tabs: Settings, Standard Pass, Premium Pass, AI Assistant, Players and Admin Tools. Each pass and its tiers are on its own tab. The AI Assistant tab only appears when the bot has the AI switched on.
In Discord
  • Run /battle-pass config and pick the server. A wizard lets you edit the passes and tiers. Tiers use the same fields as the website.

Global settings

Setting What it does Default
Battle-Pass Enabled Master switch. Turns the whole system off when unticked Off until you save
Allow Buying Both Passes When off, a player can only own one pass type per server Off

Pass settings

Both passes have the same settings. The Premium Pass also has a role requirement.

Setting What it does Limits and default
Enabled Turns this pass on or off
Pass Name The name players see Up to 64 characters. Standard Pass / Premium Pass
Purchase Cost Currency price. 0 makes the pass free Whole number, 0 or more
Total Tiers How many tiers the pass can have 1 to 100. Default 10
Kill Value Points added per kill 1 or more. Default 1
Required Discord Role (Premium only) Players must hold this role to buy the Premium Pass Optional

Kill Value doubles while a Double XP event has Battle-Pass Progression ticked. Press Save Settings to apply.

Tiers

Press Add Tier under a pass. Use Edit or Delete on a tier to change it. Deleting a tier cannot be undone.

Field What it does Limits
Tier Number The position of the tier. Must be unique per pass. Saving an existing number overwrites that tier 1 to 100
Tier Name The name players see Up to 128 characters. Required
Kills Required The total points a player needs to unlock the tier. This is cumulative, not per tier 0 or more
Sell Value What a player gets for selling the unlocked tier to the bot See below
Rewards One reward per line. At least one is required Up to 4

Sell Value:

Value Meaning
A number That exact price
0 Automatic: tier number × 250
-1 The tier cannot be sold

Reward lines

Write one reward per line. The five quick-insert buttons (Wallet, Bank, Role, Kit, Items) add the right format for you.

Line What it gives
WALLET:5000 5,000 into the player's Wallet
BANK:5000 5,000 into the player's Bank
ROLEID:123456789012345678 A Discord role
kit givetoplayer "kitname" "{USER}" A kit. The kit name comes first, then the player. Use Quick-insert a kit to pick one
inventory.giveto "{USER}" "wood" "5000" Any RCON command. {USER} is replaced with the player's gamertag
Any RCON command containing {COORDS} For example spawn recycler_static {COORDS} (a Custom Recycler). The player is asked to stand where they want it first
Test a pass before launch

Add a tier with a low Kills Required, buy the pass yourself, and claim it. Use Set Exact Tier to reset yourself afterwards.

AI Assistant tab

Describe the Battle-Pass you want in the chat box, for example how many tiers each pass has, what they cost and what the rewards are. The AI drafts both passes: tier names, points, buy-back, pass costs and rewards of currency, kits, roles, items, a Custom Recycler, and give or say commands. You can keep chatting to change the draft ("make Premium harder", "add a recycler at tier 20").

Nothing is saved until you press Apply

The Draft preview shows what the AI built. It only reaches your server when you press Apply to server. Player progress is never changed.

Control What it does
Send Sends your message. Enter sends, Shift+Enter starts a new line. Messages can be up to 1,500 characters
Undo last AI change Steps the draft back one change before you apply it
Apply to server Saves the draft as your Battle-Pass. If the AI left something out, a warning lists it and you can still apply
Reset to saved Throws the draft away and shows your saved Battle-Pass again
Undo last Apply Puts the Battle-Pass back how it was before the last Apply. The last 10 Applies are kept

If your Battle-Pass changed somewhere else after you started a draft, the tab warns you that applying will overwrite those changes. Tiers you wrote by hand keep the reward lines you gave them.

What the AI may use

The AI can only give out the kits and roles you tick in the What the AI may use box, and nothing is ticked to start with. Press Grab kits to read the kit list from your Rust server, search, tick the ones it may use and press Save choices. Untick all clears every tick.

Do not tick staff or Administrator roles

Anything you tick can end up as a reward on a tier that players claim.

Items come from the Kit Builder's item list, so item names are always right. An item that is not on the list is left out and the AI suggests the closest match. The AI also tries to mix its rewards up: weapons with their ammo, armour sets, bulk resources, kits spread across the pass and its own tier names. If a pass comes out too samey, it makes one more attempt before showing the draft.

Players tab

Pick Standard Pass or Premium Pass and search by gamertag to see each player's points and tier. The list shows 50 players per page.

Admin Tools tab

Tool What it does
Add Points Adds to a player's points. They may get a message about newly unlocked tiers
Remove Points Removes points and re-locks any claimed tiers above the new total
Set Exact Tier Jumps a player to a tier and re-locks claims above it
Set Tier for ALL Players Does the same for every player on a pass. Enter 0 to fully reset everyone
Reset Season Wipes all player progress and claim history for a pass. Tiers are kept. Use this between wipes
Remove Entire Pass Deletes the pass with all its tiers, progress and claim history. Asks for confirmation twice. Cannot be undone

The player must already own the pass for the single-player tools to find them.

Commands & Usage

Command What it does Who can use it
/battle-pass config Opens the admin wizard Owner, Co-Owner, Head Admin
/battle-pass buy Buys a pass Members
/battle-pass view Shows points and tiers and lets players claim or sell Members

Troubleshooting

Problem Cause Fix
Players cannot buy a pass Battle-Pass or that pass is disabled, or they lack the Premium role Check Enabled and Required Discord Role
A player earns no points They are not linked, or do not own the pass Link with /user link. Buy the pass
"Tier name is required" or "At least one reward is required" A tier was saved without these Fill them in
A kit reward fails The kit was renamed or deleted Edit the tier and pick the kit again
A {COORDS} reward does nothing The player did not confirm their position They stand where they want it and confirm
Admin tool says the player does not own the pass They have not bought it They must buy the pass first
There is no AI Assistant tab The AI is not switched on for this bot Ask the bot owner to set it up. Everything else on the page works without it
The AI says it cannot use a kit or role It is not ticked in What the AI may use Press Grab kits, tick it and press Save choices
The AI left an item out The item name is not on the Kit Builder's item list Use the closest match it suggests, or add the reward line by hand
The kit reward does nothing when a player claims it An older AI draft wrote the kit line with the player and kit name the wrong way round Edit the tier so the line reads kit givetoplayer "kitname" "{USER}", or ask the AI to redo it

Checked against RustyWorks on 1 Nov 2026.

Stuck on this step?

Tell us which setting you are on and what the bot said, and paste a screenshot if you can. Staff in the support Discord can usually fix it in a minute.