Upload via GUI (14 Dateien)
This commit is contained in:
@@ -1,314 +1,371 @@
|
||||
# LandsChunkInfo – Anleitung
|
||||
|
||||
Dieses Plugin ist eine Erweiterung für das **Lands**-Plugin. Es zeigt Spielern:
|
||||
|
||||
- wie viele Chunks sie schon besitzen,
|
||||
- wie viele noch frei sind,
|
||||
- **wann wieder ein Chunk frei wird** (nach dem Unclaimen oder durch den Upkeep).
|
||||
|
||||
Du brauchst keine Programmierkenntnisse. Diese Anleitung erklärt alles Schritt für Schritt.
|
||||
|
||||
---
|
||||
|
||||
## 1. Was brauche ich?
|
||||
|
||||
| Was | Pflicht? | Wofür |
|
||||
|---|---|---|
|
||||
| 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 |
|
||||
| Das Plugin **Lands** (Version 8.8.0) | Ja | Ohne Lands startet unser Plugin nicht |
|
||||
| **Vault** + ein Economy-Plugin (z. B. EssentialsX) | Nein | Nur für das Bezahlen mit Spielergeld (`skip`, `gift`) |
|
||||
| **PlaceholderAPI** | Nein | Nur für Platzhalter in Scoreboard, Tab-Liste usw. |
|
||||
|
||||
Folia wird **nicht** unterstützt.
|
||||
|
||||
---
|
||||
|
||||
## 2. Installation (5 Schritte)
|
||||
|
||||
1. Stoppe den Server (oder lass ihn laufen, ein Neustart ist trotzdem später nötig).
|
||||
2. Kopiere die Datei `LandsChunkInfo-1.0.3.jar` in den Ordner `plugins` deines Servers. Dort liegt auch die Lands-Jar.
|
||||
3. Starte den Server neu.
|
||||
4. Schau in die Konsole. Du solltest `[LandsChunkInfo] Enabling LandsChunkInfo` sehen. Steht dort ein roter Fehler, lies Abschnitt 9.
|
||||
5. Im Ordner `plugins/LandsChunkInfo/` wurde jetzt eine Datei `config.yml` erstellt. Dort kannst du alles einstellen (Abschnitt 5).
|
||||
|
||||
Fertig. Spieler können ab sofort `/chunkinfo` benutzen.
|
||||
|
||||
---
|
||||
|
||||
## 3. Was können die Spieler? (Befehle)
|
||||
|
||||
Der Hauptbefehl heißt `/chunkinfo`. Es gehen auch die Kurzformen `/chunks` und `/chunkslots`.
|
||||
|
||||
### Übersicht anzeigen
|
||||
|
||||
| Befehl | Was passiert |
|
||||
|---|---|
|
||||
| `/chunkinfo` | Zeigt alle deine Lands: Chunks belegt, Chunks frei, gesperrte Slots, wann der nächste Chunk frei wird, Upkeep |
|
||||
| `/chunkinfo MeinLand` | Zeigt nur dieses eine Land |
|
||||
| `/chunkinfo top` | Zeigt die Lands mit den meisten Chunks |
|
||||
|
||||
**Beispiel einer Anzeige:**
|
||||
|
||||
```
|
||||
Deine Chunks
|
||||
Von dir geclaimt: 12 / 20
|
||||
MeinLand
|
||||
Chunks: 12 / 20 | Frei: 6 | Gesperrt: 2
|
||||
Nächster Chunk wieder frei in: 3Std 12Min (23.10. 14:30)
|
||||
Sofort freischalten: /chunkinfo skip (Preis: 80,00)
|
||||
Upkeep: 36,00 pro Zyklus, nächster Einzug in 2T 4Std
|
||||
```
|
||||
|
||||
Was bedeuten die Wörter?
|
||||
|
||||
- **Frei** = So viele Chunks kannst du 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.
|
||||
- **Upkeep** = Die regelmäßige Gebühr, die dein Land zahlen muss, damit es seine Chunks behält.
|
||||
|
||||
### Gesperrten Slot sofort freikaufen
|
||||
|
||||
Du willst nicht warten? Dann kauf den Slot frei.
|
||||
|
||||
| Befehl | Was passiert |
|
||||
|---|---|
|
||||
| `/chunkinfo skip` | Zeigt dir den Preis |
|
||||
| `/chunkinfo 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 |
|
||||
| `/chunkinfo gift MeinFreundLand confirm` | Kauft den Slot für das fremde Land. Die Mitglieder werden benachrichtigt |
|
||||
|
||||
Der Preis wird günstiger, je kürzer die Wartezeit noch ist.
|
||||
|
||||
### 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.
|
||||
|
||||
| Befehl | Was passiert |
|
||||
|---|---|
|
||||
| `/chunkinfo queue` | Merkt den Chunk vor, auf dem du stehst (für dein Land) |
|
||||
| `/chunkinfo queue MeinLand` | Dasselbe, aber für ein bestimmtes Land |
|
||||
| `/chunkinfo queue list` | Zeigt deine vorgemerkten Chunks |
|
||||
| `/chunkinfo queue clear` | Löscht alle deine Vormerkungen |
|
||||
|
||||
Wichtig: **Du musst online sein**, damit der Chunk geclaimt wird.
|
||||
|
||||
### Fremden Chunk beobachten (Watchlist)
|
||||
|
||||
Ein Chunk gehört jemand anderem, und du willst ihn haben, falls er frei wird? Stell dich drauf:
|
||||
|
||||
| Befehl | Was passiert |
|
||||
|---|---|
|
||||
| `/chunkinfo watch` | Du bekommst eine Nachricht, sobald dieser Chunk frei wird |
|
||||
| `/chunkinfo watch list` | Zeigt, was du beobachtest |
|
||||
| `/chunkinfo watch clear` | Hört mit allem auf |
|
||||
|
||||
Tipp: Wenn die Nachricht kommt, nutze danach `/chunkinfo queue`, um ihn dir zu sichern.
|
||||
|
||||
### 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):
|
||||
|
||||
| Befehl | Was passiert |
|
||||
|---|---|
|
||||
| `/chunkinfo temp 7` | Der Chunk wird nach 7 Tagen automatisch freigegeben |
|
||||
| `/chunkinfo temp list` | Zeigt deine Temp-Chunks |
|
||||
| `/chunkinfo temp cancel` | Nimmt dem Chunk, auf dem du stehst, das Ablaufdatum wieder weg |
|
||||
|
||||
Wenn ein Temp-Chunk abläuft, wird dadurch **kein** Slot gesperrt.
|
||||
|
||||
---
|
||||
|
||||
## 4. 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).
|
||||
|
||||
| Platzhalter | Zeigt |
|
||||
|---|---|
|
||||
| `%chunkinfo_land%` | Name des Lands |
|
||||
| `%chunkinfo_used%` | Belegte Chunks |
|
||||
| `%chunkinfo_max%` | Maximale Chunks |
|
||||
| `%chunkinfo_free%` | Freie Chunks |
|
||||
| `%chunkinfo_locked%` | Gesperrte Slots |
|
||||
| `%chunkinfo_next_free%` | Zeit, bis der nächste Slot frei wird (`-` wenn keiner gesperrt ist) |
|
||||
| `%chunkinfo_upkeep%` | Upkeep-Kosten pro Zyklus |
|
||||
| `%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_chunks%` | Chunks des Lands auf Platz 1 |
|
||||
|
||||
---
|
||||
|
||||
## 5. 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.
|
||||
|
||||
**Wichtig:** Lass die Einrückungen (die Leerzeichen am Zeilenanfang) unverändert. Ändere nur die Werte hinter dem Doppelpunkt.
|
||||
|
||||
### Wartezeit nach dem Unclaimen
|
||||
|
||||
```yaml
|
||||
unclaim-cooldown:
|
||||
enabled: true
|
||||
duration: 24h
|
||||
enforce: true
|
||||
```
|
||||
|
||||
- `enabled` – `true` = Funktion an, `false` = aus.
|
||||
- `duration` – Wie lange ein Slot nach `/unclaim` gesperrt bleibt. Schreibweise:
|
||||
- `30m` = 30 Minuten
|
||||
- `12h` = 12 Stunden
|
||||
- `2d` = 2 Tage
|
||||
- `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.
|
||||
|
||||
### Upkeep-Zeitpunkt
|
||||
|
||||
```yaml
|
||||
upkeep:
|
||||
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"`.
|
||||
|
||||
### Slot freikaufen
|
||||
|
||||
```yaml
|
||||
skip:
|
||||
enabled: true
|
||||
payment: PLAYER
|
||||
price-per-hour: 25.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.
|
||||
- `price-per-hour` – Preis pro verbleibender Stunde Wartezeit.
|
||||
- `min-price` – Mindestpreis, auch wenn nur noch wenige Minuten fehlen.
|
||||
|
||||
Beispiel: Noch 10 Stunden Wartezeit, 25 pro Stunde ergibt 250.
|
||||
|
||||
### Warteschlange, Watchlist, Temp-Claims
|
||||
|
||||
```yaml
|
||||
queue:
|
||||
max: 3
|
||||
watch:
|
||||
max: 5
|
||||
temp-claims:
|
||||
enabled: true
|
||||
max-days: 30
|
||||
max-per-land: 3
|
||||
```
|
||||
|
||||
- `max` – Wie viele Einträge ein Spieler gleichzeitig haben darf.
|
||||
- `max-days` – Längste erlaubte Dauer für einen Temp-Chunk.
|
||||
- `max-per-land` – Wie viele Temp-Chunks ein Land gleichzeitig haben darf.
|
||||
|
||||
### Hinweis beim Einloggen
|
||||
|
||||
```yaml
|
||||
join-reminder:
|
||||
enabled: true
|
||||
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).
|
||||
|
||||
### Texte ändern
|
||||
|
||||
Unter `messages:` stehen die Meldungen. Farben schreibst du mit `&`:
|
||||
|
||||
- `&a` = grün, `&c` = rot, `&e` = gelb, `&7` = grau
|
||||
|
||||
`%time%` wird im Spiel durch die Restzeit ersetzt. Lass es stehen.
|
||||
|
||||
---
|
||||
|
||||
## 6. Rechte (Permissions)
|
||||
|
||||
Rechte vergibst du mit einem Rechte-Plugin, z. B. LuckPerms.
|
||||
|
||||
| Recht | Wer bekommt es standardmäßig? | Was erlaubt es? |
|
||||
|---|---|---|
|
||||
| `landschunkinfo.use` | Alle | `/chunkinfo` und `top` benutzen |
|
||||
| `landschunkinfo.skip` | Alle | Eigenen Slot freikaufen |
|
||||
| `landschunkinfo.gift` | Alle | Slot in fremdem Land freikaufen |
|
||||
| `landschunkinfo.queue` | Alle | Warteschlange benutzen |
|
||||
| `landschunkinfo.watch` | Alle | Watchlist benutzen |
|
||||
| `landschunkinfo.temp` | Alle | Temp-Claims benutzen |
|
||||
| `landschunkinfo.bypass` | Nur OPs | Wartezeit nach dem Unclaimen gilt **nicht** |
|
||||
| `landschunkinfo.admin` | Nur OPs | `/chunkinfo reload` |
|
||||
|
||||
**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
|
||||
|
||||
**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.
|
||||
|
||||
**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.
|
||||
|
||||
**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.
|
||||
|
||||
**Muss ich das Plugin nach jeder Änderung neu starten?**
|
||||
Nein. Für Änderungen an der `config.yml` reicht `/chunkinfo reload`. Nur beim Austausch der Jar-Datei brauchst du einen Neustart.
|
||||
|
||||
**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`.
|
||||
|
||||
**Kann ich einem Spieler mehr Chunk-Slots geben?**
|
||||
Nein, das geht nur in Lands selbst (`player-limits.yml`). Dieses Plugin ändert keine Limits.
|
||||
|
||||
---
|
||||
|
||||
## 8. Datensicherung
|
||||
|
||||
Alles, was sich das Plugin merkt (Sperren, Warteschlange, Watchlist, Temp-Chunks, letzter Upkeep), steht in:
|
||||
|
||||
`plugins/LandsChunkInfo/data.yml`
|
||||
|
||||
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.
|
||||
|
||||
---
|
||||
|
||||
## 9. Wenn etwas nicht klappt
|
||||
|
||||
| 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 |
|
||||
| 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 |
|
||||
| `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 |
|
||||
| Ä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 |
|
||||
| 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) |
|
||||
|
||||
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
|
||||
|
||||
- Das Plugin wurde noch nicht auf einem echten Server getestet. Probiere es erst auf einem Testserver aus.
|
||||
- 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.
|
||||
- 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.
|
||||
|
||||
---
|
||||
|
||||
## 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.
|
||||
# LandsChunkInfo – Anleitung (Version 1.0.4)
|
||||
|
||||
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.
|
||||
- **Wartezeit nach `/unclaim`:** Der Slot bleibt für eine einstellbare Zeit gesperrt. Die Spieler sehen, **wann wieder ein Chunk frei wird**.
|
||||
- **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.
|
||||
|
||||
---
|
||||
|
||||
## 1. Was brauche ich?
|
||||
|
||||
| Was | Pflicht? | Wofür |
|
||||
|---|---|---|
|
||||
| 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 |
|
||||
| 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`) |
|
||||
| **PlaceholderAPI** | Nein | Nur für Platzhalter in Scoreboard, Tab-Liste usw. |
|
||||
|
||||
Folia wird **nicht** unterstützt.
|
||||
|
||||
---
|
||||
|
||||
## 2. Installation und Update
|
||||
|
||||
1. Stoppe den Server.
|
||||
2. Kopiere `LandsChunkInfo-1.0.4.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.
|
||||
3. Starte den Server.
|
||||
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).
|
||||
|
||||
**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. Der Befehl
|
||||
|
||||
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
|
||||
|
||||
| Befehl | Was passiert |
|
||||
|---|---|
|
||||
| `/chunks` | Zeigt alle deine Lands: Chunks belegt, frei, gesperrt, wann der nächste Chunk frei wird, Upkeep |
|
||||
| `/chunks MeinLand` | Zeigt nur dieses eine Land |
|
||||
| `/chunks top` | Zeigt die Lands mit den meisten Chunks |
|
||||
|
||||
**Beispiel einer Anzeige:**
|
||||
|
||||
```
|
||||
Deine Chunks
|
||||
Von dir geclaimt: 12 / 20
|
||||
MeinLand
|
||||
Chunks: 12 / 20 | Frei: 6 | Gesperrt: 2
|
||||
Nächster Chunk wieder frei in: 3Std 12Min (23.10. 14:30)
|
||||
Danach: 20Std 5Min
|
||||
Sofort freischalten: /chunks skip (Preis: 80,00)
|
||||
Upkeep: 36,00 pro Zyklus, nächster Einzug in 2T 4Std
|
||||
```
|
||||
|
||||
Was bedeuten die Wörter?
|
||||
|
||||
- **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.
|
||||
- **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
|
||||
|
||||
| Befehl | Was passiert |
|
||||
|---|---|
|
||||
| `/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 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 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.
|
||||
|
||||
### 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.
|
||||
|
||||
| Befehl | Was passiert |
|
||||
|---|---|
|
||||
| `/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 list` | Zeigt deine vorgemerkten Chunks |
|
||||
| `/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.
|
||||
|
||||
### Fremden Chunk beobachten (Watchlist)
|
||||
|
||||
Ein Chunk gehört jemand anderem, und du willst ihn haben, falls er frei wird? Stell dich drauf:
|
||||
|
||||
| Befehl | Was passiert |
|
||||
|---|---|
|
||||
| `/chunks watch` | Du bekommst eine Nachricht, sobald dieser Chunk frei wird |
|
||||
| `/chunks watch list` | Zeigt, was du beobachtest |
|
||||
| `/chunks watch clear` | Hört mit allem auf |
|
||||
|
||||
Tipp: Wenn die Nachricht kommt, nutze danach `/chunks queue`, um ihn dir zu sichern.
|
||||
|
||||
### 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 musst der Besitzer sein):
|
||||
|
||||
| Befehl | Was passiert |
|
||||
|---|---|
|
||||
| `/chunks temp 7` | Der Chunk wird nach 7 Tagen automatisch freigegeben |
|
||||
| `/chunks temp list` | Zeigt die Temp-Chunks deiner Lands |
|
||||
| `/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.
|
||||
|
||||
### 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.
|
||||
|
||||
---
|
||||
|
||||
## 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).
|
||||
|
||||
| Platzhalter | Zeigt |
|
||||
|---|---|
|
||||
| `%chunkinfo_land%` | Name des Lands (`-` ohne Land) |
|
||||
| `%chunkinfo_used%` | Belegte Chunks |
|
||||
| `%chunkinfo_max%` | Maximale Chunks (oder `unbegrenzt`) |
|
||||
| `%chunkinfo_free%` | Freie Chunks (oder `unbegrenzt`) |
|
||||
| `%chunkinfo_locked%` | Gesperrte Slots |
|
||||
| `%chunkinfo_next_free%` | Zeit, bis der nächste Slot frei wird (`-` wenn keiner gesperrt ist) |
|
||||
| `%chunkinfo_upkeep%` | Upkeep-Kosten pro Zyklus |
|
||||
| `%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_chunks%` | Chunks des Lands auf Platz 1 |
|
||||
|
||||
---
|
||||
|
||||
## 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`).
|
||||
|
||||
**Wichtig:** Lass die Einrückungen (die Leerzeichen am Zeilenanfang) unverändert. Ändere nur die Werte hinter dem Doppelpunkt.
|
||||
|
||||
### Wartezeit nach dem Unclaimen
|
||||
|
||||
```yaml
|
||||
unclaim-cooldown:
|
||||
enabled: true
|
||||
duration: 24h
|
||||
enforce: true
|
||||
```
|
||||
|
||||
- `enabled` – `true` = Funktion an, `false` = aus.
|
||||
- `duration` – Wie lange ein Slot nach `/unclaim` gesperrt bleibt. Schreibweise:
|
||||
- `30m` = 30 Minuten
|
||||
- `12h` = 12 Stunden
|
||||
- `2d` = 2 Tage
|
||||
- `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.
|
||||
|
||||
### Upkeep-Zeitpunkt
|
||||
|
||||
```yaml
|
||||
upkeep:
|
||||
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"`.
|
||||
|
||||
### Slot freikaufen
|
||||
|
||||
```yaml
|
||||
skip:
|
||||
enabled: true
|
||||
payment: PLAYER
|
||||
price-per-hour: 25.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.
|
||||
- `price-per-hour` – Preis pro verbleibender Stunde Wartezeit.
|
||||
- `min-price` – Mindestpreis, auch wenn nur noch wenige Minuten fehlen.
|
||||
|
||||
Beispiel: Noch 10 Stunden Wartezeit, 25 pro Stunde ergibt 250.
|
||||
|
||||
### Warteschlange, Watchlist, Temp-Claims, Top-Liste
|
||||
|
||||
```yaml
|
||||
queue:
|
||||
max: 3
|
||||
watch:
|
||||
max: 5
|
||||
temp-claims:
|
||||
enabled: true
|
||||
max-days: 30
|
||||
max-per-land: 3
|
||||
top:
|
||||
size: 10
|
||||
```
|
||||
|
||||
- `max` – Wie viele Einträge ein Spieler gleichzeitig haben darf.
|
||||
- `max-days` – Längste erlaubte Dauer für einen Temp-Chunk.
|
||||
- `max-per-land` – Wie viele Temp-Chunks ein Land gleichzeitig haben darf.
|
||||
- `top.size` – Wie viele Lands in `/chunks top` stehen.
|
||||
|
||||
### Hinweis beim Einloggen
|
||||
|
||||
```yaml
|
||||
join-reminder:
|
||||
enabled: true
|
||||
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.
|
||||
|
||||
### Texte ändern
|
||||
|
||||
Unter `messages:` stehen die Meldungen. Farben schreibst du mit `&`:
|
||||
|
||||
- `&a` = grün, `&c` = rot, `&e` = gelb, `&7` = grau
|
||||
|
||||
`%time%` wird im Spiel durch die Restzeit ersetzt. Lass es stehen.
|
||||
|
||||
---
|
||||
|
||||
## 8. Rechte (Permissions)
|
||||
|
||||
Rechte vergibst du mit einem Rechte-Plugin, z. B. LuckPerms.
|
||||
|
||||
| Recht | Wer bekommt es standardmäßig? | Was erlaubt es? |
|
||||
|---|---|---|
|
||||
| `landschunkinfo.use` | Alle | `/chunks`, `top` und den Hinweis beim Einloggen |
|
||||
| `landschunkinfo.skip` | Alle | Eigenen Slot freikaufen |
|
||||
| `landschunkinfo.gift` | Alle | Slot in fremdem Land freikaufen |
|
||||
| `landschunkinfo.queue` | Alle | Warteschlange benutzen |
|
||||
| `landschunkinfo.watch` | Alle | Watchlist benutzen |
|
||||
| `landschunkinfo.temp` | Alle | Temp-Claims benutzen |
|
||||
| `landschunkinfo.bypass` | Nur OPs | Wartezeit nach dem Unclaimen gilt **nicht** |
|
||||
| `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.
|
||||
|
||||
---
|
||||
|
||||
## 9. Häufige Fragen
|
||||
|
||||
**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.
|
||||
|
||||
**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.
|
||||
|
||||
**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.**
|
||||
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?**
|
||||
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?**
|
||||
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`.
|
||||
|
||||
**Kann ich einem Spieler mehr Chunk-Slots geben?**
|
||||
Nein, das geht nur in Lands selbst (`player-limits.yml`). Dieses Plugin ändert keine Limits.
|
||||
|
||||
---
|
||||
|
||||
## 10. Datensicherung
|
||||
|
||||
Alles, was sich das Plugin merkt, steht in diesen Dateien in `plugins/LandsChunkInfo/`:
|
||||
|
||||
| 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 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
|
||||
|
||||
| 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 |
|
||||
| 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` |
|
||||
| `/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) |
|
||||
| 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 |
|
||||
| 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.
|
||||
|
||||
---
|
||||
|
||||
## 12. Bekannte Grenzen
|
||||
|
||||
- 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 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.
|
||||
- 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.
|
||||
|
||||
@@ -4,7 +4,7 @@
|
||||
<modelVersion>4.0.0</modelVersion>
|
||||
<groupId>de.landschunkinfo</groupId>
|
||||
<artifactId>LandsChunkInfo</artifactId>
|
||||
<version>1.0.2</version>
|
||||
<version>1.0.4</version>
|
||||
<packaging>jar</packaging>
|
||||
|
||||
<properties>
|
||||
|
||||
@@ -80,7 +80,7 @@ final class InfoCommand implements CommandExecutor, TabCompleter {
|
||||
}
|
||||
case "create" -> {
|
||||
if (args.length < 3) {
|
||||
plugin.send(p, "&cNutzung: /chunkinfo pvp create <Name>");
|
||||
plugin.send(p, "&cNutzung: /chunks pvp create <Name>");
|
||||
return;
|
||||
}
|
||||
String err = plugin.pvp.create(p, args[2]);
|
||||
@@ -88,7 +88,7 @@ final class InfoCommand implements CommandExecutor, TabCompleter {
|
||||
}
|
||||
case "delete" -> {
|
||||
if (args.length < 3) {
|
||||
plugin.send(p, "&cNutzung: /chunkinfo pvp delete <Name>");
|
||||
plugin.send(p, "&cNutzung: /chunks pvp delete <Name>");
|
||||
return;
|
||||
}
|
||||
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()
|
||||
+ ": " + 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) {
|
||||
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) {
|
||||
@@ -187,7 +187,7 @@ final class InfoCommand implements CommandExecutor, TabCompleter {
|
||||
p.sendMessage(plugin.line(sb + (locked.size() > 5 ? " ..." : "")));
|
||||
}
|
||||
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)"));
|
||||
}
|
||||
}
|
||||
@@ -253,7 +253,7 @@ final class InfoCommand implements CommandExecutor, TabCompleter {
|
||||
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) {
|
||||
if (!allowed(p, gift ? "gift" : "skip")) {
|
||||
return;
|
||||
@@ -270,7 +270,7 @@ final class InfoCommand implements CommandExecutor, TabCompleter {
|
||||
if (name != null) {
|
||||
land = findLand(name);
|
||||
} else if (gift) {
|
||||
plugin.send(p, "&cNutzung: /chunkinfo gift <Land> [confirm]");
|
||||
plugin.send(p, "&cNutzung: /chunks gift <Land> [confirm]");
|
||||
return;
|
||||
} else {
|
||||
land = plugin.landsOf(p.getUniqueId()).stream()
|
||||
@@ -304,7 +304,7 @@ final class InfoCommand implements CommandExecutor, TabCompleter {
|
||||
if (!confirm) {
|
||||
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. Bestaetigen: &e/chunkinfo " + (gift ? "gift " : "skip ") + land.getName() + " confirm");
|
||||
+ "&7. Bestaetigen: &e/chunks " + (gift ? "gift " : "skip ") + land.getName() + " confirm");
|
||||
return;
|
||||
}
|
||||
|
||||
@@ -361,12 +361,12 @@ final class InfoCommand implements CommandExecutor, TabCompleter {
|
||||
int cx = p.getLocation().getBlockX() >> 4;
|
||||
int cz = p.getLocation().getBlockZ() >> 4;
|
||||
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;
|
||||
}
|
||||
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)) {
|
||||
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;
|
||||
}
|
||||
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;
|
||||
Land holder = plugin.lands.getLandByUnloadedChunk(w, cx, cz);
|
||||
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;
|
||||
}
|
||||
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)) {
|
||||
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;
|
||||
}
|
||||
if (mine.stream().anyMatch(e -> e.at(w.getName(), cx, cz))) {
|
||||
@@ -469,7 +469,7 @@ final class InfoCommand implements CommandExecutor, TabCompleter {
|
||||
try {
|
||||
days = Integer.parseInt(arg);
|
||||
} catch (NumberFormatException ex) {
|
||||
plugin.send(p, "&cNutzung: /chunkinfo temp <Tage> | cancel | list");
|
||||
plugin.send(p, "&cNutzung: /chunks temp <Tage> | cancel | list");
|
||||
return;
|
||||
}
|
||||
int maxDays = plugin.getConfig().getInt("temp-claims.max-days", 30);
|
||||
|
||||
@@ -67,17 +67,17 @@ public final class LandsChunkInfo extends JavaPlugin implements Listener {
|
||||
vault = VaultHook.create();
|
||||
}
|
||||
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) {
|
||||
new ChunkExpansion(this).register();
|
||||
}
|
||||
|
||||
pvp = new PvpRegions(getDataFolder(), getLogger());
|
||||
pvp = new PvpRegions(this, getDataFolder(), getLogger());
|
||||
Bukkit.getPluginManager().registerEvents(pvp, this);
|
||||
Bukkit.getPluginManager().registerEvents(this, this);
|
||||
InfoCommand command = new InfoCommand(this);
|
||||
var cmd = getCommand("chunkinfo");
|
||||
var cmd = getCommand("chunks");
|
||||
if (cmd != null) {
|
||||
cmd.setExecutor(command);
|
||||
cmd.setTabCompleter(command);
|
||||
@@ -87,6 +87,9 @@ public final class LandsChunkInfo extends JavaPlugin implements Listener {
|
||||
|
||||
@Override
|
||||
public void onDisable() {
|
||||
if (pvp != null) {
|
||||
pvp.shutdown();
|
||||
}
|
||||
if (store != null) {
|
||||
store.save();
|
||||
}
|
||||
@@ -374,7 +377,7 @@ public final class LandsChunkInfo extends JavaPlugin implements Listener {
|
||||
if (lands.getLandByUnloadedChunk(w, e.x(), e.z()) == null) {
|
||||
store.remove(Kind.WATCH, e);
|
||||
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.");
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
@@ -10,6 +10,15 @@ import org.bukkit.event.EventHandler;
|
||||
import org.bukkit.event.EventPriority;
|
||||
import org.bukkit.event.Listener;
|
||||
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.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 Logger log;
|
||||
private final Map<String, Region> regions = new LinkedHashMap<>();
|
||||
private final Map<UUID, Location> pos1 = 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.log = log;
|
||||
load();
|
||||
@@ -100,7 +116,7 @@ final class PvpRegions implements Listener {
|
||||
Location a = pos1.get(p.getUniqueId());
|
||||
Location b = pos2.get(p.getUniqueId());
|
||||
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())) {
|
||||
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.max(a.getBlockX(), b.getBlockX()), Math.max(a.getBlockZ(), b.getBlockZ())));
|
||||
save();
|
||||
refreshAll();
|
||||
return null;
|
||||
}
|
||||
|
||||
@@ -116,6 +133,7 @@ final class PvpRegions implements Listener {
|
||||
boolean removed = regions.remove(name.toLowerCase()) != null;
|
||||
if (removed) {
|
||||
save();
|
||||
refreshAll();
|
||||
}
|
||||
return removed;
|
||||
}
|
||||
@@ -137,6 +155,77 @@ final class PvpRegions implements Listener {
|
||||
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
|
||||
|
||||
/**
|
||||
@@ -145,7 +234,7 @@ final class PvpRegions implements Listener {
|
||||
*/
|
||||
@EventHandler(priority = EventPriority.HIGHEST)
|
||||
public void onDamage(EntityDamageByEntityEvent e) {
|
||||
if (!e.isCancelled() || regions.isEmpty() || !(e.getEntity() instanceof Player victim)) {
|
||||
if (regions.isEmpty() || !(e.getEntity() instanceof Player victim)) {
|
||||
return;
|
||||
}
|
||||
Entity damager = e.getDamager();
|
||||
@@ -156,7 +245,30 @@ final class PvpRegions implements Listener {
|
||||
return;
|
||||
}
|
||||
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);
|
||||
}
|
||||
}
|
||||
|
||||
@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());
|
||||
}
|
||||
}
|
||||
|
||||
@@ -22,7 +22,7 @@ messages:
|
||||
reloaded: "&aKonfiguration neu geladen."
|
||||
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:
|
||||
enabled: true
|
||||
# PLAYER = Geld des Spielers (Vault), LAND = Landkasse (nur Besitzer). gift nutzt immer PLAYER.
|
||||
@@ -31,16 +31,16 @@ skip:
|
||||
price-per-hour: 25.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.
|
||||
queue:
|
||||
max: 3
|
||||
|
||||
# Watchlist (/chunkinfo watch): Nachricht, sobald ein fremder Chunk frei wird.
|
||||
# Watchlist (/chunks watch): Nachricht, sobald ein fremder Chunk frei wird.
|
||||
watch:
|
||||
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.
|
||||
temp-claims:
|
||||
enabled: true
|
||||
|
||||
@@ -1,38 +1,38 @@
|
||||
name: LandsChunkInfo
|
||||
main: de.landschunkinfo.LandsChunkInfo
|
||||
version: ${project.version}
|
||||
api-version: '1.21'
|
||||
depend: [Lands]
|
||||
softdepend: [Vault, PlaceholderAPI]
|
||||
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.
|
||||
commands:
|
||||
chunkinfo:
|
||||
description: Chunk-Belegung, freie Slots, Upkeep, Queue, Watchlist und mehr
|
||||
usage: /<command> [land|top|skip|gift|queue|watch|temp]
|
||||
aliases: [chunks, chunkslots]
|
||||
permissions:
|
||||
landschunkinfo.use:
|
||||
description: /chunkinfo benutzen
|
||||
default: true
|
||||
landschunkinfo.skip:
|
||||
description: Gesperrten Slot freikaufen
|
||||
default: true
|
||||
landschunkinfo.gift:
|
||||
description: Slot in fremdem Land freikaufen
|
||||
default: true
|
||||
landschunkinfo.queue:
|
||||
description: Auto-Claim-Warteschlange
|
||||
default: true
|
||||
landschunkinfo.watch:
|
||||
description: Chunk-Watchlist
|
||||
default: true
|
||||
landschunkinfo.temp:
|
||||
description: Zeitlich begrenzte Claims
|
||||
default: true
|
||||
landschunkinfo.bypass:
|
||||
description: Unclaim-Cooldown ignorieren
|
||||
default: op
|
||||
landschunkinfo.admin:
|
||||
description: /chunkinfo reload
|
||||
default: op
|
||||
name: LandsChunkInfo
|
||||
main: de.landschunkinfo.LandsChunkInfo
|
||||
version: ${project.version}
|
||||
api-version: '1.21'
|
||||
depend: [Lands]
|
||||
softdepend: [Vault, PlaceholderAPI]
|
||||
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.
|
||||
commands:
|
||||
chunks:
|
||||
description: Chunk-Belegung, freie Slots, Upkeep, Queue, Watchlist und mehr
|
||||
usage: /<command> [land|top|skip|gift|queue|watch|temp]
|
||||
aliases: [chunkslots]
|
||||
permissions:
|
||||
landschunkinfo.use:
|
||||
description: /chunks benutzen
|
||||
default: true
|
||||
landschunkinfo.skip:
|
||||
description: Gesperrten Slot freikaufen
|
||||
default: true
|
||||
landschunkinfo.gift:
|
||||
description: Slot in fremdem Land freikaufen
|
||||
default: true
|
||||
landschunkinfo.queue:
|
||||
description: Auto-Claim-Warteschlange
|
||||
default: true
|
||||
landschunkinfo.watch:
|
||||
description: Chunk-Watchlist
|
||||
default: true
|
||||
landschunkinfo.temp:
|
||||
description: Zeitlich begrenzte Claims
|
||||
default: true
|
||||
landschunkinfo.bypass:
|
||||
description: Unclaim-Cooldown ignorieren
|
||||
default: op
|
||||
landschunkinfo.admin:
|
||||
description: /chunks reload
|
||||
default: op
|
||||
|
||||
Reference in New Issue
Block a user