> For the complete documentation index, see [llms.txt](https://k0ssek-scripts.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://k0ssek-scripts.gitbook.io/docs/scripts/easter-event/admin-panel.md).

# Admin Panel

The panel, its tabs and the admin commands.

## Opening the panel

Press **F10** or use the `/easteradmin` command. The same key or command closes it. The default key is set in `Config.Keybinds.adminPanel`.

The panel opens only for admins. Who counts as an admin depends on the framework, see [Installation](/docs/scripts/easter-event/installation.md). Every action in the panel is checked again on the server.

The data in the panel refreshes every 5 seconds while it is open.

## Header buttons

| Button                           | What it does                                                                                                                                                                            |
| -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Disable Event / Enable Event** | Pauses or resumes the scheduled boss spawns and the scheduled egg spawner until the next restart. Manual spawns from the panel and the commands still work while the event is disabled. |
| **Spawn Boss**                   | Spawns the boss at a random one of the configured locations. Does nothing if a boss is already alive.                                                                                   |
| **Kill Boss**                    | Removes the boss. Nobody gets the last-hit reward.                                                                                                                                      |

## Tabs

### Overview

| Card             | Shows                                                    |
| ---------------- | -------------------------------------------------------- |
| Eggs collected   | Eggs picked up and rabbits caught, all players, all time |
| Eggs opened      | Eggs opened, all time                                    |
| Shells exchanged | Eggshells handed to the trader, all time                 |
| Active objects   | Rabbits and eggs that are on the map right now           |

Below the cards:

* **Boss**: active or waiting, current health, position, the time of the next scheduled spawn, and a **Teleport to Boss** button.
* **Top 3 Collectors**.

### Spawner

**Spawner info** shows the current settings: status, schedule, active objects against the limit, despawn time, rabbit chance, pickup range and number of zones.

**Spawn in zone**

* Pick a zone and a count (1 to 20), then click **Spawn**. Each object is an egg or a rabbit, decided by `Config.Spawner.rabbitChance`.
* **Teleport** takes you to the centre of the selected zone.

Manual spawns ignore the `maxActive` and `maxPerZone` limits.

**Spawn at me**

* **Rabbit** or **Egg** spawns one object at your position. It is visible to every player nearby, also outside the zones.

**Give items to player**

* Enter a server ID and click **Common Egg** or **Rare Egg**. The player receives one egg per click.

### Players

A list of everyone who took part, with search by name or ID. Click a column to sort. The list shows up to 50 players at a time.

| Column      | Description                                   |
| ----------- | --------------------------------------------- |
| ID          | Server ID. Empty for players who are offline. |
| Name        | Player name                                   |
| Eggs        | Eggs picked up and rabbits caught             |
| Eggs opened | Eggs opened                                   |
| Tackles     | Hits on the boss                              |
| Shells      | Eggshells exchanged at the trader             |

### Loot

Both loot tables (common egg and rare egg) with the drop chance of every item, calculated from the weights in the config.

## Commands

All commands are for admins only.

| Command                         | Where            | What it does                                                 |
| ------------------------------- | ---------------- | ------------------------------------------------------------ |
| `/easteradmin`                  | In game          | Opens or closes the admin panel.                             |
| `/scoreboardedit`               | In game          | Starts the scoreboard placement tool.                        |
| `/spawnrabbit`                  | In game          | Spawns a rabbit at your position.                            |
| `/spawnrabbit boss`             | In game, console | Spawns the boss.                                             |
| `/easterspawntick`              | In game, console | Runs one spawner tick now, without waiting for the schedule. |
| `/easterspawns [egg or rabbit]` | In game, console | Prints every active object to the server console.            |

### /spawnrabbit

* `/spawnrabbit` spawns a normal rabbit at your position. It is visible to every player nearby, also outside the zones.
* `/spawnrabbit boss` spawns the boss at your position. From the server console it spawns the boss at a random configured location.

### /easterspawntick

Spawns one batch with the same rules as the schedule (`spawnBatch`, `spawnMode`, `maxActive`, `maxPerZone`) and reports how many objects were created. Useful for testing your zones. It also works while the event is disabled.

### /easterspawns

Prints one line per object to the **server console**: type, ID, coordinates, zone and age in seconds. Add `egg` or `rabbit` to list only one type.

### /scoreboardedit

Lets you move the scoreboard in game and prints the values for the config.

| Key                    | Action                                 |
| ---------------------- | -------------------------------------- |
| **W A S D**            | Move the board, relative to the camera |
| **Arrow up / down**    | Move the board up or down              |
| **Arrow left / right** | Rotate the board                       |
| **Scroll**             | Change the width                       |
| **Shift + Scroll**     | Change the height                      |
| **Shift** (hold)       | Move and rotate 5 times faster         |
| **Enter**              | Confirm                                |
| **Backspace**          | Cancel                                 |

On **Enter** the new values are printed to your F8 console. Copy `coords`, `heading`, `width` and `height` into `Config.Scoreboard` in `config/shared.lua` and restart the resource. The board does not move for other players until you do.
