> ## Documentation Index
> Fetch the complete documentation index at: https://www.kitemc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Commands & Permissions

<span id="commands-permissions" />

This page lists all ArcPass commands and permission nodes.

<h2 id="command-aliases">
  Command Aliases
</h2>

The main command `/arcpass` supports these aliases:

* `/ap`
* `/battlepass`
* `/bp`
* `/pass`

<h2 id="player-commands">
  Player Commands
</h2>

| Command | Description | Permission |
| - | - | - |
| `/arcpass` | Open main interface | `arcpass.use` |
| `/arcpass help` | View help information | `arcpass.use` |
| `/arcpass level` | View level and XP | `arcpass.command.level` |
| `/arcpass quests` | View current quests | `arcpass.command.quests` |
| `/arcpass claim <level> [tier]` | Claim level reward | `arcpass.command.claim` |
| `/arcpass buy <tier>` | Purchase pass tier | `arcpass.command.buy` |
| `/arcpass leaderboard [type]` | View leaderboard | `arcpass.use` |
| `/arcpass top [type]` | View leaderboard (alias) | `arcpass.use` |
| `/arcpass rewards` | View available rewards | `arcpass.use` |

<h3 id="command-details">
  Command Details
</h3>

<h4 id="arcpass-level">
  /arcpass level
</h4>

Displays player's current pass status:

```
/arcpass level
```

Output example:

```
=== Pass Level ===
Current Level: 15
Total XP: 2500
Progress: 75/100 (75%)
Owned Tiers: Free, Premium
```

<h4 id="arcpass-claim">
  /arcpass claim
</h4>

Claim rewards for a specific level:

```
/arcpass claim <level> [tier]
```

* `level` - Level to claim (required)
* `tier` - Tier to claim, defaults to `free` (optional)

Examples:

```
/arcpass claim 10 free      # Claim level 10 free reward
/arcpass claim 10 premium   # Claim level 10 premium reward
```

<h4 id="arcpass-buy">
  /arcpass buy
</h4>

Purchase a pass tier:

```
/arcpass buy <tier>
```

Examples:

```
/arcpass buy premium   # Purchase premium pass
/arcpass buy vip       # Purchase VIP pass
```

<h4 id="arcpass-leaderboard">
  /arcpass leaderboard
</h4>

View leaderboards:

```
/arcpass leaderboard [type] [page]
```

Type options:

* `level` / `lvl` - Level ranking (default)
* `exp` / `experience` - XP ranking
* `season` - Season ranking

<h2 id="admin-commands">
  Admin Commands
</h2>

All admin commands require `arcpass.admin` permission.

| Command | Description |
| - | - |
| `/arcpass admin` | Open admin panel |
| `/arcpass admin help` | View admin help |
| `/arcpass admin reload` | Reload configuration |
| `/arcpass admin season start <name>` | Start new season |
| `/arcpass admin season end` | End current season |
| `/arcpass admin season info` | View season info |
| `/arcpass admin give <player> exp <amount>` | Give player XP |
| `/arcpass admin give <player> level <amount>` | Give player levels |
| `/arcpass admin set <player> tier <tier>` | Set player tier |
| `/arcpass admin reset <player>` | Reset player data |
| `/arcpass admin lookup <player>` | Query player data |
| `/arcpass admin quest complete <player> <quest_id>` | Complete quest |
| `/arcpass admin leaderboard refresh` | Refresh leaderboard cache |
| `/arcpass admin debug [toggle]` | Toggle debug mode |
| `/arcpass admin save` | Save all data |
| `/arcpass admin broadcast <message>` | Server broadcast |
| `/arcpass admin confirm` | Confirm pending dangerous action |
| `/arcpass admin cancel` | Cancel pending dangerous action |

<h3 id="admin-command-details">
  Admin Command Details
</h3>

<h4 id="arcpass-admin-season">
  /arcpass admin season
</h4>

Season management:

```bash theme={null}
# Start new season
/arcpass admin season start Season1

# End current season
/arcpass admin season end

# View season info
/arcpass admin season info
```

<Warning>
  **Dangerous Operation**

  Starting/ending seasons affects all player data. Confirmation required.
</Warning>

<h4 id="arcpass-admin-give">
  /arcpass admin give
</h4>

Give player XP or levels:

```bash theme={null}
# Give 1000 XP
/arcpass admin give Steve exp 1000

# Give 5 levels
/arcpass admin give Steve level 5
```

<h4 id="arcpass-admin-lookup">
  /arcpass admin lookup
</h4>

Query player data:

```
/arcpass admin lookup Steve
```

Output example:

```
=== Player Data: Steve ===
UUID: 12345678-1234-...
Level: 25
Total XP: 5000
Progress: 30/150
Owned Tiers: free, premium
Completed Quests: 42
Claimed Rewards: 38
```

<h2 id="permission-nodes">
  Permission Nodes
</h2>

<h3 id="player-permissions">
  Player Permissions
</h3>

| Permission | Description | Default |
| - | - | - |
| `arcpass.use` | Basic usage | true |
| `arcpass.command.level` | Use /arcpass level | true |
| `arcpass.command.quests` | Use /arcpass quests | true |
| `arcpass.command.claim` | Use /arcpass claim | true |
| `arcpass.command.buy` | Use /arcpass buy | true |
| `arcpass.command.*` | All player commands | op |

<h3 id="admin-permissions">
  Admin Permissions
</h3>

| Permission | Description | Default |
| - | - | - |
| `arcpass.admin` | All admin permissions | op |
| `arcpass.bypass.cooldown` | Bypass cooldowns | op |

<h3 id="luckperms-examples">
  LuckPerms Examples
</h3>

```bash theme={null}
# Grant basic usage
/lp group default permission set arcpass.use true

# Grant VIP group purchase permission
/lp group vip permission set arcpass.command.buy true

# Grant admin full permissions
/lp group admin permission set arcpass.admin true
```

<h2 id="tab-completion">
  Tab Completion
</h2>

ArcPass supports smart tab completion:

* Command arguments auto-complete
* Player names
* Tier/quest IDs
* Online player list

<h2 id="console-commands">
  Console Commands
</h2>

These commands can run from console:

```bash theme={null}
arcpass admin reload
arcpass admin season start TestSeason
arcpass admin give Steve exp 1000
arcpass admin lookup Steve
```

<Tip>
  Console dangerous operations skip GUI confirmation, requiring command confirmation via `/arcpass admin confirm`.
</Tip>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.