> 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/safe-system.md).

# Safe System

### 📖 Überblick

SafeSystem ist ein Minecraft Plugin, mit dem Spieler ihre Behälter (Kisten, Truhen, Fässer, Shulker-Boxen) vor anderen Spielern schützen können. Es unterstützt Einzel- und Doppeltruhen.

### 🔧 Funktionen

#### Kernfunktionen

| Funktion                       | Beschreibung                                               |
| ------------------------------ | ---------------------------------------------------------- |
| **Behälter sichern**           | Schützt einen Behälter vor unbefugtem Zugriff              |
| **Doppeltruhen-Unterstützung** | Erkennt automatisch Doppeltruhen und schützt beide Seiten  |
| **Auto-Safe**                  | Platziert Behälter werden automatisch gesichert (optional) |
| **Behälter teilen**            | Gib anderen Spielern Zugriff auf deine Behälter            |
| **Behälter umbenennen**        | Gib deinen Behältern benutzerdefinierte Namen              |
| **GUI-Verwaltung**             | Intuitive grafische Oberfläche zur Verwaltung              |
| **Behälter finden**            | Markiert Behälter mit Leuchteffekt                         |
| **Admin-Modus**                | Administratoren haben Zugriff auf alle Behälter            |

#### Befehle

**Hauptbefehle (`/safe`)**

| Befehl                                    | Aliase       | Beschreibung                                      |
| ----------------------------------------- | ------------ | ------------------------------------------------- |
| `/safe gui`                               | -            | Öffnet die Übersicht aller deiner Behälter        |
| `/safe gui überblick`                     | `ueberblick` | Öffnet die Übersicht aller deiner Behälter        |
| `/safe gui verwalten`                     | -            | Öffnet Verwaltungs-GUI für anvisierten Behälter   |
| `/safe name <Neuer Name>`                 | -            | Benennt den anvisierten Behälter um               |
| `/safe share <Objektname> <Spieler>`      | -            | Teilt einen bestimmten Behälter mit einem Spieler |
| `/safe share all <Spieler>`               | -            | Teilt ALLE deiner Behälter mit einem Spieler      |
| `/safe autosafe <on/off/toggle>`          | -            | Schaltet Auto-Safe ein/aus                        |
| `/safe add <Name>`                        | -            | Sichert einen Behälter mit eigenem Namen          |
| `/safe remove <Name>`                     | -            | Entfernt die Sicherung eines Behälters            |
| `/safe clear`                             | -            | Entfernt ALLE deiner Sicherungen                  |
| `/safe removeaccess <Spieler> <Name/all>` | -            | Entfernt Zugriff eines Spielers                   |
| `/safe admin <on/off>`                    | -            | Schaltet Admin-Modus ein/aus                      |
| `/safe reload`                            | -            | Lädt die Konfiguration neu (Admin)                |
| `/safe delete`                            | -            | Löscht ALLE Sicherungen (Admin, mit Bestätigung)  |

**Admin-Befehle (`/safesystem`)**

| Befehl               | Beschreibung                 |
| -------------------- | ---------------------------- |
| `/safesystem reload` | Lädt die Konfiguration neu   |
| `/safesystem admin`  | Schaltet Admin-Modus ein/aus |

#### Berechtigungen (Permissions)

| Permission             | Standard | Beschreibung                          |
| ---------------------- | -------- | ------------------------------------- |
| `safesystem.use`       | true     | Erlaubt die Nutzung des SafeSystems   |
| `safesystem.admin`     | op       | Erlaubt Admin-Befehle (`/safesystem`) |
| `safesystem.bypass`    | op       | Umgeht den Schutz von Behältern       |
| `safesystem.delete`    | op       | Erlaubt das Löschen aller Sicherungen |
| `safesystem.adminmode` | op       | Erlaubt den Admin-Modus               |
| `safesystem.autosafe`  | true     | Erlaubt Auto-Safe Funktion            |
| `safesystem.find`      | true     | Erlaubt das Finden von Behältern      |

#### Interaktionen

