# Permissions

**Version:** 2.0.7

Season Pass checks two permission nodes with Hytale's permission system. Command syntax is on the [Commands](./commands) page.

## Permission Nodes

| Permission | Default | Gates |
|------------|---------|-------|
| `ks.seasonpass.user.use` | allowed | `/ksseasonpass open`, `info` and `buy` (aliases `sp`, `seasonpass`, `battlepass`) |
| `ks.seasonpass.admin` | not granted | `/ksseasonpassadmin` (alias `spadmin`) and every subcommand |
| `ks.core.admin.dialog.console` | not granted | KyuubiSoft Core's console right. Needed in addition to the admin access to add, change or remove **command rewards** in the admin panel, to delete tiers, shop offers and prestige levels that hold them, and for web editor imports that change them. See [Admin Panel](./admin-panel#reward-editor) |

**How the defaults work:**

- `ks.seasonpass.user.use` is checked as "allowed unless set". Every player can use the player commands; set the node to `false` to block a player or group ("No permission.").
- `ks.seasonpass.admin` alone is enough for `/spadmin` and all its subcommands; players without it cannot use the command. The old node `seasonpass.admin`, which versions before 2.0.0 also required, is no longer checked; you can remove it.
- The console needs no permission.

## What the Nodes Do Not Cover

- **The Season Pass item** has no permission check: whoever right-clicks it opens the book, also without `ks.seasonpass.user.use`. The same goes for a Core citizen with the ID `showcase_seasonpassplayer`.
- **The admin panel** itself has no permission check. It opens through:
  - `/spadmin panel` (`ks.seasonpass.admin`),
  - the **Season Pass Admin** tile in KyuubiSoft Core's `/ksadmin` hub, which is gated by Core's `ks.admin` node, not by the Season Pass nodes,
  - a Core citizen with the ID `showcase_seasonpass`, for **everyone** who talks to it, but only while KyuubiSoft Core runs in showcase mode. On any other server that citizen does not open the panel (since 2.0.7; before, it opened the panel on every server).
- **Showcase servers:** with KyuubiSoft Core's showcase mode, every change is refused for players, also for admins: all `/spadmin` subcommands except `panel` (they answer "You do not have permission for this command."), and every save, start, end, reset and grant in the admin panel ("Blocked in showcase mode."). The console is not affected.

## LuckPerms Examples

### Staff gets the admin tools

```
/lp group admin permission set ks.seasonpass.admin true
```

### A single player

```
/lp user Steve permission set ks.seasonpass.admin true
```

### No Season Pass commands for a group

```
/lp group guest permission set ks.seasonpass.user.use false
```

Players of that group can still open the book with the Season Pass item. To keep them away completely, set `item.enabled` to `false` in `config.json` and take the item away.

### Everything default (no setup)

Nothing to do for players. For admins, add `ks.seasonpass.admin`, or use an account with `*`.