Dieses Plugin ist eine Erweiterung für das **Lands**-Plugin. Es bietet:
Dieses Plugin ist eine Erweiterung für das **Lands**-Plugin. Es bietet:
- **Chunk-Übersicht:** wie viele Chunks ein Land belegt, wie viele frei und wie viele gesperrt sind.
- **Chunk-Übersicht:** wie viele Chunks ein Land belegt, wie viele frei und wie viele gesperrt sind.
- **Wartezeit nach `/unclaim`:** Der Slot bleibt für eine einstellbare Zeit gesperrt. Die Spieler sehen, **wann wieder ein Chunk frei wird**.
- **Wartezeit nach `/unclaim`:** Der Slot bleibt für eine einstellbare Zeit gesperrt. Die Spieler sehen, **wann wieder ein Chunk frei wird**.
- **Spielzeit-Anzeige:** wie viel Online-Zeit noch fehlt, bis das Limit durch Lands' Spielzeit-Belohnung um einen Chunk steigt.
- **Spielzeit-Anzeige:** wie viel Online-Zeit noch fehlt, bis das Limit durch Lands' Spielzeit-Belohnung um einen Chunk steigt.
- **Upkeep-Anzeige:** wann das Land das nächste Mal zahlen muss.
- **Upkeep-Anzeige:** wann das Land das nächste Mal zahlen muss.
- **Slot freikaufen** (`skip`, `gift`), **Auto-Claim-Warteschlange** und **Watchlist**.
- **Slot freikaufen** (`skip`, `gift`), **Auto-Claim-Warteschlange** und **Watchlist**.
- **PvP-Regionen:** Bereiche (z. B. eine Arena), in denen Spieler kämpfen dürfen, auch wenn sie im selben Land Mitglied sind.
- **PvP-Regionen:** Bereiche (z. B. eine Arena), in denen Spieler kämpfen dürfen, auch wenn sie im selben Land Mitglied sind.
- **Platzhalter** für PlaceholderAPI.
- **Platzhalter** für PlaceholderAPI.
Du brauchst keine Programmierkenntnisse. Diese Anleitung erklärt alles Schritt für Schritt.
Du brauchst keine Programmierkenntnisse. Diese Anleitung erklärt alles Schritt für Schritt.
---
---
## 1. Was brauche ich?
## 1. Was brauche ich?
| Was | Pflicht? | Wofür |
| Was | Pflicht? | Wofür |
|---|---|---|
|---|---|---|
| Ein Minecraft-Server mit **Paper** (Version 1.21 bis 26) | Ja | Das Plugin läuft darauf |
| Ein Minecraft-Server mit **Paper** (Version 1.21 bis 26) | Ja | Das Plugin läuft darauf |
| **Java 25** auf dem Server | Ja | Lands 8.8.0 braucht das ebenfalls |
| **Java 25** auf dem Server | Ja | Lands 8.8.0 braucht das ebenfalls |
| Das Plugin **Lands** (Version 8.8.0) | Ja | Ohne Lands startet dieses Plugin nicht |
| Das Plugin **Lands** (Version 8.8.0) | Ja | Ohne Lands startet dieses Plugin nicht |
| **Vault** + ein Economy-Plugin (z. B. EssentialsX) | Nein | Nur zum Bezahlen mit Spielergeld (`skip`, `gift`) |
| **Vault** + ein Economy-Plugin (z. B. EssentialsX) | Nein | Nur zum Bezahlen mit Spielergeld (`skip`, `gift`) |
| **PlaceholderAPI** | Nein | Nur für Platzhalter in Scoreboard, Tab-Liste usw. |
| **PlaceholderAPI** | Nein | Nur für Platzhalter in Scoreboard, Tab-Liste usw. |
Folia wird **nicht** unterstützt.
Folia wird **nicht** unterstützt.
---
---
## 2. Installation und Update
## 2. Installation und Update
1. Stoppe den Server.
1. Stoppe den Server.
2. Kopiere `LandsChunkInfo-1.0.7.jar` in den Ordner `plugins` deines Servers (dort liegt auch die Lands-Jar).
2. Kopiere `LandsChunkInfo-1.0.8.jar` in den Ordner `plugins` deines Servers (dort liegt auch die Lands-Jar).
**Bei einem Update:** Lösche zuerst die alte `LandsChunkInfo-*.jar`. Es darf nur **eine** Version im Ordner liegen.
**Bei einem Update:** Lösche zuerst die alte `LandsChunkInfo-*.jar`. Es darf nur **eine** Version im Ordner liegen.
3. Starte den Server.
3. Starte den Server.
4. Schau in die Konsole. Du solltest `[LandsChunkInfo] Enabling LandsChunkInfo` sehen. Steht dort ein roter Fehler, lies Abschnitt 11.
4. Schau in die Konsole. Du solltest `[LandsChunkInfo] Enabling LandsChunkInfo` sehen. Steht dort ein roter Fehler, lies Abschnitt 11.
5. Beim ersten Start wird `plugins/LandsChunkInfo/config.yml` erstellt. Dort stellst du alles ein (Abschnitt 7).
5. Beim ersten Start wird `plugins/LandsChunkInfo/config.yml` erstellt. Dort stellst du alles ein (Abschnitt 7).
**Wichtig:** Nach dem Austausch der Jar-Datei ist immer ein **Neustart** nötig. `/reload` reicht nicht und kann Fehler verursachen.
**Wichtig:** Nach dem Austausch der Jar-Datei ist immer ein **Neustart** nötig. `/reload` reicht nicht und kann Fehler verursachen.
Deine Dateien in `plugins/LandsChunkInfo/` (`config.yml`, `data.yml`, `pvp-regions.yml`) bleiben bei einem Update erhalten.
Deine Dateien in `plugins/LandsChunkInfo/` (`config.yml`, `data.yml`, `pvp-regions.yml`) bleiben bei einem Update erhalten.
---
---
## 3. Der Befehl
## 3. Der Befehl
Der Hauptbefehl heißt **`/chunks`**. Es gibt die Kurzform `/chunkslots`.
Der Hauptbefehl heißt **`/chunks`**. Es gibt die Kurzform `/chunkslots`.
> **Hinweis:** Der Name `/chunks` wird bewusst nicht benutzt, weil WorldEdit/FastAsyncWorldEdit einen eigenen Befehl `/chunks` hat. Der würde sonst mit diesem Plugin kollidieren (Fehler „Too many arguments“).
> **Hinweis:** Der Name `/chunks` wird bewusst nicht benutzt, weil WorldEdit/FastAsyncWorldEdit einen eigenen Befehl `/chunks` hat. Der würde sonst mit diesem Plugin kollidieren (Fehler „Too many arguments“).
---
---
## 4. Was können die Spieler?
## 4. Was können die Spieler?
### Übersicht anzeigen
### Übersicht anzeigen
| Befehl | Was passiert |
| Befehl | Was passiert |
|---|---|
|---|---|
| `/chunks` | Zeigt alle deine Lands: Chunks belegt, frei, gesperrt, wann der nächste Chunk frei wird, Upkeep |
| `/chunks` | Zeigt dein eigenes Land (bist du nirgends Besitzer, die Lands, in denen du Mitglied bist): Chunks belegt, frei, gesperrt, wann der nächste Chunk frei wird, Upkeep |
| `/chunks MeinLand` | Zeigt nur dieses eine Land |
| `/chunks MeinLand` | Zeigt nur dieses eine Land (die Tab-Vorschläge nennen ebenfalls nur dein eigenes Land) |
| `/chunks top` | Zeigt die Lands mit den meisten Chunks |
| `/chunks top` | Zeigt die Lands mit den meisten Chunks |
**Beispiel einer Anzeige:**
**Beispiel einer Anzeige:**
```
```
Deine Chunks
Deine Chunks
Von dir geclaimt: 12 / 20
Von dir geclaimt: 12 / 20
MeinLand
MeinLand
Chunks: 12 / 20 | Frei: 6 | Gesperrt: 2
Chunks: 12 / 20 | Frei: 6 | Gesperrt: 2
Nächster Chunk wieder frei in: 3Std 12Min (23.10. 14:30)
Nächster Chunk wieder frei in: 3Std 12Min (23.10. 14:30)
Danach: 20Std 5Min
Danach: 20Std 5Min
Sofort freischalten: /chunks skip (Preis: 80,00)
Sofort freischalten: /chunks skip (Preis: 80,00)
Upkeep: 36,00 pro Zyklus, nächster Einzug in 2T 4Std
Upkeep: 36,00 pro Zyklus, nächster Einzug in 2T 4Std
```
```
Wenn du in Lands Spielzeit-Belohnungen eingerichtet hast (siehe unten), steht über den Lands zusätzlich:
Wenn du in Lands Spielzeit-Belohnungen eingerichtet hast (siehe unten), steht über den Lands zusätzlich:
```
```
Nächster Chunk durch Spielzeit: 2Std 10Min Online-Zeit (Bonus bisher: 4/20)
Nächster Chunk durch Spielzeit: 2Std 10Min Online-Zeit (Bonus bisher: 4/20)
```
```
Was bedeuten die Wörter?
Was bedeuten die Wörter?
- **Frei** = So viele Chunks kann das Land jetzt sofort claimen.
- **Frei** = So viele Chunks kann das Land jetzt sofort claimen.
- **Gesperrt** = Jemand hat einen Chunk abgegeben (`/unclaim`). Dieser Platz ist für eine Weile blockiert. Nach der Wartezeit ist er wieder frei.
- **Gesperrt** = Jemand hat einen Chunk abgegeben (`/unclaim`). Dieser Platz ist für eine Weile blockiert. Nach der Wartezeit ist er wieder frei.
- **Upkeep** = Die regelmäßige Gebühr, die das Land zahlen muss, damit es seine Chunks behält.
- **Upkeep** = Die regelmäßige Gebühr, die das Land zahlen muss, damit es seine Chunks behält.
- Wenn das Land-Guthaben für den Upkeep nicht reicht, steht eine rote Warnung dabei (und, wenn Lands beim Upkeep Chunks abzieht, wie viele verloren gehen würden).
- Wenn das Land-Guthaben für den Upkeep nicht reicht, steht eine rote Warnung dabei (und, wenn Lands beim Upkeep Chunks abzieht, wie viele verloren gehen würden).
- Wenn Lands Inaktivität einstellt, steht dort auch, ob der Besitzer online ist oder wann das Land als inaktiv gilt.
- Wenn Lands Inaktivität einstellt, steht dort auch, ob der Besitzer online ist oder wann das Land als inaktiv gilt.
### Spielzeit bis zum nächsten Chunk
### Spielzeit bis zum nächsten Chunk
Lands kann das Chunk-Limit mit der Spielzeit wachsen lassen. Das stellst du in `plugins/Lands/player-limits.yml` im Abschnitt `time-rewards` ein, zum Beispiel:
Lands kann das Chunk-Limit mit der Spielzeit wachsen lassen. Das stellst du in `plugins/Lands/player-limits.yml` im Abschnitt `time-rewards` ein, zum Beispiel:
```yaml
```yaml
time-rewards:
time-rewards:
player_chunks:
player_chunks:
time:2h
time:2h
max:20
max:20
```
```
Dann bekommt jeder Spieler alle 2 Stunden Spielzeit einen Chunk mehr, höchstens 20. Dieses Plugin zeigt in `/chunks` an, wie lange der Spieler noch online sein muss:
Dann bekommt jeder Spieler alle 2 Stunden Spielzeit einen Chunk mehr, höchstens 20. Dieses Plugin zeigt in `/chunks` an, wie lange der Spieler noch online sein muss:
-`player_chunks` = **Nächster Chunk durch Spielzeit** (Chunks, die ein Spieler insgesamt claimen darf).
-`player_chunks` = **Nächster Chunk durch Spielzeit** (Chunks, die ein Spieler insgesamt claimen darf).
-`land_size` = **Nächster Land-Chunk durch Spielzeit** (maximale Größe seiner Lands).
-`land_size` = **Nächster Land-Chunk durch Spielzeit** (maximale Größe seiner Lands).
Die Zeile erscheint nur, wenn `time` größer als `0s` ist und das `max` noch nicht erreicht wurde. Gerechnet wird mit der Spielzeit-Statistik des Servers, genau wie bei Lands. Hat Lands eine andere Einstellung, zeigt die Anzeige dasselbe wie Lands. Das Plugin ändert an den Limits nichts.
Die Zeile erscheint nur, wenn `time` größer als `0s` ist und das `max` noch nicht erreicht wurde. Gerechnet wird mit der Spielzeit-Statistik des Servers, genau wie bei Lands. Hat Lands eine andere Einstellung, zeigt die Anzeige dasselbe wie Lands. Das Plugin ändert an den Limits nichts.
### Gesperrten Slot sofort freikaufen
### Gesperrten Slot sofort freikaufen
| Befehl | Was passiert |
| Befehl | Was passiert |
|---|---|
|---|---|
| `/chunks skip` | Zeigt den Preis für den nächsten gesperrten Slot deines Lands |
| `/chunks skip` | Zeigt den Preis für den nächsten gesperrten Slot deines Lands |
| `/chunks skip confirm` | Kauft den Slot wirklich. Ohne `confirm` wird **nichts** bezahlt |
| `/chunks skip confirm` | Kauft den Slot wirklich. Ohne `confirm` wird **nichts** bezahlt |
| `/chunks skip MeinLand confirm` | Dasselbe für ein bestimmtes eigenes Land |
| `/chunks skip MeinLand confirm` | Dasselbe für ein bestimmtes eigenes Land |
| `/chunks gift FremdesLand` | Zeigt den Preis, um einen Slot in einem **fremden** Land freizukaufen |
| `/chunks gift FremdesLand` | Zeigt den Preis, um einen Slot in einem **fremden** Land freizukaufen |
| `/chunks gift FremdesLand confirm` | Kauft den Slot. Die online Mitglieder des Lands werden benachrichtigt |
| `/chunks gift FremdesLand confirm` | Kauft den Slot. Die online Mitglieder des Lands werden benachrichtigt |
Der Preis wird günstiger, je kürzer die Wartezeit noch ist. Es wird immer der Slot freigekauft, der am frühesten frei würde.
Der Preis wird günstiger, je kürzer die Wartezeit noch ist. Es wird immer der Slot freigekauft, der am frühesten frei würde.
### Chunk vormerken (Warteschlange)
### Chunk vormerken (Warteschlange)
Der Chunk, auf dem du **gerade stehst**, ist frei, aber dein Land hat keinen freien Slot? Dann merk ihn vor. Sobald ein Slot frei wird, claimt das Plugin ihn **automatisch** für dich.
Der Chunk, auf dem du **gerade stehst**, ist frei, aber dein Land hat keinen freien Slot? Dann merk ihn vor. Sobald ein Slot frei wird, claimt das Plugin ihn **automatisch** für dich.
| Befehl | Was passiert |
| Befehl | Was passiert |
|---|---|
|---|---|
| `/chunks queue` | Merkt den Chunk vor, auf dem du stehst (für dein Hauptland) |
| `/chunks queue` | Merkt den Chunk vor, auf dem du stehst (für dein Hauptland) |
| `/chunks queue MeinLand` | Dasselbe, aber für ein bestimmtes Land |
| `/chunks queue MeinLand` | Dasselbe, aber für ein bestimmtes Land |
| `/chunks queue list` | Zeigt deine vorgemerkten Chunks |
| `/chunks queue list` | Zeigt deine vorgemerkten Chunks |
| `/chunks queue clear` | Löscht alle deine Vormerkungen |
| `/chunks queue clear` | Löscht alle deine Vormerkungen |
Wichtig: **Du musst online sein**, damit der Chunk geclaimt wird. Ist der Chunk inzwischen von jemand anderem geclaimt, wird die Vormerkung gelöscht.
Wichtig: **Du musst online sein**, damit der Chunk geclaimt wird. Ist der Chunk inzwischen von jemand anderem geclaimt, wird die Vormerkung gelöscht.
### Fremden Chunk beobachten (Watchlist)
### Fremden Chunk beobachten (Watchlist)
Ein Chunk gehört jemand anderem, und du willst ihn haben, falls er frei wird? Stell dich drauf:
Ein Chunk gehört jemand anderem, und du willst ihn haben, falls er frei wird? Stell dich drauf:
| Befehl | Was passiert |
| Befehl | Was passiert |
|---|---|
|---|---|
| `/chunks watch` | Du bekommst eine Nachricht, sobald dieser Chunk frei wird |
| `/chunks watch` | Du bekommst eine Nachricht, sobald dieser Chunk frei wird |
| `/chunks watch list` | Zeigt, was du beobachtest |
| `/chunks watch list` | Zeigt, was du beobachtest |
| `/chunks watch clear` | Hört mit allem auf |
| `/chunks watch clear` | Hört mit allem auf |
Tipp: Wenn die Nachricht kommt, nutze danach `/chunks queue`, um ihn dir zu sichern.
Tipp: Wenn die Nachricht kommt, nutze danach `/chunks queue`, um ihn dir zu sichern.
### Hinweis beim Einloggen
### Hinweis beim Einloggen
Beim Einloggen (kurz nach dem Join) sagt das Plugin dem Spieler, wie viele Slots in seinen Lands frei sind und wann der nächste gesperrte Slot frei wird. Der Besitzer bekommt zusätzlich eine Warnung, wenn das Land-Guthaben nicht für den Upkeep reicht und der Einzug bald ansteht.
Beim Einloggen (kurz nach dem Join) sagt das Plugin dem Spieler, wie viele Slots in seinen Lands frei sind und wann der nächste gesperrte Slot frei wird. Der Besitzer bekommt zusätzlich eine Warnung, wenn das Land-Guthaben nicht für den Upkeep reicht und der Einzug bald ansteht.
---
---
## 5. PvP-Regionen (für Admins)
## 5. PvP-Regionen (für Admins)
### Wozu?
### Wozu?
Lands verbietet PvP in der **Wildnis** zwischen Spielern, die im selben Land Mitglied sind (Meldung: „Du kannst diesen Spieler nicht in der Wildnis angreifen, weil er Mitglied in einem deiner Länder ist“). Mit einer PvP-Region kannst du einen Bereich festlegen, in dem trotzdem gekämpft werden darf, z. B. eine Arena.
Lands verbietet PvP in der **Wildnis** zwischen Spielern, die im selben Land Mitglied sind (Meldung: „Du kannst diesen Spieler nicht in der Wildnis angreifen, weil er Mitglied in einem deiner Länder ist“). Mit einer PvP-Region kannst du einen Bereich festlegen, in dem trotzdem gekämpft werden darf, z. B. eine Arena.
### Region anlegen
### Region anlegen
Du brauchst das Recht `landschunkinfo.admin` (Standard: OPs).
Du brauchst das Recht `landschunkinfo.admin` (Standard: OPs).
1. Stell dich an die erste Ecke der Arena: `/chunks pvp pos1`
1. Stell dich an die erste Ecke der Arena: `/chunks pvp pos1`
2. Stell dich an die gegenüberliegende Ecke: `/chunks pvp pos2`
2. Stell dich an die gegenüberliegende Ecke: `/chunks pvp pos2`
3. Lege die Region an: `/chunks pvp create arena`
3. Lege die Region an: `/chunks pvp create arena`
| Befehl | Was passiert |
| Befehl | Was passiert |
|---|---|
|---|---|
| `/chunks pvp pos1` | Setzt die erste Ecke an deiner Position |
| `/chunks pvp pos1` | Setzt die erste Ecke an deiner Position |
| `/chunks pvp pos2` | Setzt die zweite Ecke an deiner Position |
| `/chunks pvp pos2` | Setzt die zweite Ecke an deiner Position |
| `/chunks pvp create <Name>` | Legt die Region aus den beiden Ecken an |
| `/chunks pvp create <Name>` | Legt die Region aus den beiden Ecken an |
| `/chunks pvp delete <Name>` | Löscht die Region |
| `/chunks pvp delete <Name>` | Löscht die Region |
| `/chunks pvp list` | Zeigt alle Regionen |
| `/chunks pvp list` | Zeigt alle Regionen |
### Wie funktioniert das?
### Wie funktioniert das?
- Die Regionen sind **Rechtecke über die ganze Höhe**. Beide Ecken müssen in derselben Welt liegen.
- Die Regionen sind **Rechtecke über die ganze Höhe**. Beide Ecken müssen in derselben Welt liegen.
- Solange ein Spieler in einer PvP-Region steht, bekommt er automatisch das Lands-Recht `lands.bypass.attack_player`. Lands prüft den Angriff dann nicht, und die rote Meldung bleibt aus. Verlässt er die Region, wird das Recht wieder entzogen.
- Solange ein Spieler in einer PvP-Region steht, bekommt er automatisch das Lands-Recht `lands.bypass.attack_player`. Lands prüft den Angriff dann nicht, und die rote Meldung bleibt aus. Verlässt er die Region, wird das Recht wieder entzogen.
- Falls Lands einen Schlag trotzdem abbricht, wird er freigegeben, wenn **Angreifer und Opfer beide** in der Region stehen. Das gilt auch für Pfeile und andere Projektile.
- Falls Lands einen Schlag trotzdem abbricht, wird er freigegeben, wenn **Angreifer und Opfer beide** in der Region stehen. Das gilt auch für Pfeile und andere Projektile.
- Der Rückstoß wird in der Region ebenfalls freigegeben.
- Der Rückstoß wird in der Region ebenfalls freigegeben.
- **Außerhalb** der Region ändert sich nichts. Dort gelten weiter die Regeln von Lands.
- **Außerhalb** der Region ändert sich nichts. Dort gelten weiter die Regeln von Lands.
- Die Regionen werden in `plugins/LandsChunkInfo/pvp-regions.yml` gespeichert.
- Die Regionen werden in `plugins/LandsChunkInfo/pvp-regions.yml` gespeichert.
### Wichtig für die Server-Einrichtung
### Wichtig für die Server-Einrichtung
Die PvP-Region von diesem Plugin ist eine **zusätzliche** Region. Sie ersetzt keine WorldGuard-Region. Wenn du PvP sonst überall verbieten willst, regelst du das weiterhin in WorldGuard (z. B. `pvp deny` für die ganze Welt und `pvp allow` für die Arena). Lege die Region von diesem Plugin am besten genauso groß wie die WorldGuard-Arena an.
Die PvP-Region von diesem Plugin ist eine **zusätzliche** Region. Sie ersetzt keine WorldGuard-Region. Wenn du PvP sonst überall verbieten willst, regelst du das weiterhin in WorldGuard (z. B. `pvp deny` für die ganze Welt und `pvp allow` für die Arena). Lege die Region von diesem Plugin am besten genauso groß wie die WorldGuard-Arena an.
Alternative ohne dieses Plugin: In der Lands-Config (`plugins/Lands/config.yml`) gibt es unter `combat:` die Option `ally-wilderness`. Steht sie auf `true`, dürfen Spieler mit gemeinsamem Land überall in der Wildnis kämpfen. Nach einer Änderung ist ein Neustart nötig.
Alternative ohne dieses Plugin: In der Lands-Config (`plugins/Lands/config.yml`) gibt es unter `combat:` die Option `ally-wilderness`. Steht sie auf `true`, dürfen Spieler mit gemeinsamem Land überall in der Wildnis kämpfen. Nach einer Änderung ist ein Neustart nötig.
---
---
## 6. Die Platzhalter (optional)
## 6. Die Platzhalter (optional)
Nur nötig, wenn du **PlaceholderAPI** hast und die Werte z. B. im Scoreboard oder in der Tab-Liste anzeigen willst. Die Werte beziehen sich auf das Hauptland des Spielers (sein eigenes Land, sonst das erste Land, in dem er vertraut ist).
Nur nötig, wenn du **PlaceholderAPI** hast und die Werte z. B. im Scoreboard oder in der Tab-Liste anzeigen willst. Die Werte beziehen sich auf das Hauptland des Spielers (sein eigenes Land, sonst das erste Land, in dem er vertraut ist).
| Platzhalter | Zeigt |
| Platzhalter | Zeigt |
|---|---|
|---|---|
| `%chunkinfo_land%` | Name des Lands (`-` ohne Land) |
| `%chunkinfo_land%` | Name des Lands (`-` ohne Land) |
| `%chunkinfo_next_free%` | Zeit, bis der nächste Slot frei wird (`-` wenn keiner gesperrt ist) |
| `%chunkinfo_next_free%` | Zeit, bis der nächste Slot frei wird (`-` wenn keiner gesperrt ist) |
| `%chunkinfo_next_playtime%` | Online-Zeit bis zum nächsten Chunk durch Spielzeit (`-` wenn nicht eingerichtet oder Maximum erreicht) |
| `%chunkinfo_next_playtime%` | Online-Zeit bis zum nächsten Chunk durch Spielzeit (`-` wenn nicht eingerichtet oder Maximum erreicht) |
| `%chunkinfo_upkeep%` | Upkeep-Kosten pro Zyklus |
| `%chunkinfo_upkeep%` | Upkeep-Kosten pro Zyklus |
| `%chunkinfo_upkeep_in%` | Zeit bis zum nächsten Upkeep |
| `%chunkinfo_upkeep_in%` | Zeit bis zum nächsten Upkeep |
| `%chunkinfo_top_1_name%` | Name des Lands auf Platz 1 (statt 1 geht jede Zahl) |
| `%chunkinfo_top_1_name%` | Name des Lands auf Platz 1 (statt 1 geht jede Zahl) |
| `%chunkinfo_top_1_chunks%` | Chunks des Lands auf Platz 1 |
| `%chunkinfo_top_1_chunks%` | Chunks des Lands auf Platz 1 |
---
---
## 7. Einstellungen (config.yml)
## 7. Einstellungen (config.yml)
Die Datei findest du unter `plugins/LandsChunkInfo/config.yml`. Öffne sie mit einem Texteditor (Notepad++ oder VS Code). Nach einer Änderung gibst du im Spiel oder in der Konsole `/chunks reload` ein (braucht das Recht `landschunkinfo.admin`).
Die Datei findest du unter `plugins/LandsChunkInfo/config.yml`. Öffne sie mit einem Texteditor (Notepad++ oder VS Code). Nach einer Änderung gibst du im Spiel oder in der Konsole `/chunks reload` ein (braucht das Recht `landschunkinfo.admin`).
**Wichtig:** Lass die Einrückungen (die Leerzeichen am Zeilenanfang) unverändert. Ändere nur die Werte hinter dem Doppelpunkt.
**Wichtig:** Lass die Einrückungen (die Leerzeichen am Zeilenanfang) unverändert. Ändere nur die Werte hinter dem Doppelpunkt.
### Wartezeit nach dem Unclaimen
### Wartezeit nach dem Unclaimen
```yaml
```yaml
unclaim-cooldown:
unclaim-cooldown:
enabled:true
enabled:true
duration:24h
duration:24h
enforce:true
enforce:true
```
```
-`enabled`–`true` = Funktion an, `false` = aus.
-`enabled`–`true` = Funktion an, `false` = aus.
-`duration`– Wie lange ein Slot nach `/unclaim` gesperrt bleibt. Schreibweise:
-`duration`– Wie lange ein Slot nach `/unclaim` gesperrt bleibt. Schreibweise:
-`30m` = 30 Minuten
-`30m` = 30 Minuten
-`12h` = 12 Stunden
-`12h` = 12 Stunden
-`2d` = 2 Tage
-`2d` = 2 Tage
-`1d12h` = 1 Tag und 12 Stunden
-`1d12h` = 1 Tag und 12 Stunden
-`enforce`–`true` = Das Land kann in dieser Zeit wirklich **nicht** neu claimen, wenn alle Plätze belegt oder gesperrt sind. `false` = es wird nur angezeigt, aber nichts blockiert.
-`enforce`–`true` = Das Land kann in dieser Zeit wirklich **nicht** neu claimen, wenn alle Plätze belegt oder gesperrt sind. `false` = es wird nur angezeigt, aber nichts blockiert.
### Upkeep-Zeitpunkt
### Upkeep-Zeitpunkt
```yaml
```yaml
upkeep:
upkeep:
anchor-date:""
anchor-date:""
```
```
Das Plugin liest den Rhythmus aus der Lands-Config und merkt sich automatisch, wann Lands das erste Mal Upkeep eingezogen hat. **Bis dahin ist die Anzeige nur geschätzt.** Wenn du genau weißt, an welchem Tag zuletzt eingezogen wurde, trage das Datum ein, zum Beispiel `"2026-10-15"`.
Das Plugin liest den Rhythmus aus der Lands-Config und merkt sich automatisch, wann Lands das erste Mal Upkeep eingezogen hat. **Bis dahin ist die Anzeige nur geschätzt.** Wenn du genau weißt, an welchem Tag zuletzt eingezogen wurde, trage das Datum ein, zum Beispiel `"2026-10-15"`.
### Slot freikaufen
### Slot freikaufen
```yaml
```yaml
skip:
skip:
enabled:true
enabled:true
payment:PLAYER
payment:PLAYER
price-per-hour:25.0
price-per-hour:25.0
min-price:50.0
min-price:50.0
```
```
-`payment`–`PLAYER` = das Geld kommt vom Spieler (Vault nötig). `LAND` = das Geld kommt aus der Landkasse (nur der Besitzer darf das). `gift` bezahlt immer der Spieler selbst.
-`payment`–`PLAYER` = das Geld kommt vom Spieler (Vault nötig). `LAND` = das Geld kommt aus der Landkasse (nur der Besitzer darf das). `gift` bezahlt immer der Spieler selbst.
-`price-per-hour`– Preis pro verbleibender Stunde Wartezeit.
-`price-per-hour`– Preis pro verbleibender Stunde Wartezeit.
-`min-price`– Mindestpreis, auch wenn nur noch wenige Minuten fehlen.
-`min-price`– Mindestpreis, auch wenn nur noch wenige Minuten fehlen.
Beispiel: Noch 10 Stunden Wartezeit, 25 pro Stunde ergibt 250.
Beispiel: Noch 10 Stunden Wartezeit, 25 pro Stunde ergibt 250.
### Warteschlange, Watchlist, Top-Liste
### Warteschlange, Watchlist, Top-Liste
```yaml
```yaml
queue:
queue:
max:3
max:3
watch:
watch:
max:5
max:5
top:
top:
size:10
size:10
```
```
-`max`– Wie viele Einträge ein Spieler gleichzeitig haben darf.
-`max`– Wie viele Einträge ein Spieler gleichzeitig haben darf.
-`top.size`– Wie viele Lands in `/chunks top` stehen.
-`top.size`– Wie viele Lands in `/chunks top` stehen.
### Hinweis beim Einloggen
### Hinweis beim Einloggen
```yaml
```yaml
join-reminder:
join-reminder:
enabled:true
enabled:true
upkeep-warning-hours:48
upkeep-warning-hours:48
```
```
Mit `enabled: false` schaltest du den Hinweis ab. `upkeep-warning-hours` legt fest, ab wie vielen Stunden vor dem Einzug die Upkeep-Warnung kommt.
Mit `enabled: false` schaltest du den Hinweis ab. `upkeep-warning-hours` legt fest, ab wie vielen Stunden vor dem Einzug die Upkeep-Warnung kommt.
### Texte ändern
### Texte ändern
Unter `messages:` stehen die Meldungen. Farben schreibst du mit `&`:
Unter `messages:` stehen die Meldungen. Farben schreibst du mit `&`:
`%time%` wird im Spiel durch die Restzeit ersetzt. Lass es stehen.
`%time%` wird im Spiel durch die Restzeit ersetzt. Lass es stehen.
---
---
## 8. Rechte (Permissions)
## 8. Rechte (Permissions)
Rechte vergibst du mit einem Rechte-Plugin, z. B. LuckPerms.
Rechte vergibst du mit einem Rechte-Plugin, z. B. LuckPerms.
| Recht | Wer bekommt es standardmäßig? | Was erlaubt es? |
| Recht | Wer bekommt es standardmäßig? | Was erlaubt es? |
|---|---|---|
|---|---|---|
| `landschunkinfo.use` | Alle | `/chunks`, `top` und den Hinweis beim Einloggen |
| `landschunkinfo.use` | Alle | `/chunks`, `top` und den Hinweis beim Einloggen |
| `landschunkinfo.skip` | Alle | Eigenen Slot freikaufen |
| `landschunkinfo.skip` | Alle | Eigenen Slot freikaufen |
| `landschunkinfo.gift` | Alle | Slot in fremdem Land freikaufen |
| `landschunkinfo.gift` | Alle | Slot in fremdem Land freikaufen |
| `landschunkinfo.queue` | Alle | Warteschlange benutzen |
| `landschunkinfo.queue` | Alle | Warteschlange benutzen |
| `landschunkinfo.watch` | Alle | Watchlist benutzen |
| `landschunkinfo.watch` | Alle | Watchlist benutzen |
| `landschunkinfo.bypass` | Nur OPs | Wartezeit nach dem Unclaimen gilt **nicht** |
| `landschunkinfo.bypass` | Nur OPs | Wartezeit nach dem Unclaimen gilt **nicht** |
| `landschunkinfo.admin` | Nur OPs | `/chunks reload` und `/chunks pvp ...` |
| `landschunkinfo.admin` | Nur OPs | `/chunks reload` und `/chunks pvp ...` |
**Beispiel:** Du willst, dass niemand außer Teammitgliedern Slots verschenken darf. Entziehe allen das Recht `landschunkinfo.gift` und gib es nur der Team-Gruppe.
**Beispiel:** Du willst, dass niemand außer Teammitgliedern Slots verschenken darf. Entziehe allen das Recht `landschunkinfo.gift` und gib es nur der Team-Gruppe.
---
---
## 9. Häufige Fragen
## 9. Häufige Fragen
**Warum sieht ein Spieler „Gesperrt“, obwohl er nichts gemacht hat?**
**Warum sieht ein Spieler „Gesperrt“, obwohl er nichts gemacht hat?**
Jemand aus seinem Land hat einen Chunk abgegeben. Die Sperre gilt für das **ganze Land**, nicht für einzelne Spieler.
Jemand aus seinem Land hat einen Chunk abgegeben. Die Sperre gilt für das **ganze Land**, nicht für einzelne Spieler.
**Warum wird bei manchen Unclaims nichts gesperrt?**
**Warum wird bei manchen Unclaims nichts gesperrt?**
Gesperrt wird nur, wenn ein Spieler selbst `/unclaim` benutzt. Nicht gesperrt wird, wenn das Land gelöscht wird oder Chunks durch den Upkeep verloren gehen. Spieler mit dem Recht `landschunkinfo.bypass` lösen ebenfalls keine Sperre aus.
Gesperrt wird nur, wenn ein Spieler selbst `/unclaim` benutzt. Nicht gesperrt wird, wenn das Land gelöscht wird oder Chunks durch den Upkeep verloren gehen. Spieler mit dem Recht `landschunkinfo.bypass` lösen ebenfalls keine Sperre aus.
**Wie sehen Spieler, wie lange sie auf einen Chunk warten müssen?**
**Wie sehen Spieler, wie lange sie auf einen Chunk warten müssen?**
Mit `/chunks`. Dort steht „Nächster Chunk wieder frei in: …“.
Mit `/chunks`. Dort steht „Nächster Chunk wieder frei in: …“.
**Die Upkeep-Zeit stimmt nicht.**
**Die Upkeep-Zeit stimmt nicht.**
Lands verrät dem Plugin nicht, wann genau der Zyklus gestartet ist. Nach dem ersten echten Einzug passt die Anzeige. Alternativ trägst du in `upkeep.anchor-date` ein bekanntes Einzugsdatum ein.
Lands verrät dem Plugin nicht, wann genau der Zyklus gestartet ist. Nach dem ersten echten Einzug passt die Anzeige. Alternativ trägst du in `upkeep.anchor-date` ein bekanntes Einzugsdatum ein.
**Muss ich den Server neu starten?**
**Muss ich den Server neu starten?**
Für Änderungen an der `config.yml` reicht `/chunks reload`. Beim Austausch der Jar-Datei brauchst du einen Neustart (kein `/reload`).
Für Änderungen an der `config.yml` reicht `/chunks reload`. Beim Austausch der Jar-Datei brauchst du einen Neustart (kein `/reload`).
**Verlieren Spieler ihre Chunks, wenn ich das Plugin entferne?**
**Verlieren Spieler ihre Chunks, wenn ich das Plugin entferne?**
Nein. Das Plugin ändert keine Lands-Daten außer bei einer Sache: Wenn die Warteschlange einen Chunk claimt. Entfernst du das Plugin, bleiben alle bestehenden Chunks gleich. Die gespeicherten Sperren und Listen liegen nur in `plugins/LandsChunkInfo/data.yml`.
Nein. Das Plugin ändert keine Lands-Daten außer bei einer Sache: Wenn die Warteschlange einen Chunk claimt. Entfernst du das Plugin, bleiben alle bestehenden Chunks gleich. Die gespeicherten Sperren und Listen liegen nur in `plugins/LandsChunkInfo/data.yml`.
**Kann ich einem Spieler mehr Chunk-Slots geben?**
**Kann ich einem Spieler mehr Chunk-Slots geben?**
Nein, das geht nur in Lands selbst (`player-limits.yml`). Dieses Plugin ändert keine Limits.
Nein, das geht nur in Lands selbst (`player-limits.yml`). Dieses Plugin ändert keine Limits.
---
---
## 10. Datensicherung
## 10. Datensicherung
Alles, was sich das Plugin merkt, steht in diesen Dateien in `plugins/LandsChunkInfo/`:
Alles, was sich das Plugin merkt, steht in diesen Dateien in `plugins/LandsChunkInfo/`:
Wenn du den Server umziehst oder ein Backup machst, kopiere diese Dateien mit. **Bearbeite `data.yml` und `pvp-regions.yml` nicht von Hand, solange der Server läuft.** Das Plugin überschreibt die Dateien sonst.
Wenn du den Server umziehst oder ein Backup machst, kopiere diese Dateien mit. **Bearbeite `data.yml` und `pvp-regions.yml` nicht von Hand, solange der Server läuft.** Das Plugin überschreibt die Dateien sonst.
---
---
## 11. Wenn etwas nicht klappt
## 11. Wenn etwas nicht klappt
| Problem | Lösung |
| Problem | Lösung |
|---|---|
|---|---|
| Plugin startet nicht, in der Konsole steht etwas mit „Lands“ | Lands fehlt oder ist nicht aktiv. Prüfe, ob die Lands-Jar im Ordner `plugins` liegt und startet |
| Plugin startet nicht, in der Konsole steht etwas mit „Lands“ | Lands fehlt oder ist nicht aktiv. Prüfe, ob die Lands-Jar im Ordner `plugins` liegt und startet |
| Fehler mit „Unsupported class file version“ oder „Java“ | Der Server läuft mit einem zu alten Java. Du brauchst **Java 25** |
| Fehler mit „Unsupported class file version“ oder „Java“ | Der Server läuft mit einem zu alten Java. Du brauchst **Java 25** |
| `/chunkinfo` zeigt „Too many arguments“ oder die Ausgabe von WorldEdit | Das ist der Befehl von WorldEdit/FAWE, nicht von diesem Plugin. Benutze `/chunks` oder `/chunkslots` |
| `/chunkinfo` zeigt „Too many arguments“ oder die Ausgabe von WorldEdit | Das ist der Befehl von WorldEdit/FAWE, nicht von diesem Plugin. Benutze `/chunks` oder `/chunkslots` |
| `/chunks` sagt „Du bist in keinem Land Mitglied“ | Der Spieler hat kein Land und ist in keinem als vertrauenswürdig eingetragen. Das ist normal |
| `/chunks` sagt „Du bist in keinem Land Mitglied“ | Der Spieler hat kein Land und ist in keinem als vertrauenswürdig eingetragen. Das ist normal |
| `skip` oder `gift` meldet, Vault fehle | Installiere Vault und ein Economy-Plugin, oder stelle `skip.payment` auf `LAND` (dann geht nur `skip`, `gift` bleibt gesperrt) |
| `skip` oder `gift` meldet, Vault fehle | Installiere Vault und ein Economy-Plugin, oder stelle `skip.payment` auf `LAND` (dann geht nur `skip`, `gift` bleibt gesperrt) |
| Die Platzhalter zeigen sich als Text, z. B. `%chunkinfo_used%` | PlaceholderAPI fehlt oder wurde nach diesem Plugin geladen. Starte den Server neu |
| Die Platzhalter zeigen sich als Text, z. B. `%chunkinfo_used%` | PlaceholderAPI fehlt oder wurde nach diesem Plugin geladen. Starte den Server neu |
| Änderungen an der `config.yml` wirken nicht | `/chunks reload` ausführen. Falls es trotzdem nicht klappt: Auf Einrückungen und fehlende Anführungszeichen prüfen |
| Änderungen an der `config.yml` wirken nicht | `/chunks reload` ausführen. Falls es trotzdem nicht klappt: Auf Einrückungen und fehlende Anführungszeichen prüfen |
| Spieler können nach dem Unclaimen trotzdem sofort claimen | Prüfe `unclaim-cooldown.enforce`, das muss `true` sein. Und prüfe, ob der Spieler das Recht `landschunkinfo.bypass` hat (OPs haben es automatisch) |
| Spieler können nach dem Unclaimen trotzdem sofort claimen | Prüfe `unclaim-cooldown.enforce`, das muss `true` sein. Und prüfe, ob der Spieler das Recht `landschunkinfo.bypass` hat (OPs haben es automatisch) |
| In der PvP-Region kommt trotzdem die Lands-Meldung oder kein Schaden | Prüfe mit `/chunks pvp list`, ob die Region existiert und ob **beide** Spieler darin stehen. Die Region ist ein Rechteck: am Rand zählt der Block, auf dem man steht |
| In der PvP-Region kommt trotzdem die Lands-Meldung oder kein Schaden | Prüfe mit `/chunks pvp list`, ob die Region existiert und ob **beide** Spieler darin stehen. Die Region ist ein Rechteck: am Rand zählt der Block, auf dem man steht |
| Mitglieder desselben Lands bekommen in der Arena keinen Rückstoß | Das Plugin gibt den Rückstoß frei, wenn Lands ihn blockiert. Hilft das nicht, kommt es von einem anderen Plugin (z. B. Team- oder Friendly-Fire-Plugin) |
| Mitglieder desselben Lands bekommen in der Arena keinen Rückstoß | Das Plugin gibt den Rückstoß frei, wenn Lands ihn blockiert. Hilft das nicht, kommt es von einem anderen Plugin (z. B. Team- oder Friendly-Fire-Plugin) |
| Nach dem Update ist die alte Version aktiv | Es liegen zwei Jar-Dateien in `plugins`. Lösche die alte und starte neu |
| Nach dem Update ist die alte Version aktiv | Es liegen zwei Jar-Dateien in `plugins`. Lösche die alte und starte neu |
Wenn du nicht weiterkommst: Kopiere die **roten Zeilen aus der Server-Konsole** (oder aus `logs/latest.log`) und gib sie weiter. Daraus lässt sich fast immer die Ursache erkennen.
Wenn du nicht weiterkommst: Kopiere die **roten Zeilen aus der Server-Konsole** (oder aus `logs/latest.log`) und gib sie weiter. Daraus lässt sich fast immer die Ursache erkennen.
---
---
## 12. Bekannte Grenzen
## 12. Bekannte Grenzen
- Die PvP-Regionen funktionieren auf einem echten Server. Die übrigen Funktionen (Sperren, Skip, Queue, Watch) wurden dort noch nicht ausführlich getestet. Probiere neue Versionen erst auf einem Testserver aus.
- Die PvP-Regionen funktionieren auf einem echten Server. Die übrigen Funktionen (Sperren, Skip, Queue, Watch) wurden dort noch nicht ausführlich getestet. Probiere neue Versionen erst auf einem Testserver aus.
- Die Upkeep-Zeit ist bis zum ersten echten Einzug eine Schätzung.
- Die Upkeep-Zeit ist bis zum ersten echten Einzug eine Schätzung.
- Die Warteschlange und die Watchlist arbeiten nur für Spieler, die **online** sind.
- Die Warteschlange und die Watchlist arbeiten nur für Spieler, die **online** sind.
- Lands-Limits (z. B. maximale Chunks) kann das Plugin nicht verändern.
- Lands-Limits (z. B. maximale Chunks) kann das Plugin nicht verändern.
- PvP-Regionen sind einfache Rechtecke ohne Höhenbegrenzung und keine WorldGuard-Regionen.
- PvP-Regionen sind einfache Rechtecke ohne Höhenbegrenzung und keine WorldGuard-Regionen.
- Die rote Lands-Meldung zum PvP in der Wildnis kann das Plugin nicht umschreiben. Sie wird in der Arena nur vermieden, weil Lands den Angriff dort nicht mehr prüft.
- Die rote Lands-Meldung zum PvP in der Wildnis kann das Plugin nicht umschreiben. Sie wird in der Arena nur vermieden, weil Lands den Angriff dort nicht mehr prüft.
/** Hauptland: eigenes Land, sonst das erste Land, in dem man vertraut ist. */
/** Hauptland: eigenes Land, sonst das erste Land, in dem man vertraut ist. */
LandprimaryLand(UUIDuuid){
LandprimaryLand(UUIDuuid){
List<Land>l=landsOf(uuid);
List<Land>l=landsOf(uuid);
Reference in New Issue
Block a user
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.