> For the complete documentation index, see [llms.txt](https://chatsystem-wiki.gitbook.io/chatsystem-wiki/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://chatsystem-wiki.gitbook.io/chatsystem-wiki/andere-plugins/disposal-system.md).

# Disposal System

### DEUTSCH

#### 📋 Allgemeine Beschreibung

Das DisposalPlugin ermöglicht es Spielern, Gegenstände sicher zu entsorgen. Es öffnet ein GUI-Inventar, in das Spieler Gegenstände legen können. Beim Schließen des Inventars werden alle darin befindlichen Gegenstände endgültig gelöscht.

#### 🎮 Befehle

| Befehl                   | Beschreibung                                                  | Permission         |
| ------------------------ | ------------------------------------------------------------- | ------------------ |
| `/disposal`              | Öffnet das Disposal-GUI zum Entsorgen von Gegenständen        | `disposal.command` |
| `/disposalsystem reload` | Lädt die config.yml neu, ohne das Plugin neustarten zu müssen | `disposal.reload`  |

#### 🔑 Permissions

| Permission         | Beschreibung                                                        | Standard                 |
| ------------------ | ------------------------------------------------------------------- | ------------------------ |
| `disposal.command` | Erlaubt die Nutzung des `/disposal` Befehls                         | `false` (nicht standard) |
| `disposal.sign`    | Erlaubt das Erstellen und Benutzen von Disposal-Schildern           | `false` (nicht standard) |
| `disposal.reload`  | Erlaubt das Neuladen der Konfiguration mit `/disposalsystem reload` | `false` (nicht standard) |

#### 🪧 Schild-Funktion

* **Erstellung:** Schreibe `[Disposal]` (Groß-/Kleinschreibung egal) auf ein Schild
* **Erscheinungsbild:** Das Schild wird automatisch zu `[Disposal]` formatiert (die Farbe ist in der config einstellbar)
* **Nutzung:** Rechtsklick auf das Schild öffnet das Disposal-GUI
* Voraussetzung: `disposal.sign` Permission

#### 📦 GUI-Funktionen

* **Größe:** 1-6 Reihen (9-54 Slots) - einstellbar in der config
* **Titel:** Frei anpassbar mit Farbcodes (&)
* **Verhalten:**
  * Gegenstände können beliebig rein- und rausgenommen werden
  * Beim Verlassen des GUI (schließen) werden ALLE Gegenstände im GUI gelöscht
  * Das Inventar des Spielers bleibt unberührt

#### ⚙️ Konfiguration (config.yml)

yaml

```
gui:
  size: 6                    # GUI-Größe (1-6 Reihen)
  title: "&8Disposal"        # GUI-Titel (unterstützt & Farbcodes)

sign:
  color: "&c"                # Farbe des "Disposal" Textes auf Schildern
```

#### 🎨 Farbcodes

Alle Farbcodes funktionieren mit `&` (z.B. `&c` = rot, `&a` = grün, `&6` = gold, etc.)

#### 📝 Wichtige Hinweise

* Die Permissions sind **nicht** standardmäßig aktiviert (default: false)
* Gegenstände im Disposal-GUI werden **sofort und unwiderruflich** gelöscht, sobald das GUI geschlossen wird
* Es gibt keine Möglichkeit, gelöschte Gegenstände wiederherzustellen
* Das Plugin wurde für **Paper 1.21 und höher** entwickelt

### 🇬🇧 ENGLISH

#### 📋 General Description

The DisposalPlugin allows players to safely dispose of items. It opens a GUI inventory where players can place items. When the inventory is closed, all items inside are permanently deleted.

#### 🎮 Commands

| Command                  | Description                                          | Permission         |
| ------------------------ | ---------------------------------------------------- | ------------------ |
| `/disposal`              | Opens the disposal GUI to discard items              | `disposal.command` |
| `/disposalsystem reload` | Reloads the config.yml without restarting the plugin | `disposal.reload`  |

#### 🔑 Permissions

| Permission         | Description                                                      | Default               |
| ------------------ | ---------------------------------------------------------------- | --------------------- |
| `disposal.command` | Allows using the `/disposal` command                             | `false` (not default) |
| `disposal.sign`    | Allows creating and using disposal signs                         | `false` (not default) |
| `disposal.reload`  | Allows reloading the configuration with `/disposalsystem reload` | `false` (not default) |

#### 🪧 Sign Feature

* **Creation:** Write `[Disposal]` (case insensitive) on a sign
* **Appearance:** The sign is automatically formatted to `[Disposal]` (color is configurable)
* **Usage:** Right-click on the sign to open the disposal GUI
* **Requirement:** `disposal.sign` permission

#### 📦 GUI Features

* **Size:** 1-6 rows (9-54 slots) - configurable in config.yml
* **Title:** Freely customizable with color codes (&)
* **Behavior:**
  * Items can be freely added and removed
  * When leaving (closing) the GUI, ALL items inside are deleted
  * The player's inventory remains unaffected

#### ⚙️ Configuration (config.yml)

yaml

```
gui:
  size: 6                    # GUI size (1-6 rows)
  title: "&8Disposal"        # GUI title (supports & color codes)

sign:
  color: "&c"                # Color of the "Disposal" text on signs
```

#### 🎨 Color Codes

All color codes work with `&` (e.g., `&c` = red, `&a` = green, `&6` = gold, etc.)

#### 📝 Important Notes

* Permissions are **not** enabled by default (default: false)
* Items in the disposal GUI are **instantly and permanently** deleted when the GUI is closed
* There is no way to recover deleted items
* The plugin was developed for **Paper 1.21 and higher**

***

### 🔧 Technical Details 

#### Event-Handling

* `SignChangeEvent`: Formats signs with `[Disposal]`
* `PlayerInteractEvent`: Detects right-clicks on disposal signs
* `InventoryCloseEvent`: Deletes all items when disposal GUI is closed

#### Supported Sign Types 

* Oak / Eiche
* Spruce / Fichte
* Birch / Birke
* Jungle / Dschungel
* Acacia / Akazie
* Dark Oak / Dunkleiche
* Mangrove / Mangroven
* Cherry / Kirschholz
* Bamboo / Bambus
* Crimson / Karmesin
* Warped / Wirr

<a href="/pages/JsKd452Nu8XTrHz68zaF" class="button primary" data-icon="house-chimney-window">Home</a> |  <a href="https://www.spigotmc.org/resources/disposal-system.133842/" class="button primary" data-icon="arrow-down-to-line">Herunterladen</a>


---

# 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, and the optional `goal` query parameter:

```
GET https://chatsystem-wiki.gitbook.io/chatsystem-wiki/andere-plugins/disposal-system.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.