# Admin Panel

**Version:** 2.0.7 · **Opened with:** `/spadmin panel`

The admin panel "Season Pass Admin" edits everything of the Season Pass in game: the server settings, every season file, the players online and the server-wide XP event. It was rebuilt in 2.0.0 in the KyuubiSoft Goldfiligran look. Its texts follow the admin's language (all 9 bundled languages).

![Season Pass admin panel on the Tiers section](../../../../assets/season-pass/season-pass-admin.png)
*The admin panel on the Tiers section: grouped navigation with counts on the left, the tier list of the edited season on the right.*

## Opening the Panel

| Way | Requirement |
|-----|-------------|
| `/spadmin panel` | `ks.seasonpass.admin` (see [Permissions](./permissions)) |
| Tile **Season Pass Admin** in KyuubiSoft Core's `/ksadmin` hub | Core's `ks.admin` |
| A Core citizen with the ID `showcase_seasonpass` | only while KyuubiSoft Core runs in showcase mode; on any other server the citizen does not open the panel (since 2.0.7) |

The panel opens on **General**. On a Core showcase server every change is refused with "Blocked in showcase mode."; looking around works. For showcase visitors the **Players** section shows "Player data is hidden" and its search does not answer.

## Layout

- **Header:** the title, a subtitle such as "Editing: Season 1: Explorer · Active: Season 1: Explorer (running)", a status line for the result of the last action (green or red), **Reload** and the close button.
- **Navigation (left)** in three groups, with a count next to some entries:

| Group | Sections |
|-------|----------|
| Configuration | General, Season, Currency, Premium, XP sources (13), Prestige (number of prestige levels) |
| Management | Players (players online), Events (1 while an XP event runs) |
| Content | Tiers (number of tiers), Challenges (pool size), Shop (pool size) |

