# Admin Panel

# Admin Panel

Open the admin panel with `/ksvoice admin panel`. Requires the `kyuubisoft.voicehub.admin` permission.

The panel uses a two-panel layout with a sidebar for navigation.

## Sidebar Tabs

### Channels Tab

**Dashboard** — real-time statistics:
- Active channels count
- Total voice users
- Online players
- Voice module status (ON/OFF)
- Currently banned players

**Proximity Settings** — adjust live without restart:
- **Range** — maximum hearing distance in blocks
- **Volume** — full-volume distance in blocks
- Click **Apply** to save changes

**Channel List** — all channels on the server:
- Name, type, owner, member count, flags
- Click a channel to see details in the right panel
- **X** button to delete a channel (members are moved to default channel)

### Blacklist Tab

**Ban Form** — voice-ban a player:
- Enter player name and duration in minutes
- Click **Ban** — player is immediately kicked from their channel, muted, and moved to default
- Player receives a chat notification with ban duration

**Banned Players List** — all currently banned players:
- Player name and remaining time
- **Unban** button for immediate removal
- Bans expire automatically

## Right Panel: Channel Detail

When a channel is selected in the Channels tab:
- Channel name, ID, description, type, owner
- Member count, custom range, flags
- Scrollable member list with roles ([O] Owner, [M] Mod)
- **Join (Admin)** button — bypasses password and invite-only restrictions

## Admin Bypass

Admins can join any channel without password or invite restrictions, both through the admin panel and the regular channel browser UI.