M_Viper/LandsChunkInfo
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity

Upload via GUI (14 Dateien)

Browse Source
This commit is contained in:
M_Viper
2026-11-07 22:45:48 +00:00
parent 6be4f77ddb
commit c2ce2764f8
7 changed files with 549 additions and 377 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+142 -85
View File
@@ -1,10 +1,13 @@
# LandsChunkInfo – Anleitung # LandsChunkInfo – Anleitung (Version 1.0.4)
Dieses Plugin ist eine Erweiterung für das **Lands**-Plugin. Es zeigt Spielern: Dieses Plugin ist eine Erweiterung für das **Lands**-Plugin. Es bietet:
- wie viele Chunks sie schon besitzen, - **Chunk-Übersicht:** wie viele Chunks ein Land belegt, wie viele frei und wie viele gesperrt sind.
- wie viele noch frei sind, - **Wartezeit nach `/unclaim`:** Der Slot bleibt für eine einstellbare Zeit gesperrt. Die Spieler sehen, **wann wieder ein Chunk frei wird**.
- **wann wieder ein Chunk frei wird** (nach dem Unclaimen oder durch den Upkeep). - **Upkeep-Anzeige:** wann das Land das nächste Mal zahlen muss.
- **Slot freikaufen** (`skip`, `gift`), **Auto-Claim-Warteschlange**, **Watchlist** und **zeitlich begrenzte Claims**.
- **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.
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.
@@ -16,37 +19,46 @@ Du brauchst keine Programmierkenntnisse. Diese Anleitung erklärt alles Schritt
|---|---|---| |---|---|---|
| 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 unser 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 für das 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 (5 Schritte) ## 2. Installation und Update
1. Stoppe den Server (oder lass ihn laufen, ein Neustart ist trotzdem später nötig). 1. Stoppe den Server.
2. Kopiere die Datei `LandsChunkInfo-1.0.3.jar` in den Ordner `plugins` deines Servers. Dort liegt auch die Lands-Jar. 2. Kopiere `LandsChunkInfo-1.0.4.jar` in den Ordner `plugins` deines Servers (dort liegt auch die Lands-Jar).
3. Starte den Server neu. **Bei einem Update:** Lösche zuerst die alte `LandsChunkInfo-*.jar`. Es darf nur **eine** Version im Ordner liegen.
4. Schau in die Konsole. Du solltest `[LandsChunkInfo] Enabling LandsChunkInfo` sehen. Steht dort ein roter Fehler, lies Abschnitt 9. 3. Starte den Server.
5. Im Ordner `plugins/LandsChunkInfo/` wurde jetzt eine Datei `config.yml` erstellt. Dort kannst du alles einstellen (Abschnitt 5). 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).
Fertig. Spieler können ab sofort `/chunkinfo` benutzen. **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.
--- ---
## 3. Was können die Spieler? (Befehle) ## 3. Der Befehl
Der Hauptbefehl heißt `/chunkinfo`. Es gehen auch die Kurzformen `/chunks` und `/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“).
---
## 4. Was können die Spieler?
### Übersicht anzeigen ### Übersicht anzeigen
| Befehl | Was passiert | | Befehl | Was passiert |
|---|---| |---|---|
| `/chunkinfo` | Zeigt alle deine Lands: Chunks belegt, Chunks frei, gesperrte Slots, wann der nächste Chunk frei wird, Upkeep | | `/chunks` | Zeigt alle deine Lands: Chunks belegt, frei, gesperrt, wann der nächste Chunk frei wird, Upkeep |
| `/chunkinfo MeinLand` | Zeigt nur dieses eine Land | | `/chunks MeinLand` | Zeigt nur dieses eine Land |
| `/chunkinfo top` | Zeigt die Lands mit den meisten Chunks | | `/chunks top` | Zeigt die Lands mit den meisten Chunks |
**Beispiel einer Anzeige:** **Beispiel einer Anzeige:**
@@ -56,28 +68,30 @@ 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)
Sofort freischalten: /chunkinfo skip (Preis: 80,00) Danach: 20Std 5Min
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
``` ```
Was bedeuten die Wörter? Was bedeuten die Wörter?
- **Frei** = So viele Chunks kannst du jetzt sofort claimen. - **Frei** = So viele Chunks kann das Land jetzt sofort claimen.
- **Gesperrt** = Du hast 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 dein 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 Lands Inaktivität einstellt, steht dort auch, ob der Besitzer online ist oder wann das Land als inaktiv gilt.
### Gesperrten Slot sofort freikaufen ### Gesperrten Slot sofort freikaufen
Du willst nicht warten? Dann kauf den Slot frei.
| Befehl | Was passiert | | Befehl | Was passiert |
|---|---| |---|---|
| `/chunkinfo skip` | Zeigt dir den Preis | | `/chunks skip` | Zeigt den Preis für den nächsten gesperrten Slot deines Lands |
| `/chunkinfo skip confirm` | Kauft den Slot wirklich. Ohne `confirm` wird **nichts** bezahlt | | `/chunks skip confirm` | Kauft den Slot wirklich. Ohne `confirm` wird **nichts** bezahlt |
| `/chunkinfo gift MeinFreundLand` | Zeigt den Preis, um einen Slot in einem **fremden** Land freizukaufen | | `/chunks skip MeinLand confirm` | Dasselbe für ein bestimmtes eigenes Land |
| `/chunkinfo gift MeinFreundLand confirm` | Kauft den Slot für das fremde Land. Die Mitglieder werden benachrichtigt | | `/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 |
Der Preis wird günstiger, je kürzer die Wartezeit noch ist. 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)
@@ -85,12 +99,12 @@ Der Chunk, auf dem du **gerade stehst**, ist frei, aber dein Land hat keinen fre
| Befehl | Was passiert | | Befehl | Was passiert |
|---|---| |---|---|
| `/chunkinfo queue` | Merkt den Chunk vor, auf dem du stehst (für dein Land) | | `/chunks queue` | Merkt den Chunk vor, auf dem du stehst (für dein Hauptland) |
| `/chunkinfo queue MeinLand` | Dasselbe, aber für ein bestimmtes Land | | `/chunks queue MeinLand` | Dasselbe, aber für ein bestimmtes Land |
| `/chunkinfo queue list` | Zeigt deine vorgemerkten Chunks | | `/chunks queue list` | Zeigt deine vorgemerkten Chunks |
| `/chunkinfo 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. 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)
@@ -98,36 +112,79 @@ Ein Chunk gehört jemand anderem, und du willst ihn haben, falls er frei wird? S
| Befehl | Was passiert | | Befehl | Was passiert |
|---|---| |---|---|
| `/chunkinfo watch` | Du bekommst eine Nachricht, sobald dieser Chunk frei wird | | `/chunks watch` | Du bekommst eine Nachricht, sobald dieser Chunk frei wird |
| `/chunkinfo watch list` | Zeigt, was du beobachtest | | `/chunks watch list` | Zeigt, was du beobachtest |
| `/chunkinfo watch clear` | Hört mit allem auf | | `/chunks watch clear` | Hört mit allem auf |
Tipp: Wenn die Nachricht kommt, nutze danach `/chunkinfo queue`, um ihn dir zu sichern. Tipp: Wenn die Nachricht kommt, nutze danach `/chunks queue`, um ihn dir zu sichern.
### Chunk nur für kurze Zeit (Temp-Claim) ### Chunk nur für kurze Zeit (Temp-Claim)
Du brauchst einen Chunk nur für ein paar Tage (z. B. für ein Event)? Stell dich in den Chunk (er muss zu **deinem eigenen** Land gehören): Du brauchst einen Chunk nur für ein paar Tage (z. B. für ein Event)? Stell dich in den Chunk. Er muss zu **deinem eigenen** Land gehören (du musst der Besitzer sein):
| Befehl | Was passiert | | Befehl | Was passiert |
|---|---| |---|---|
| `/chunkinfo temp 7` | Der Chunk wird nach 7 Tagen automatisch freigegeben | | `/chunks temp 7` | Der Chunk wird nach 7 Tagen automatisch freigegeben |
| `/chunkinfo temp list` | Zeigt deine Temp-Chunks | | `/chunks temp list` | Zeigt die Temp-Chunks deiner Lands |
| `/chunkinfo temp cancel` | Nimmt dem Chunk, auf dem du stehst, das Ablaufdatum wieder weg | | `/chunks temp cancel` | Nimmt dem Chunk, auf dem du stehst, das Ablaufdatum wieder weg |
Wenn ein Temp-Chunk abläuft, wird dadurch **kein** Slot gesperrt. Wenn ein Temp-Chunk abläuft, wird dadurch **kein** Slot gesperrt.
### 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.
--- ---
## 4. Die Platzhalter (optional) ## 5. PvP-Regionen (für Admins)
### 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.
### Region anlegen
Du brauchst das Recht `landschunkinfo.admin` (Standard: OPs).
1. Stell dich an die erste Ecke der Arena: `/chunks pvp pos1`
2. Stell dich an die gegenüberliegende Ecke: `/chunks pvp pos2`
3. Lege die Region an: `/chunks pvp create arena`
| Befehl | Was passiert |
|---|---|
| `/chunks pvp pos1` | Setzt die erste 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 delete <Name>` | Löscht die Region |
| `/chunks pvp list` | Zeigt alle Regionen |
### Wie funktioniert das?
- 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.
- 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.
- **Außerhalb** der Region ändert sich nichts. Dort gelten weiter die Regeln von Lands.
- Die Regionen werden in `plugins/LandsChunkInfo/pvp-regions.yml` gespeichert.
### 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.
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)
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 | | `%chunkinfo_land%` | Name des Lands (`-` ohne Land) |
| `%chunkinfo_used%` | Belegte Chunks | | `%chunkinfo_used%` | Belegte Chunks |
| `%chunkinfo_max%` | Maximale Chunks | | `%chunkinfo_max%` | Maximale Chunks (oder `unbegrenzt`) |
| `%chunkinfo_free%` | Freie Chunks | | `%chunkinfo_free%` | Freie Chunks (oder `unbegrenzt`) |
| `%chunkinfo_locked%` | Gesperrte Slots | | `%chunkinfo_locked%` | Gesperrte Slots |
| `%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_upkeep%` | Upkeep-Kosten pro Zyklus | | `%chunkinfo_upkeep%` | Upkeep-Kosten pro Zyklus |
@@ -137,9 +194,9 @@ Nur nötig, wenn du **PlaceholderAPI** hast und die Werte z. B. im Scoreboard od
--- ---
## 5. 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, **nicht** mit dem Windows-Notepad, wenn du auf Umlaute achtest). Nach einer Änderung gibst du im Spiel oder in der Konsole `/chunkinfo reload` ein. 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.
@@ -158,7 +215,7 @@ unclaim-cooldown:
- `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` = Spieler können in dieser Zeit wirklich **nicht** neu claimen. `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
@@ -167,7 +224,7 @@ upkeep:
anchor-date: "" anchor-date: ""
``` ```
Das Plugin merkt sich automatisch, wann Lands das erste Mal Upkeep eingezogen hat, und rechnet danach weiter. **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
@@ -185,7 +242,7 @@ skip:
Beispiel: Noch 10 Stunden Wartezeit, 25 pro Stunde ergibt 250. Beispiel: Noch 10 Stunden Wartezeit, 25 pro Stunde ergibt 250.
### Warteschlange, Watchlist, Temp-Claims ### Warteschlange, Watchlist, Temp-Claims, Top-Liste
```yaml ```yaml
queue: queue:
@@ -196,11 +253,14 @@ temp-claims:
enabled: true enabled: true
max-days: 30 max-days: 30
max-per-land: 3 max-per-land: 3
top:
size: 10
``` ```
- `max` – Wie viele Einträge ein Spieler gleichzeitig haben darf. - `max` – Wie viele Einträge ein Spieler gleichzeitig haben darf.
- `max-days` – Längste erlaubte Dauer für einen Temp-Chunk. - `max-days` – Längste erlaubte Dauer für einen Temp-Chunk.
- `max-per-land` – Wie viele Temp-Chunks ein Land gleichzeitig haben darf. - `max-per-land` – Wie viele Temp-Chunks ein Land gleichzeitig haben darf.
- `top.size` – Wie viele Lands in `/chunks top` stehen.
### Hinweis beim Einloggen ### Hinweis beim Einloggen
@@ -210,7 +270,7 @@ join-reminder:
upkeep-warning-hours: 48 upkeep-warning-hours: 48
``` ```
Beim Einloggen sagt das Plugin dem Spieler, wie viele Slots frei sind. Wenn das Guthaben des Lands nicht für den Upkeep reicht und der Einzug in weniger als `upkeep-warning-hours` Stunden ansteht, kommt zusätzlich eine Warnung (nur für den Besitzer). 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
@@ -222,26 +282,26 @@ Unter `messages:` stehen die Meldungen. Farben schreibst du mit `&`:
--- ---
## 6. 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 | `/chunkinfo` und `top` benutzen | | `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.temp` | Alle | Temp-Claims benutzen | | `landschunkinfo.temp` | Alle | Temp-Claims 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 | `/chunkinfo reload` | | `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.
--- ---
## 7. 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.
@@ -249,11 +309,14 @@ Jemand aus seinem Land hat einen Chunk abgegeben. Die Sperre gilt für das **gan
**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, Chunks durch den Upkeep verloren gehen oder ein Temp-Chunk abläuft. 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, Chunks durch den Upkeep verloren gehen oder ein Temp-Chunk abläuft. Spieler mit dem Recht `landschunkinfo.bypass` lösen ebenfalls keine Sperre aus.
**Wie sehen Spieler, wie lange sie auf einen Chunk warten müssen?**
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 das Plugin nach jeder Änderung neu starten?** **Muss ich den Server neu starten?**
Nein. Für Änderungen an der `config.yml` reicht `/chunkinfo reload`. Nur beim Austausch der Jar-Datei brauchst du einen Neustart. 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 zwei Dingen: Wenn die Warteschlange einen Chunk claimt oder wenn ein Temp-Chunk abläuft. 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 zwei Dingen: Wenn die Warteschlange einen Chunk claimt oder wenn ein Temp-Chunk abläuft. Entfernst du das Plugin, bleiben alle bestehenden Chunks gleich. Die gespeicherten Sperren und Listen liegen nur in `plugins/LandsChunkInfo/data.yml`.
@@ -263,52 +326,46 @@ Nein, das geht nur in Lands selbst (`player-limits.yml`). Dieses Plugin ändert
--- ---
## 8. Datensicherung ## 10. Datensicherung
Alles, was sich das Plugin merkt (Sperren, Warteschlange, Watchlist, Temp-Chunks, letzter Upkeep), steht in: Alles, was sich das Plugin merkt, steht in diesen Dateien in `plugins/LandsChunkInfo/`:
`plugins/LandsChunkInfo/data.yml` | Datei | Inhalt |
|---|---|
| `config.yml` | Deine Einstellungen |
| `data.yml` | Sperren, Warteschlange, Watchlist, Temp-Chunks, letzter Upkeep |
| `pvp-regions.yml` | Die PvP-Regionen |
Wenn du den Server umziehst oder ein Backup machst, kopiere diese Datei und die `config.yml` mit. **Bearbeite `data.yml` nicht von Hand, solange der Server läuft.** Das Plugin überschreibt die Datei 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.
--- ---
## 9. 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` sagt „Du bist in keinem Land Mitglied“ | Der Spieler hat kein Land und ist in keinem als vertrauenswürdig eingetragen. Das ist normal | | `/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 |
| `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 unserem 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 | `/chunkinfo 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 |
| 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 |
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.
--- ---
## 10. Bekannte Grenzen ## 12. Bekannte Grenzen
- Das Plugin wurde noch nicht auf einem echten Server getestet. Probiere es erst auf einem Testserver aus. - Die PvP-Regionen funktionieren auf einem echten Server. Die übrigen Funktionen (Sperren, Skip, Queue, Watch, Temp) 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.
- Temp-Chunks laufen erst ab, wenn der Ersteller oder der Besitzer des Lands online ist. - Temp-Chunks laufen erst ab, wenn der Ersteller oder der Besitzer des Lands online ist.
- 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.
--- - 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.
## 11. PvP-Regionen (neu in 1.0.2, erweitert in 1.0.3)
Lands blockiert PvP in der Wildnis zwischen Spielern, die im selben Land Mitglied sind. Mit PvP-Regionen kannst du Bereiche festlegen, in denen trotzdem gekämpft werden darf (z. B. eine Arena).
| Befehl | Was passiert |
|---|---|
| `/chunkinfo pvp pos1` | Setzt die erste Ecke an deiner Position |
| `/chunkinfo pvp pos2` | Setzt die zweite Ecke an deiner Position |
| `/chunkinfo pvp create <Name>` | Legt die Region an |
| `/chunkinfo pvp delete <Name>` | Löscht die Region |
| `/chunkinfo pvp list` | Zeigt alle Regionen |
Dafür brauchst du das Recht `landschunkinfo.admin`. Die Regionen sind Rechtecke über die ganze Höhe und werden in `plugins/LandsChunkInfo/pvp-regions.yml` gespeichert. PvP wird nur freigegeben, wenn Angreifer und Opfer beide in der Region stehen.
pom.xml
+1 -1
View File
@@ -4,7 +4,7 @@
<modelVersion>4.0.0</modelVersion> <modelVersion>4.0.0</modelVersion>
<groupId>de.landschunkinfo</groupId> <groupId>de.landschunkinfo</groupId>
<artifactId>LandsChunkInfo</artifactId> <artifactId>LandsChunkInfo</artifactId>
<version>1.0.2</version> <version>1.0.4</version>
<packaging>jar</packaging> <packaging>jar</packaging>
<properties> <properties>
src/main/java/de/landschunkinfo/InfoCommand.java
+13 -13
View File
@@ -80,7 +80,7 @@ final class InfoCommand implements CommandExecutor, TabCompleter {
} }
case "create" -> { case "create" -> {
if (args.length < 3) { if (args.length < 3) {
plugin.send(p, "&cNutzung: /chunkinfo pvp create <Name>"); plugin.send(p, "&cNutzung: /chunks pvp create <Name>");
return; return;
} }
String err = plugin.pvp.create(p, args[2]); String err = plugin.pvp.create(p, args[2]);
@@ -88,7 +88,7 @@ final class InfoCommand implements CommandExecutor, TabCompleter {
} }
case "delete" -> { case "delete" -> {
if (args.length < 3) { if (args.length < 3) {
plugin.send(p, "&cNutzung: /chunkinfo pvp delete <Name>"); plugin.send(p, "&cNutzung: /chunks pvp delete <Name>");
return; return;
} }
plugin.send(p, plugin.pvp.delete(args[2]) ? "&aRegion geloescht." : "&cRegion nicht gefunden."); plugin.send(p, plugin.pvp.delete(args[2]) ? "&aRegion geloescht." : "&cRegion nicht gefunden.");
@@ -100,7 +100,7 @@ final class InfoCommand implements CommandExecutor, TabCompleter {
plugin.pvp.all().values().forEach(r -> p.sendMessage(plugin.line("&8- &e" + r.name() + " &7(" + r.world() plugin.pvp.all().values().forEach(r -> p.sendMessage(plugin.line("&8- &e" + r.name() + " &7(" + r.world()
+ ": " + r.minX() + "," + r.minZ() + " bis " + r.maxX() + "," + r.maxZ() + ")"))); + ": " + r.minX() + "," + r.minZ() + " bis " + r.maxX() + "," + r.maxZ() + ")")));
} }
default -> plugin.send(p, "&7/chunkinfo pvp pos1 | pos2 | create <Name> | delete <Name> | list"); default -> plugin.send(p, "&7/chunks pvp pos1 | pos2 | create <Name> | delete <Name> | list");
} }
} }
@@ -155,7 +155,7 @@ final class InfoCommand implements CommandExecutor, TabCompleter {
for (Land land : shown) { for (Land land : shown) {
describe(p, land); describe(p, land);
} }
p.sendMessage(plugin.line("&8Mehr: &7/chunkinfo top | skip | gift | queue | watch | temp")); p.sendMessage(plugin.line("&8Mehr: &7/chunks top | skip | gift | queue | watch | temp"));
} }
private void describe(Player p, Land land) { private void describe(Player p, Land land) {
@@ -187,7 +187,7 @@ final class InfoCommand implements CommandExecutor, TabCompleter {
p.sendMessage(plugin.line(sb + (locked.size() > 5 ? " ..." : ""))); p.sendMessage(plugin.line(sb + (locked.size() > 5 ? " ..." : "")));
} }
if (plugin.getConfig().getBoolean("skip.enabled", true)) { if (plugin.getConfig().getBoolean("skip.enabled", true)) {
p.sendMessage(plugin.line("&7Sofort freischalten: &e/chunkinfo skip &7(Preis: &e" p.sendMessage(plugin.line("&7Sofort freischalten: &e/chunks skip &7(Preis: &e"
+ price(first - now) + "&7)")); + price(first - now) + "&7)"));
} }
} }
@@ -253,7 +253,7 @@ final class InfoCommand implements CommandExecutor, TabCompleter {
return Math.max(min, remainingMs / 3_600_000.0 * perHour); return Math.max(min, remainingMs / 3_600_000.0 * perHour);
} }
/** /chunkinfo skip [Land] [confirm] bzw. /chunkinfo gift <Land> [confirm] */ /** /chunks skip [Land] [confirm] bzw. /chunks gift <Land> [confirm] */
private void skip(Player p, String[] args, boolean gift) { private void skip(Player p, String[] args, boolean gift) {
if (!allowed(p, gift ? "gift" : "skip")) { if (!allowed(p, gift ? "gift" : "skip")) {
return; return;
@@ -270,7 +270,7 @@ final class InfoCommand implements CommandExecutor, TabCompleter {
if (name != null) { if (name != null) {
land = findLand(name); land = findLand(name);
} else if (gift) { } else if (gift) {
plugin.send(p, "&cNutzung: /chunkinfo gift <Land> [confirm]"); plugin.send(p, "&cNutzung: /chunks gift <Land> [confirm]");
return; return;
} else { } else {
land = plugin.landsOf(p.getUniqueId()).stream() land = plugin.landsOf(p.getUniqueId()).stream()
@@ -304,7 +304,7 @@ final class InfoCommand implements CommandExecutor, TabCompleter {
if (!confirm) { if (!confirm) {
plugin.send(p, "&7Slot in &e" + land.getName() + " &7(noch &e" + TimeUtil.format(remaining) plugin.send(p, "&7Slot in &e" + land.getName() + " &7(noch &e" + TimeUtil.format(remaining)
+ "&7) freischalten fuer &e" + money(price) + (fromLand ? " &7aus der Landkasse" : "") + "&7) freischalten fuer &e" + money(price) + (fromLand ? " &7aus der Landkasse" : "")
+ "&7. Bestaetigen: &e/chunkinfo " + (gift ? "gift " : "skip ") + land.getName() + " confirm"); + "&7. Bestaetigen: &e/chunks " + (gift ? "gift " : "skip ") + land.getName() + " confirm");
return; return;
} }
@@ -361,12 +361,12 @@ final class InfoCommand implements CommandExecutor, TabCompleter {
int cx = p.getLocation().getBlockX() >> 4; int cx = p.getLocation().getBlockX() >> 4;
int cz = p.getLocation().getBlockZ() >> 4; int cz = p.getLocation().getBlockZ() >> 4;
if (plugin.lands.getLandByUnloadedChunk(w, cx, cz) != null) { if (plugin.lands.getLandByUnloadedChunk(w, cx, cz) != null) {
plugin.send(p, "&cDieser Chunk ist schon geclaimt. Mit &e/chunkinfo watch &ckannst du ihn beobachten."); plugin.send(p, "&cDieser Chunk ist schon geclaimt. Mit &e/chunks watch &ckannst du ihn beobachten.");
return; return;
} }
List<Entry> mine = plugin.store.entries(Kind.QUEUE).stream().filter(e -> e.player().equals(p.getUniqueId())).toList(); List<Entry> mine = plugin.store.entries(Kind.QUEUE).stream().filter(e -> e.player().equals(p.getUniqueId())).toList();
if (mine.size() >= plugin.getConfig().getInt("queue.max", 3)) { if (mine.size() >= plugin.getConfig().getInt("queue.max", 3)) {
plugin.send(p, "&cDeine Warteschlange ist voll (&e/chunkinfo queue clear&c)."); plugin.send(p, "&cDeine Warteschlange ist voll (&e/chunks queue clear&c).");
return; return;
} }
if (mine.stream().anyMatch(e -> e.at(w.getName(), cx, cz))) { if (mine.stream().anyMatch(e -> e.at(w.getName(), cx, cz))) {
@@ -400,12 +400,12 @@ final class InfoCommand implements CommandExecutor, TabCompleter {
int cz = p.getLocation().getBlockZ() >> 4; int cz = p.getLocation().getBlockZ() >> 4;
Land holder = plugin.lands.getLandByUnloadedChunk(w, cx, cz); Land holder = plugin.lands.getLandByUnloadedChunk(w, cx, cz);
if (holder == null) { if (holder == null) {
plugin.send(p, "&cDieser Chunk ist frei - du kannst ihn direkt claimen oder mit &e/chunkinfo queue &avormerken."); plugin.send(p, "&cDieser Chunk ist frei - du kannst ihn direkt claimen oder mit &e/chunks queue &avormerken.");
return; return;
} }
List<Entry> mine = plugin.store.entries(Kind.WATCH).stream().filter(e -> e.player().equals(p.getUniqueId())).toList(); List<Entry> mine = plugin.store.entries(Kind.WATCH).stream().filter(e -> e.player().equals(p.getUniqueId())).toList();
if (mine.size() >= plugin.getConfig().getInt("watch.max", 5)) { if (mine.size() >= plugin.getConfig().getInt("watch.max", 5)) {
plugin.send(p, "&cDeine Watchlist ist voll (&e/chunkinfo watch clear&c)."); plugin.send(p, "&cDeine Watchlist ist voll (&e/chunks watch clear&c).");
return; return;
} }
if (mine.stream().anyMatch(e -> e.at(w.getName(), cx, cz))) { if (mine.stream().anyMatch(e -> e.at(w.getName(), cx, cz))) {
@@ -469,7 +469,7 @@ final class InfoCommand implements CommandExecutor, TabCompleter {
try { try {
days = Integer.parseInt(arg); days = Integer.parseInt(arg);
} catch (NumberFormatException ex) { } catch (NumberFormatException ex) {
plugin.send(p, "&cNutzung: /chunkinfo temp <Tage> | cancel | list"); plugin.send(p, "&cNutzung: /chunks temp <Tage> | cancel | list");
return; return;
} }
int maxDays = plugin.getConfig().getInt("temp-claims.max-days", 30); int maxDays = plugin.getConfig().getInt("temp-claims.max-days", 30);
src/main/java/de/landschunkinfo/LandsChunkInfo.java
+7 -4
View File
@@ -67,17 +67,17 @@ public final class LandsChunkInfo extends JavaPlugin implements Listener {
vault = VaultHook.create(); vault = VaultHook.create();
} }
if (vault == null) { if (vault == null) {
getLogger().info("Vault/Economy nicht gefunden: Bezahlung nur aus der Landkasse moeglich, /chunkinfo gift ist deaktiviert."); getLogger().info("Vault/Economy nicht gefunden: Bezahlung nur aus der Landkasse moeglich, /chunks gift ist deaktiviert.");
} }
if (Bukkit.getPluginManager().getPlugin("PlaceholderAPI") != null) { if (Bukkit.getPluginManager().getPlugin("PlaceholderAPI") != null) {
new ChunkExpansion(this).register(); new ChunkExpansion(this).register();
} }
pvp = new PvpRegions(getDataFolder(), getLogger()); pvp = new PvpRegions(this, getDataFolder(), getLogger());
Bukkit.getPluginManager().registerEvents(pvp, this); Bukkit.getPluginManager().registerEvents(pvp, this);
Bukkit.getPluginManager().registerEvents(this, this); Bukkit.getPluginManager().registerEvents(this, this);
InfoCommand command = new InfoCommand(this); InfoCommand command = new InfoCommand(this);
var cmd = getCommand("chunkinfo"); var cmd = getCommand("chunks");
if (cmd != null) { if (cmd != null) {
cmd.setExecutor(command); cmd.setExecutor(command);
cmd.setTabCompleter(command); cmd.setTabCompleter(command);
@@ -87,6 +87,9 @@ public final class LandsChunkInfo extends JavaPlugin implements Listener {
@Override @Override
public void onDisable() { public void onDisable() {
if (pvp != null) {
pvp.shutdown();
}
if (store != null) { if (store != null) {
store.save(); store.save();
} }
@@ -374,7 +377,7 @@ public final class LandsChunkInfo extends JavaPlugin implements Listener {
if (lands.getLandByUnloadedChunk(w, e.x(), e.z()) == null) { if (lands.getLandByUnloadedChunk(w, e.x(), e.z()) == null) {
store.remove(Kind.WATCH, e); store.remove(Kind.WATCH, e);
send(p, "&aDer beobachtete Chunk &e" + e.x() + ", " + e.z() + " &a(" + e.world() send(p, "&aDer beobachtete Chunk &e" + e.x() + ", " + e.z() + " &a(" + e.world()
+ ") ist jetzt frei! Mit &e/chunkinfo queue &akannst du ihn dir sichern."); + ") ist jetzt frei! Mit &e/chunks queue &akannst du ihn dir sichern.");
} }
} }
} }
src/main/java/de/landschunkinfo/PvpRegions.java
+115 -3
View File
@@ -10,6 +10,15 @@ import org.bukkit.event.EventHandler;
import org.bukkit.event.EventPriority; import org.bukkit.event.EventPriority;
import org.bukkit.event.Listener; import org.bukkit.event.Listener;
import org.bukkit.event.entity.EntityDamageByEntityEvent; import org.bukkit.event.entity.EntityDamageByEntityEvent;
import org.bukkit.event.player.PlayerJoinEvent;
import org.bukkit.event.player.PlayerMoveEvent;
import org.bukkit.event.player.PlayerQuitEvent;
import org.bukkit.event.player.PlayerTeleportEvent;
import org.bukkit.event.player.PlayerVelocityEvent;
import org.bukkit.event.entity.EntityKnockbackByEntityEvent;
import org.bukkit.permissions.PermissionAttachment;
import org.bukkit.plugin.java.JavaPlugin;
import org.bukkit.Bukkit;
import java.io.File; import java.io.File;
import java.io.IOException; import java.io.IOException;
@@ -36,13 +45,20 @@ final class PvpRegions implements Listener {
} }
} }
private static final String BYPASS = "lands.bypass.attack_player";
/** Spieler, die gerade in einer PvP-Region getroffen wurden (fuer den Rueckstoss). */
private final Map<UUID, Long> recentHit = new ConcurrentHashMap<>();
private final JavaPlugin plugin;
private final Map<UUID, PermissionAttachment> bypass = new ConcurrentHashMap<>();
private final File file; private final File file;
private final Logger log; private final Logger log;
private final Map<String, Region> regions = new LinkedHashMap<>(); private final Map<String, Region> regions = new LinkedHashMap<>();
private final Map<UUID, Location> pos1 = new ConcurrentHashMap<>(); private final Map<UUID, Location> pos1 = new ConcurrentHashMap<>();
private final Map<UUID, Location> pos2 = new ConcurrentHashMap<>(); private final Map<UUID, Location> pos2 = new ConcurrentHashMap<>();
PvpRegions(File dataFolder, Logger log) { PvpRegions(JavaPlugin plugin, File dataFolder, Logger log) {
this.plugin = plugin;
this.file = new File(dataFolder, "pvp-regions.yml"); this.file = new File(dataFolder, "pvp-regions.yml");
this.log = log; this.log = log;
load(); load();
@@ -100,7 +116,7 @@ final class PvpRegions implements Listener {
Location a = pos1.get(p.getUniqueId()); Location a = pos1.get(p.getUniqueId());
Location b = pos2.get(p.getUniqueId()); Location b = pos2.get(p.getUniqueId());
if (a == null || b == null) { if (a == null || b == null) {
return "Setze zuerst &e/chunkinfo pvp pos1 &7und &e/chunkinfo pvp pos2&7."; return "Setze zuerst &e/chunks pvp pos1 &7und &e/chunks pvp pos2&7.";
} }
if (a.getWorld() == null || !a.getWorld().equals(b.getWorld())) { if (a.getWorld() == null || !a.getWorld().equals(b.getWorld())) {
return "Beide Punkte muessen in derselben Welt liegen."; return "Beide Punkte muessen in derselben Welt liegen.";
@@ -109,6 +125,7 @@ final class PvpRegions implements Listener {
Math.min(a.getBlockX(), b.getBlockX()), Math.min(a.getBlockZ(), b.getBlockZ()), Math.min(a.getBlockX(), b.getBlockX()), Math.min(a.getBlockZ(), b.getBlockZ()),
Math.max(a.getBlockX(), b.getBlockX()), Math.max(a.getBlockZ(), b.getBlockZ()))); Math.max(a.getBlockX(), b.getBlockX()), Math.max(a.getBlockZ(), b.getBlockZ())));
save(); save();
refreshAll();
return null; return null;
} }
@@ -116,6 +133,7 @@ final class PvpRegions implements Listener {
boolean removed = regions.remove(name.toLowerCase()) != null; boolean removed = regions.remove(name.toLowerCase()) != null;
if (removed) { if (removed) {
save(); save();
refreshAll();
} }
return removed; return removed;
} }
@@ -137,6 +155,77 @@ final class PvpRegions implements Listener {
return false; return false;
} }
// ------------------------------------------------- Lands-Bypass in Regionen
/** Gibt dem Spieler in einer PvP-Region das Lands-Recht zum Angreifen, sonst entzieht es es. */
void refresh(Player p) {
refreshAt(p, p.isOnline() && inRegion(p.getLocation()));
}
void refreshAll() {
for (Player p : Bukkit.getOnlinePlayers()) {
refresh(p);
}
}
void shutdown() {
for (Player p : Bukkit.getOnlinePlayers()) {
PermissionAttachment att = bypass.remove(p.getUniqueId());
if (att != null) {
try {
p.removeAttachment(att);
} catch (IllegalArgumentException ignored) {
// schon entfernt
}
}
}
}
@EventHandler
public void onMove(PlayerMoveEvent e) {
if (e.getTo() == null || regions.isEmpty() && bypass.isEmpty()) {
return;
}
if (e.getFrom().getBlockX() != e.getTo().getBlockX() || e.getFrom().getBlockZ() != e.getTo().getBlockZ()) {
boolean inside = inRegion(e.getTo());
if (inside != bypass.containsKey(e.getPlayer().getUniqueId())) {
refreshAt(e.getPlayer(), inside);
}
}
}
@EventHandler
public void onTeleport(PlayerTeleportEvent e) {
refreshAt(e.getPlayer(), inRegion(e.getTo()));
}
@EventHandler
public void onJoin(PlayerJoinEvent e) {
refresh(e.getPlayer());
}
@EventHandler
public void onQuit(PlayerQuitEvent e) {
bypass.remove(e.getPlayer().getUniqueId());
recentHit.remove(e.getPlayer().getUniqueId());
}
private void refreshAt(Player p, boolean inside) {
PermissionAttachment att = bypass.get(p.getUniqueId());
if (inside && att == null) {
PermissionAttachment a = p.addAttachment(plugin);
a.setPermission(BYPASS, true);
bypass.put(p.getUniqueId(), a);
} else if (!inside && att != null) {
bypass.remove(p.getUniqueId());
try {
p.removeAttachment(att);
} catch (IllegalArgumentException ignored) {
// schon entfernt
}
}
}
// ----------------------------------------------------------------- Event // ----------------------------------------------------------------- Event
/** /**
@@ -145,7 +234,7 @@ final class PvpRegions implements Listener {
*/ */
@EventHandler(priority = EventPriority.HIGHEST) @EventHandler(priority = EventPriority.HIGHEST)
public void onDamage(EntityDamageByEntityEvent e) { public void onDamage(EntityDamageByEntityEvent e) {
if (!e.isCancelled() || regions.isEmpty() || !(e.getEntity() instanceof Player victim)) { if (regions.isEmpty() || !(e.getEntity() instanceof Player victim)) {
return; return;
} }
Entity damager = e.getDamager(); Entity damager = e.getDamager();
@@ -156,7 +245,30 @@ final class PvpRegions implements Listener {
return; return;
} }
if (inRegion(attacker.getLocation()) && inRegion(victim.getLocation())) { if (inRegion(attacker.getLocation()) && inRegion(victim.getLocation())) {
recentHit.put(victim.getUniqueId(), System.currentTimeMillis());
if (e.isCancelled()) {
e.setCancelled(false);
}
}
}
/** Rueckstoss in der PvP-Region freigeben, falls Lands ihn fuer Land-Mitglieder unterdrueckt. */
@EventHandler(priority = EventPriority.HIGHEST)
public void onKnockback(EntityKnockbackByEntityEvent e) {
if (e.isCancelled() && e.getEntity() instanceof Player victim && isRecent(victim)) {
e.setCancelled(false); e.setCancelled(false);
} }
} }
@EventHandler(priority = EventPriority.HIGHEST)
public void onVelocity(PlayerVelocityEvent e) {
if (e.isCancelled() && isRecent(e.getPlayer())) {
e.setCancelled(false);
}
}
private boolean isRecent(Player victim) {
Long t = recentHit.get(victim.getUniqueId());
return t != null && System.currentTimeMillis() - t < 500 && inRegion(victim.getLocation());
}
} }
src/main/resources/config.yml
+4 -4
View File
@@ -22,7 +22,7 @@ messages:
reloaded: "&aKonfiguration neu geladen." reloaded: "&aKonfiguration neu geladen."
claim-blocked: "&cAlle freien Chunk-Slots sind nach einem Unclaim noch gesperrt. Nächster Slot frei in &e%time%&c." claim-blocked: "&cAlle freien Chunk-Slots sind nach einem Unclaim noch gesperrt. Nächster Slot frei in &e%time%&c."
# Gesperrten Slot sofort freischalten (/chunkinfo skip, /chunkinfo gift <Land>). # Gesperrten Slot sofort freischalten (/chunks skip, /chunks gift <Land>).
skip: skip:
enabled: true enabled: true
# PLAYER = Geld des Spielers (Vault), LAND = Landkasse (nur Besitzer). gift nutzt immer PLAYER. # PLAYER = Geld des Spielers (Vault), LAND = Landkasse (nur Besitzer). gift nutzt immer PLAYER.
@@ -31,16 +31,16 @@ skip:
price-per-hour: 25.0 price-per-hour: 25.0
min-price: 50.0 min-price: 50.0
# Auto-Claim-Warteschlange (/chunkinfo queue): claimt vorgemerkte freie Chunks, sobald ein Slot frei ist. # Auto-Claim-Warteschlange (/chunks queue): claimt vorgemerkte freie Chunks, sobald ein Slot frei ist.
# Der Spieler muss dafuer online sein. # Der Spieler muss dafuer online sein.
queue: queue:
max: 3 max: 3
# Watchlist (/chunkinfo watch): Nachricht, sobald ein fremder Chunk frei wird. # Watchlist (/chunks watch): Nachricht, sobald ein fremder Chunk frei wird.
watch: watch:
max: 5 max: 5
# Zeitlich begrenzte Claims (/chunkinfo temp <Tage>): Chunk wird nach Ablauf automatisch freigegeben, # Zeitlich begrenzte Claims (/chunks temp <Tage>): Chunk wird nach Ablauf automatisch freigegeben,
# ohne dass dadurch ein Slot gesperrt wird. # ohne dass dadurch ein Slot gesperrt wird.
temp-claims: temp-claims:
enabled: true enabled: true
src/main/resources/plugin.yml
+4 -4
View File
@@ -7,13 +7,13 @@ softdepend: [Vault, PlaceholderAPI]
folia-supported: false folia-supported: false
description: Zeigt Spielern ihre Chunks und wann wieder ein Chunk frei wird (Unclaim-Cooldown und Upkeep), mit Skip, Queue, Watchlist, Temp-Claims und Platzhaltern. description: Zeigt Spielern ihre Chunks und wann wieder ein Chunk frei wird (Unclaim-Cooldown und Upkeep), mit Skip, Queue, Watchlist, Temp-Claims und Platzhaltern.
commands: commands:
chunkinfo: chunks:
description: Chunk-Belegung, freie Slots, Upkeep, Queue, Watchlist und mehr description: Chunk-Belegung, freie Slots, Upkeep, Queue, Watchlist und mehr
usage: /<command> [land|top|skip|gift|queue|watch|temp] usage: /<command> [land|top|skip|gift|queue|watch|temp]
aliases: [chunks, chunkslots] aliases: [chunkslots]
permissions: permissions:
landschunkinfo.use: landschunkinfo.use:
description: /chunkinfo benutzen description: /chunks benutzen
default: true default: true
landschunkinfo.skip: landschunkinfo.skip:
description: Gesperrten Slot freikaufen description: Gesperrten Slot freikaufen
@@ -34,5 +34,5 @@ permissions:
description: Unclaim-Cooldown ignorieren description: Unclaim-Cooldown ignorieren
default: op default: op
landschunkinfo.admin: landschunkinfo.admin:
description: /chunkinfo reload description: /chunks reload
default: op default: op