Upload via GUI (6 Dateien)

README.md

@@ -1,2 +1,102 @@
 # LandHopperLimit
 
+Dieses Plugin begrenzt, wie viele **Trichter** (Hopper) ein **Land** haben darf.
+Standard: **300 Trichter pro Land**. Ist das Limit erreicht, kann niemand mehr einen neuen Trichter in dem Land setzen.
+
+Bereits gesetzte Trichter bleiben immer stehen, es wird nichts gelöscht.
+
+---
+
+## Was du brauchst
+
+- Einen **Paper-Server** (Version 1.21.4)
+- Das Plugin **Lands**
+
+---
+
+## Installation (5 Schritte)
+
+1. Lade die Datei `LandHopperLimit-1.0.0.jar` herunter.
+2. Kopiere sie in den Ordner `plugins` deines Servers.
+3. Starte den Server neu.
+4. Gib einmal im Spiel (oder in der Konsole) diesen Befehl ein:
+   ```
+   /lhl scan
+   ```
+   Das zählt alle schon vorhandenen Trichter. Das dauert je nach Servergröße ein paar Minuten. Warte, bis "Scan fertig" erscheint.
+5. Fertig!
+
+Den Scan musst du nur **einmal** machen.
+
+---
+
+## Befehle
+
+| Befehl | Was er macht | Wer darf das |
+|---|---|---|
+| `/lhl` oder `/lhl info` | Zeigt, wie viele Trichter das Land hat, in dem du stehst | Alle |
+| `/lhl scan` | Zählt alle Trichter aller Länder neu | Nur Admins |
+| `/lhl reload` | Lädt die Einstellungen neu | Nur Admins |
+
+`/lhl` kannst du auch als `/landhopperlimit` oder `/trichterlimit` schreiben.
+
+---
+
+## Rechte (Permissions)
+
+| Recht | Was es bewirkt | Standard |
+|---|---|---|
+| `landhopperlimit.info` | `/lhl info` benutzen | Alle |
+| `landhopperlimit.admin` | `/lhl scan` und `/lhl reload` benutzen | Nur OPs |
+| `landhopperlimit.bypass` | Das Limit ignorieren | Niemand |
+
+Wer `landhopperlimit.bypass` bekommt, darf unbegrenzt Trichter setzen (zum Beispiel für Teammitglieder).
+
+---
+
+## Einstellungen ändern
+
+Öffne die Datei `plugins/LandHopperLimit/config.yml` mit einem Texteditor.
+
+**Limit ändern:**
+```yaml
+limit: 300
+```
+Ersetze `300` durch die Zahl, die du willst.
+
+**Nur bestimmte Welten:**
+```yaml
+worlds:
+  - world
+  - world_the_end
+```
+Lässt du die Liste leer (`worlds: []`), gilt das Limit in **allen** Welten.
+
+**Nachrichten ändern:** Alle Texte stehen unter `messages:`. Farben schreibst du mit `&`, zum Beispiel `&c` für rot und `&e` für gelb.
+
+Nach jeder Änderung im Spiel `/lhl reload` eingeben. Ein Neustart ist nicht nötig.
+
+---
+
+## Gut zu wissen
+
+- Das Limit gilt für **alle** Trichter, auch für spezielle Trichter von anderen Plugins, solange sie Trichter-Blöcke sind.
+- Steht man **außerhalb eines Lands** (Wildnis), gibt es kein Limit.
+- Die Zahlen werden in der Datei `plugins/LandHopperLimit/hopper-counts.yml` gespeichert. Diese Datei bitte **nicht von Hand ändern**.
+- Wurden Trichter mit anderen Plugins oder Tools gesetzt (zum Beispiel WorldEdit), kann die Zahl kurz falsch sein. Mit `/lhl scan` stimmt sie wieder.
+
+---
+
+## Hilfe, es klappt nicht!
+
+| Problem | Lösung |
+|---|---|
+| Plugin startet nicht | Prüfe, ob **Lands** installiert ist und der Server **Paper 1.21.4** ist |
+| "Du stehst in keinem Land" | Stell dich in ein Land, in der Wildnis gibt es nichts zu zählen |
+| Die Zahl stimmt nicht | `/lhl scan` ausführen |
+| "Dafür hast du keine Rechte" | Du brauchst das Recht `landhopperlimit.admin` |
+| Ein Spieler soll das Limit umgehen | Gib ihm das Recht `landhopperlimit.bypass` |
+
+---
+
+Von Lukas (Viper Network)