| Aktion                                           | Ergebnis                                              |
| ------------------------------------------------ | ----------------------------------------------------- |
| **Sneak + Rechtsklick** auf Behälter             | Sichert ungesicherten Behälter oder öffnet Verwaltung |
| **Rechtsklick** auf fremden gesicherten Behälter | Zugriff verweigert + Nachricht                        |
| **Rechtsklick** auf eigenen gesicherten Behälter | Normale Öffnung                                       |
| **Abbauen** eines gesicherten Behälters          | Nur möglich wenn Eigentümer/Admin/Bypass              |
| **Hoppern** von gesicherten Behältern            | Verhindert                                            |

#### GUI-Funktionen

**Übersichts-GUI (`/safe gui`)**

* **Linksklick** auf Behälter → Markiert Behälter mit Leuchteffekt
* **Rechtsklick** auf Behälter → Entfernt Schutz
* **Seitennavigation** mit Pfeiltasten
* **Schließen** mit Barrier-Block
* **Zurück**-Button (wenn aus Verwaltung geöffnet)

**Verwaltungs-GUI (Sneak + Rechtsklick)**

* **Name ändern** → Chat-Klick-Vorschlag für Umbenennung
* **Teilen** → Chat-Klick-Vorschlag zum Teilen
* **Schutz entfernen** → Chat-Klick-Bestätigung
* **Alle Behälter** → Öffnet Übersichts-GUI
* **Auto-Safe** → Direktes Umschalten

#### Doppeltruhen-Funktionen

| Funktion         | Beschreibung                               |
| ---------------- | ------------------------------------------ |
| **Erkennung**    | Automatische Erkennung von Doppeltruhen    |
| **Schutz**       | Beide Seiten werden zusammen geschützt     |
| **Umbenennung**  | Benennt beide Seiten um                    |
| **Teilen**       | Teilt Zugriff auf beide Seiten             |
| **Entfernen**    | Entfernt Schutz von beiden Seiten          |
| **Anzeige**      | Spezielle Symbole und Informationen im GUI |
| **Hervorhebung** | Markiert beide Seiten gleichzeitig         |

#### Namenssystem

* Unbenannte Behälter erhalten automatisch Namen: `Unnamed 01`, `Unnamed 02`, usw.
* Benutzerdefinierte Namen bis zu 32 Zeichen (konfigurierbar)
* Namen werden sofort im Tab-Completer aktualisiert
* Neue Behälter werden oben in der Liste angezeigt

#### Besondere Funktionen

| Funktion              | Beschreibung                                                |
| --------------------- | ----------------------------------------------------------- |
| **Admin-Modus**       | Admins können alle Behälter sehen/bearbeiten                |
| **Glow-Effekt**       | Gefundene Behälter leuchten für 30 Sekunden                 |
| **Auto-Safe**         | Automatic protection on placement (toggle)                  |
| **Hopper-Schutz**     | Hoppers können keine Items aus gesicherten Behältern ziehen |
| **Bypass-Permission** | Bestimmte Spieler können Schutz umgehen                     |

### 📖 Overview

SafeSystem is a Minecraft plugin that allows players to protect their containers (chests, barrels, shulker boxes) from other players. It supports single and double chests.

### 🔧 Features

#### Core Features

| Feature                  | Description                                                 |
| ------------------------ | ----------------------------------------------------------- |
| **Protect Containers**   | Protects a container from unauthorized access               |
| **Double Chest Support** | Automatically detects double chests and protects both sides |
| **Auto-Safe**            | Placed containers are automatically protected (optional)    |
| **Share Containers**     | Give other players access to your containers                |
| **Rename Containers**    | Give your containers custom names                           |
| **GUI Management**       | Intuitive graphical interface for management                |
| **Find Containers**      | Highlights containers with a glow effect                    |
| **Admin Mode**           | Administrators have access to all containers                |

#### Commands

**Main Commands (`/safe`)**

| Command                                  | Aliases      | Description                                        |
| ---------------------------------------- | ------------ | -------------------------------------------------- |
| `/safe gui`                              | -            | Opens an overview of all your containers           |
| `/safe gui überblick`                    | `ueberblick` | Opens overview of all your containers              |
| `/safe gui verwalten`                    | -            | Opens management GUI for targeted container        |
| `/safe name <New Name>`                  | -            | Renames the targeted container                     |
| `/safe share <ContainerName> <Player>`   | -            | Shares a specific container with a player          |
| `/safe share all <Player>`               | -            | Shares ALL your containers with a player           |
| `/safe autosafe <on/off/toggle>`         | -            | Toggles Auto-Safe on/off                           |
| `/safe add <Name>`                       | -            | Protects a container with a custom name            |
| `/safe remove <Name>`                    | -            | Removes protection from a container                |
| `/safe clear`                            | -            | Removes ALL your protections                       |
| `/safe removeaccess <Player> <Name/all>` | -            | Removes a player's access                          |
| `/safe admin <on/off>`                   | -            | Toggles Admin Mode on/off                          |
| `/safe reload`                           | -            | Reloads the configuration (Admin)                  |
| `/safe delete`                           | -            | Deletes ALL protections (Admin, with confirmation) |

