# Punishments Book Menu

The [**Punishments Menu – Modern Book Interface**](https://builtbybit.com/resources/punishment-menu-modern-book-interface.61370/) is a fully configurable moderation setup for your server. It provides an in-game modern book-style menu for managing warnings, mutes, bans, and more. This resource is **configuration-only**, meaning it requires compatible plugins to function.

{% hint style="warning" %}
This configuration does not include plugins themselves. You must have the required dependencies installed before using this setup.
{% endhint %}

<figure><img src="/files/cqCzmpt3ItnsGJT2bB9j" alt="PunishmentsMenubyNexraCreations.png"><figcaption></figcaption></figure>

## Requirements:

| Name                | Link                                                                          | Required |
| ------------------- | ----------------------------------------------------------------------------- | -------- |
| Skript              | [Download](https://www.spigotmc.org/resources/skript.114544/)                 | Yes      |
| Virtual Books       | [Download](https://www.spigotmc.org/resources/virtualbooks-1-8-8-1-21.78627/) | Yes      |
| Skript Placeholders | [Download](https://forums.skunity.com/resources/skript-placeholders.909/)     | Yes      |
| EssentialsX         | [Download](https://essentialsx.net/downloads.html)                            | Optional |
| AdvancedBans        | [Download](https://www.spigotmc.org/resources/advancedban.8695/)              | Optional |
| LiteBans            | [Purchase](https://www.spigotmc.org/resources/litebans.3715/)                 | Optional |

{% hint style="info" %}
You only need **one plugin** to manage punishments. If you choose not to use any, Minecraft’s default system will handle them (only bans and mutes, you'll need a plugin for warns since they aren't native features of minecraft) automatically.
{% endhint %}

### Installation Guide:

{% stepper %}
{% step %}

#### Install Required Plugins:

Download and install the required plugins listed above. Ensure all plugins are compatible with your server version.
{% endstep %}

{% step %}

#### Upload Configuration Files:

* Navigate to `plugins/Skript/scripts/`.
* Upload the provided `Punish.sk` file here.
* Go to `plugins/VirtualBooks/Books/` and paste the four provided book files into this directory.
  {% endstep %}

{% step %}

#### Restart Your Server:

Restart your server to apply the changes. Verify that the menu functions correctly in-game.
{% endstep %}

{% step %}
**Customization:**

The configuration is designed for easy customization. Modify the scripts and book files as needed to fit your server's requirements.
{% endstep %}
{% endstepper %}

## Usage:

### Open the Punishments Menu:

* Use the command `/punish <player_name>` to open the book menu.
* Select the desired punishment type (Warn, Mute, Ban) and choose a reason.

### Permissions:

* Ensure appropriate permissions (`punish.access`, `punish.ban`, `punish.mute`, `punish.warn`) are set for staff members to access and use the menu.


---

# Agent Instructions: 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://myelitewiki.gitbook.io/resources/configurations/punishments-menu.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.
