> For the complete documentation index, see [llms.txt](https://kynosdeveloping.gitbook.io/kynosdeveloping/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kynosdeveloping.gitbook.io/kynosdeveloping/kynosstaff/gui-overview.md).

# 🖥️ GUI Overview

KynosStaff is built around four interconnected GUI menus. All menus are opened via `/staffpanel` (or `/staff`) and navigated entirely with clicks — no commands needed once inside.

***

### Main Staff Panel

**Opens with:** `/staffpanel` **Size:** 6 rows (54 slots)

The hub of the plugin. It shows:

* **Your head** (top-left area) — click to open your own Auto-management menu
* **Online staff members** — each staff member with `kynosstaff.panel.use` appears as a player head
  * Left-click → teleport to them
  * Right-click → teleport them to you
* **Player List button** — opens the full player list
* **Global Chat Mute toggle** — shows current chat status; click to mute or unmute
* **Quick Patrol RTP** — teleports you to a random online player instantly
* **Pagination arrows** — navigate between pages if many staff members are online
* **Close button** — closes the menu

***

### Auto-management Menu

**Opens from:** your head in the Main Staff Panel **Size:** 6 rows (54 slots)

Your personal toolkit. Toggle and manage your own session state:

| Button                 | Action                                    |
| ---------------------- | ----------------------------------------- |
| ✈ Toggle Fly           | Enable or disable flight                  |
| 🛡 Toggle Godmode      | Enable or disable invulnerability         |
| 👁 Toggle Vanish       | Hide/show yourself from non-staff players |
| ☄ Get Troll Stick      | Receive a Knockback stick                 |
| 🔮 Toggle Night Vision | Enable/disable infinite night vision      |
| 🎲 Random Teleport     | Teleport to a random online player        |

Item slots, materials, and custom model data for each button are all configurable in `settings.yml`.

***

### Player List

**Opens from:** the Player List button in the Main Staff Panel **Size:** 6 rows (54 slots)

A paginated list of all online players (non-staff included). Each player appears as a player head.

* **Right-click** a head → opens the Player Management menu for that player

***

### Player Management Menu

**Opens from:** right-clicking a player in the Player List **Size:** 6 rows (54 slots)

Full moderation control over the selected player:

| Button               | Action                                 |
| -------------------- | -------------------------------------- |
| ➘ Teleport           | Teleport directly to the player        |
| ❄ Freeze Player      | Freeze or unfreeze the player          |
| 🔍 Inspect Inventory | Open and view the player's inventory   |
| 🔮 Open Enderchest   | Open and view the player's ender chest |
| 🚪 Kick Player       | Disconnect the player from the server  |
| ☠ Kill Player        | Instantly kill the player              |
| 🔇 Mute Player       | Opens the duration selection menu      |

> ⚠️ Staff members cannot be moderated from this menu. Attempting to open a management menu on another staff member (with `kynosstaff.panel.use`) will display an error message.

#### Mute Duration Selector

When clicking **Mute**, a secondary GUI opens showing the preset durations defined in `settings.yml`. Clicking a duration runs the configured command template (by default uses `tempmute`) on that player.

***

### Sound Feedback

Every GUI interaction plays a configurable sound. You can customize each one in `lang.yml` under `GuiSounds`:

| Event           | Default Sound            |
| --------------- | ------------------------ |
| Default click   | `UI_BUTTON_CLICK`        |
| Close menu      | `BLOCK_NOTE_BLOCK_CHIME` |
| Change page     | `BLOCK_NOTE_BLOCK_PLING` |
| Chat muted      | `ENTITY_VILLAGER_NO`     |
| Chat unmuted    | `ENTITY_VILLAGER_YES`    |
| Teleport action | `ENTITY_PLAYER_LEVELUP`  |
| Error action    | `ENTITY_ZOMBIE_AMBIENT`  |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://kynosdeveloping.gitbook.io/kynosdeveloping/kynosstaff/gui-overview.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.