- **Reload** reloads `config.json`, all season files and the languages and sets up the currency again, like `/spadmin reload` (see [Configuration](./configuration#reloading)). Open editors are closed.

**How saving works:** every section has its own **Save** button and only saves its own fields; the season sections write the edited season file at once. On/off switches only take effect with that **Save**. Invalid input is not saved and the status line says why ("\"abc\" must be between 1 and 8."). Whole numbers in the section fields may be typed with thousands separators ("1.000" or "1,000", not in the reward editor), decimals with a dot or a comma. Deleting, ending a season and resetting a player need a second click ("Sure?").

**Edited season:** everything except General, Players and Events works on the season selected in the **Season** section, which does not have to be the running one. The panel starts with the running season (or the first one).

---

## General

Server-wide settings in `config.json`.

| Field | Saved to | Notes |
|-------|----------|-------|
| Server language | `language` | 9 languages; reloads the language files when changed |
| Debug output | `debug` | Detailed Season Pass logging |
| Progress HUD | `trackerHudEnabled` | Off hides the progress card for every player; the toasts stay |
| Auto-save interval (seconds) | `autoSaveIntervalSeconds` | 10 - 86400, takes effect after a restart |
| Give the item | `item.enabled` | |
| Item ID | `item.itemId` | Required |
| Hotbar slot (0 - 8) | `item.hotbarSlot` | |
| On first join / On every join | `item.giveOnFirstJoin` / `item.giveOnEveryJoin` | Both give the item on a join when the player has none |
| Delay (seconds) | `item.giveDelaySeconds` | 0 - 300 |

`enabled` and `timezone` have no field in the panel; change them in `config.json` and press **Reload**. While `enabled` is `false` the header shows the season as paused. See [Configuration](./configuration#configjson).

See [Configuration](./configuration).

---

## Season

- **Edited season:** dropdown of all loaded seasons. The line next to it says "Running", "Running · paused" or "Not running".
- **Stats** of the running season, counted over the players **online**: Players online, Avg. tier, With premium, Highest tier.
- **Data:** Name (required), Description, Start, End (`YYYY-MM-DD`, may be empty), Icon item, Accent colour (`#rrggbb`).
- **XP curve:** XP for tier 1 (1 - 10,000,000), Growth per tier (1.0 - 3.0), Daily limit, Full XP up to (soft cap), Afterwards (factor 0 - 1), Duration (days, 1 - 3650). The heading shows the total, e.g. "XP curve · 259.055 XP up to tier 40".
- **Buttons:** **Save**, **Start season** (when the edited season is not running; also sets up its currency), **New season**, **End season** (while a season runs; needs a second click: "Click again to end the running season – online players get their open rewards."). See [Seasons](./seasons#season-end-payout) for the payout.

**New season** creates `season_<n>.json` with the name `Season <n>` (e.g. `season_2.json`, "Season 2"), no tiers, challenges or offers, and selects it. The **End** field is the date on which the season ends by itself; **Start** and **Duration** are only stored. See [Seasons](./seasons#lifecycle).

---

## Currency

Saved to the edited season, then the currency is set up again at once.

| Field | Season key | Notes |
|-------|-----------|-------|
| Type | `currencyMode` | Internal, Item, Economy |
| Display name | `currencyName` | Required |
| Symbol item | `currencyIconItem` | |
| Currency item (for type Item) | `currencyItemId` | Required for Item and must exist in the game |
| Economy provider (for type Economy) | `economyProvider` | Optional |
| Tokens per XP ("XP give 1 token") | `seasonTokenXpRatio` | 1 - 1,000,000 |
| Keep leftover XP | `tokenXpCarryOver` | "Off: small XP gains (blocks, mobs) give no tokens. On: leftover XP is collected per player." |
| Bonus XP / Bonus tokens | `firstLoginBonusXp` / `firstLoginBonusTokens` | On the first join of the season |

---

## Premium

| Field | Season key | Range |
|-------|-----------|-------|
| Premium pass active | `premiumEnabled` | |
| Only granted by admins | `premiumCommandOnly` | |
| Hint text | `premiumHintText` | "Shown when buying is disabled, e.g. a Discord hint" |
| Price | `premiumCost` | 0 - 1,000,000,000 |
| Currency | `premiumCurrencyId` | Required; a KyuubiSoft Core currency ID such as `economy`, `item:Ingredient_Bar_Gold` or `season_tokens` |
| XP bonus | `premiumXpBoost` | 1.0 - 10.0 (x XP) |
| Daily challenges / Weekly challenges | `dailyChallengeSlots` / `weeklyChallengeSlots` | 1 - 5 |
| Premium daily / Premium weekly | `premiumDailyChallengeSlots` / `premiumWeeklyChallengeSlots` | 1 - 3 |
| Shop offers / Premium offers | `dailyShopSlots` / `premiumDailyShopSlots` | 1 - 8 |

The slot counts live here, under "Slots per player". See [Seasons](./seasons#premium-pass) for the currency IDs.

---

## XP sources

The 13 XP values of the edited season (0 - 1,000,000 each, 0 turns a source off): Block mined, Block placed, Monster defeated, Player defeated, Playtime per minute, Zone discovered, Plant harvested, Flower picked, Quest completed, Achievement unlocked, Daily login, Login streak per day, Streak counts up to (days). See [Seasons](./seasons#xp-sources).

:::note
Quest completed and Achievement unlocked are granted only when KyuubiSoft Quests or KyuubiSoft Achievements is installed. If one of them is missing, a hint in this section names the source and the mod it needs.
:::

---

## Prestige

- **Settings:** Prestige active, Highest level (0 - 1000, 0 = no limit), XP bonus per level (0 - 100 %; 0 counts as 5 %). **Save** stores these three.
- **Rewards per level:** a list "Prestige 1", "Prestige 2", ... with a summary of each level's rewards and **Edit** / **Delete**. **+ Level** adds the next level and opens it.
- **Editing a level** opens the [reward editor](#reward-editor) ("Rewards of prestige 2"); **Save** stores it, **Cancel** goes back.

---

## Players

Looks up an **online** player by name (button **Search** or Enter). Offline players cannot be edited here. Showcase visitors on a Core showcase server see "Player data is hidden" instead.

**Player card:** tier badge, name, "Online · Season 1: Explorer", Premium and prestige badges, and Tier, XP in this tier, Total XP, Season tokens, Unclaimed rewards and Daily challenges done.

| Action | Range | What it does |
|--------|-------|--------------|
| Give XP | 1 - 10,000,000 | Normal XP with boosts and caps, may raise the tier |
| Set tier | 0 - number of tiers | Sets the tier; the XP in the tier stays unchanged |
| Give tokens | 1 - 10,000,000 | Internal season tokens |
| Set prestige | 0 - 1000 | Sets the level, no rewards |
| Give XP booster | multiplier 1.0 - 10.0, 1 - 10,080 minutes | Replaces a running booster |
| Grant premium / Revoke premium | | Toggles the pass |
| Reset progress | | Second click needed; moves the season to the player's history and resets everything, like `/spadmin resetplayer` |

The player's HUD updates right away. The "Unclaimed rewards" count includes tiers with an empty track.

---

## Events

- **Double XP:** the state ("Running: 2x XP · 42:10 left" or "No XP event running."), Multiplier (1.1 - 10.0) and Duration (1 - 10,080 minutes), **Start** (**Restart** while one runs; replaces it) and **End event**. Same as `/spadmin doublexp` / `stopdoublexp`.
- **Season status:** "Season 1: Explorer is running" or "... is paused – no XP until resumed", with **Pause season** / **Resume season**.
- **Maintenance:** "New challenges reach online players within a minute."
  - **New daily challenges** / **New weekly challenges:** re-roll the lists of all online players at the next 60-second check. Players usually get the same challenges again with progress back at 0, see [Challenges](./challenges#rotation).
  - **Save player data:** saves the data of every online player now.

---

## Tiers

- **List:** "Season 1: Explorer · 30 tiers + 10 bonus tiers · each track can hold several rewards". Eight rows per page, each "Tier 5" or "Bonus 31" with its icon and "Free: Explorer Lootbag · Premium: Emote: Victory Dance", and **Edit** / **Delete**.
- **Warnings:** chips above the list name tiers with item IDs that do not exist in the game; such rows say "Item missing".
- **+ Tier** appends a standard tier (before the bonus tiers), **+ Bonus tier** appends a bonus tier; both open the new tier.
- **Delete** removes the tier; every later tier gets a number one lower (tier numbers are list positions). **+ Tier** in turn gives every bonus tier a number one higher.
- Players' claims follow both changes, so a claimed tier stays claimed under its new number (online players at once, others on their next join); the claim of a deleted tier is dropped. Only changes made here are tracked, not edits in the web editor or in the file. See [Seasons](./seasons#tiers).
- **Editing a tier** ("Edit Tier 5"): Tier icon (item ID, optional) and a [reward editor](#reward-editor) each for **Free** and **Premium**.

---

## Challenges

- **Filters:** Daily · 16, Weekly · 12, Premium · 8 (the `premiumOnly` challenges of both pools).
- **List:** eight rows per page with name, icon, "Mob Kill · 10 · +150 XP, +8 Tokens", the weight, and **Edit** / **Delete**. Rows of challenges whose type is never counted are flagged "Never counted", unknown icons "Item missing"; chips above the list sum these up ("Type \"items_collected\" is never counted – 1 challenge(s) can never be completed.").
- **+ Challenge** adds "New Challenge" (Break Block, 50, +100 XP, +5 tokens) to the daily or weekly pool of the current filter (Premium adds a daily premium challenge) and opens it.
- **Editor:** ID (unique across both pools), Name, Description, Type (dropdown; types that are never counted are marked "(!)"), Target (default `any`), Count, XP, Tokens, Weight, Icon item, Premium only. The pool cannot be changed in the editor. `descriptionKey` can only be set in the file.

See [Challenges](./challenges).

---

## Shop

- **Filters:** Daily offer and Premium offer, with the number of offers. The hint names how many offers each player sees ("each player sees 4 daily and 2 premium offers").
- **List:** eight rows per page with name, icon, contents summary, rarity, weight, price, and **Edit** / **Delete**.
- **+ Offer** adds "New Offer" (50, 10 Gold Ingots) to the current filter and opens it.
- **Editor:** ID, Name, Description, Icon item, Price (1 - 10,000,000), Weight (1 - 10,000), Rarity, Premium only, and the contents as a [reward editor](#reward-editor). An offer needs at least one reward.

See [Token Shop](./shop).

---

## Reward editor

Used for both tracks of a tier, shop offers and prestige levels. It shows up to **four rewards**; rewards beyond the fourth are kept unchanged ("2 more reward(s) beyond the four shown are kept unchanged.").

| Column | Meaning |
|--------|---------|
| Type | Item, Tokens, Lootbag, Command, Booster, None |
| Item / ID / command / multiplier | Item: item ID. Lootbag: lootbag ID. Command: the command (a leading `/` is removed). Booster: the multiplier (1.0 - 10.0). Tokens: empty |
| Amount | Item: amount. Tokens: number of tokens. Booster: minutes (1 - 10,080) |
| Icon | Icon item (optional) |
| Display name | `description` |
| Rarity | Common to Legendary |

**+ Reward** adds a row (an item reward with 1 Gold Ingot), the button at the end of a row removes it, and type **None** removes a row when saving.

:::caution[Command rewards need the console right]
Command rewards run as the server console. Since 2.0.3, adding, changing or removing one needs `ks.core.admin.dialog.console` (KyuubiSoft Core's console right, the same as for console commands in the NPC window and the shop editor) in addition to `ks.seasonpass.admin`. Without it:

- a command reward is shown read-only with a hint: type and command are locked and it has no delete button; display name, icon and rarity stay editable,
- **Command** is not offered as a type for other rows,
- tiers, shop offers and prestige levels that hold command rewards cannot be deleted.

The server checks again when saving or deleting. Existing command rewards keep working. Web editor imports follow the same rule (with Core 2.9.2 or newer): without the right, command rewards in an imported season file stay as they are and Core tells the editor owner in chat which reward lists were kept.
::: Unknown item IDs are listed in a warning chip ("Unknown items: ... – players would receive nothing / no icon is shown.") and in the save message; the reward is saved anyway. See [Rewards](./rewards).