**Admin Commands (`/safesystem`)**

| Command              | Description               |
| -------------------- | ------------------------- |
| `/safesystem reload` | Reloads the configuration |
| `/safesystem admin`  | Toggles Admin Mode on/off |

#### Permissions

| Permission             | Default | Description                           |
| ---------------------- | ------- | ------------------------------------- |
| `safesystem.use`       | true    | Allows using SafeSystem               |
| `safesystem.admin`     | op      | Allows admin commands (`/safesystem`) |
| `safesystem.bypass`    | op      | Bypasses container protection         |
| `safesystem.delete`    | op      | Allows deleting all protections       |
| `safesystem.adminmode` | op      | Allows Admin Mode                     |
| `safesystem.autosafe`  | true    | Allows Auto-Safe function             |
| `safesystem.find`      | true    | Allows finding containers             |

#### Interactions

| Action                                                | Result                                             |
| ----------------------------------------------------- | -------------------------------------------------- |
| **Sneak + Right-click** on container                  | Protects unprotected container or opens management |
| **Right-click** on protected container (other player) | Access denied + message                            |
| **Right-click** on own protected container            | Normal opening                                     |
| **Breaking** a protected container                    | Only possible for owner/admin/bypass               |
| **Hopper** from protected containers                  | Prevented                                          |

#### GUI Functions

**Overview GUI (`/safe gui`)**

* **Left-click** on container → Highlights container with glow effect
* **Right-click** on container → Removes protection
* **Page navigation** with arrow buttons
* **Close** with barrier block
* **Back** button (when opened from management)

**Management GUI (Sneak + Right-click)**

* **Change name** → Chat click suggestion for renaming
* **Share** → Chat click suggestion for sharing
* **Remove protection** → Chat click confirmation
* **All containers** → Opens overview GUI
* **Auto-Safe** → Direct toggle

#### Double Chest Features

| Feature        | Description                          |
| -------------- | ------------------------------------ |
| **Detection**  | Automatic detection of double chests |
| **Protection** | Both sides are protected together    |
| **Renaming**   | Renames both sides                   |
| **Sharing**    | Shares access to both sides          |
| **Removal**    | Removes protection from both sides   |
| **Display**    | Special icons and information in GUI |
| **Highlight**  | Highlights both sides simultaneously |

#### Name System

| Feature             | Description                                                             |
| ------------------- | ----------------------------------------------------------------------- |
| **Default Names**   | Unnamed containers get auto names like `Unnamed 01`, `Unnamed 02`, etc. |
| **Custom Names**    | Custom names up to 32 characters (configurable)                         |
| **Tab Completer**   | Names update instantly in tab completer                                 |
| **Containers List** | Newest containers appear at the top in GUI                              |

#### Special Features

| Function              | Description                                         |
| --------------------- | --------------------------------------------------- |
| **Admin Mode**        | Admins can see/edit all containers                  |
| **Glow Effect**       | Found containers glow for 30 seconds                |
| **Auto-Safe**         | Automatic protection on placement (toggle)          |
| **Hopper Protection** | Hoppers cannot pull items from protected containers |
| **Bypass Permission** | Certain players can bypass protection               |

#### Messages & Colors

| Color         | Meaning                   |
| ------------- | ------------------------- |
| `§a` (Green)  | Success messages          |
| `§c` (Red)    | Error messages & warnings |
| `§e` (Yellow) | Information & commands    |
| `§6` (Gold)   | Important information     |
| `§7` (Gray)   | Secondary information     |
|               |                           |

<a href="/pages/JsKd452Nu8XTrHz68zaF" class="button primary" data-icon="house-chimney-window">Home</a> | <a href="https://www.spigotmc.org/resources/safe-system.134779/" 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/safe-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.
