Upload via GUI (53 Dateien)

README.md

@@ -607,6 +607,7 @@ Ab Version 1.0.3 bringt das Plugin zusätzlich viele Weihnachts-Funktionen mit.
 
 - `/xmas snow` schaltet den Schnee **für dich selbst** an oder aus.
 - Einstellungen unter `snow:`: Stärke (`level` 1 bis 5), Welten sperren (`disable-in-worlds`), Standard an/aus (`default-on`).
+- **Schnee-Blacklist für Welten (Admin):** `/xmas snow world add <Welt>` sperrt den Schnee in einer Welt, `/xmas snow world remove <Welt>` hebt die Sperre auf, `/xmas snow world list` zeigt die gesperrten Welten. Die Liste steht in `snow.disable-in-worlds` und wird dauerhaft gespeichert, die Wirkung ist sofort.
 - Mit `enable-only-in-regions: true` und einer Liste unter `regions:` gibt es Schnee nur in bestimmten **WorldGuard**-Regionen. Dafür muss WorldGuard installiert sein.
 - Bei vielen Spielern kannst du `display-task-interval` erhöhen (z. B. 10), dann gibt es weniger Last.
 
@@ -625,6 +626,7 @@ Zeit geht als `300`, `30s`, `5m` oder `1h`. Ohne Angabe gilt `santa.duration`.
 - **Melodie:** Wenn Santa kommt, spielt eine Weihnachtsmelodie mit Glocken (Notenblock-Klänge, keine Dateien nötig). Einstellbar unter `santa.melody` (`enable`, `volume`, `tempo`, `everyone`).
 - **Geschenke:** `drop-interval` (Sekunden), `drop-chance` (in %), `radius` und die Liste `gifts`. Cracker gibst du als `cracker:cracker:1` an.
 - **Spazieren:** Mit `walk-radius` läuft Santa herum und hinterlässt eine Schneespur (`snow-trail`), die wieder verschwindet.
+  Er läuft flüssig mit sanften Drehungen, `walk-speed` stellt das Tempo ein. Beim Laufen schwingen Beine und Arme, beim Stehenbleiben winkt er (`walk-animation`, `wave`).
 - **Aussehen:** Ab **Minecraft 1.21.9** ist Santa ein Spielermodell, davor ein Rüstungsständer. Einen eigenen Skin trägst du bei `skin-url` (Textur-Adresse von `textures.minecraft.net`) oder `skin-player` (Spielername) ein. Mit `model: ARMOR_STAND` erzwingst du den Rüstungsständer.
 - **Zufällige Orte:** Unter `locations:` trägst du Welt und Koordinaten ein (siehe Beispiel in der Datei).
 
@@ -657,6 +659,8 @@ So funktioniert der Baum:
 3. **Füttern:** Wirf die Items, die der Baum braucht, **neben den Baum**. Er nimmt sie auf (nur vom Besitzer). Mit Rechtsklick auf den Baum siehst du, was noch fehlt.
 4. **Wachsen:** Sind alle Items da, kommt eine Meldung und ein Ring leuchtet am Boden. Rechtsklick auf den Baum, dann wächst er eine Stufe.
 5. **Stufen:** Setzling, kleiner Baum, Baum, Magic Tree. Items und Wartezeiten stehen unter `magic-tree.levels`.
+6. **Geschenke ab Stufe:** `magic-tree.presents-from-level` legt fest, ab welcher Stufe Geschenke entstehen (`SAPLING`, `SMALL_TREE`, `TREE` oder `MAGIC_TREE`, Standard `SMALL_TREE`). Darunter gibt es keine Geschenke. Ab dieser Stufe gilt der `gift-cooldown` der Stufe, bei `-1` der Wert `default-gift-cooldown` (Standard 300 Sekunden).
+7. **Deko-Köpfe am Baum:** Statt Beton-, Gold- und Seelaternen-Blöcken hängen Köpfe im Baum (`magic-tree.ornaments.mode: heads`, zufällig gedreht). Die Texturen stehen unter `ornaments.heads`: entweder eine URL von textures.minecraft.net oder der „Value“ von minecraft-heads.com. Mit `mode: blocks` gibt es wieder die alten Blöcke. Wie viel Schmuck hängt, stellst du mit `ornaments.per-ring` (Stück pro Ring, Standard 3) und `ornaments.every-nth-layer` (nur jede n-te Ebene, Standard 2) ein. Schon gebaute Bäume behalten ihren Schmuck, bis sie die nächste Stufe erreichen.
 6. **Geschenke:** Ab dem kleinen Baum erscheinen Geschenk-Köpfe rund um den Baum. Rechtsklick oder Abbauen öffnet sie.
 
 Standard-Kosten:
@@ -786,9 +790,12 @@ quiz:
 | `/xmas market set` | **Marktplatz** an deiner Stelle festlegen (Ziel der Portale) |
 | `/xmas market unset` | Marktplatz aufheben, Portale führen dann nirgendwohin |
 | `/xmas market tp` | Zum Marktplatz teleportieren |
-| `/xmas market spawn <id>` | Marktstand aufstellen (mitgeliefert: `plaetzchen`, `deko`) |
+| `/xmas market spawn <id>` | Marktstand aufstellen (mitgeliefert: `plaetzchen`, `deko`, `gluehwein`) |
 | `/xmas market remove` | Nächsten Stand entfernen |
 | `/xmas market list` | Stand-IDs anzeigen |
+| `/xmas market santa set` | **Santa** an deiner Stelle auf den Markt stellen (zum Beispiel vor einen Thron oder Sessel) |
+| `/xmas market santa remove` | Markt-Santa wieder entfernen |
+| `/xmas market santa reset` | Tagesgeschenke für alle zurücksetzen (zum Testen) |
 
 Ein Stand ist ein Händler (Villager), bei dem Spieler Items tauschen. Die Angebote stehen unter `market.stalls.<id>.trades`. Nach einer Änderung lädst du mit `/xmas reload` neu.
 
@@ -802,6 +809,15 @@ market:
         - { give: "cookie:zimtstern:2", price: ["EMERALD:1"] }
 ```
 
+**Leben auf dem Markt:** Alles bezieht sich auf den Marktplatz (`market.radius`, Standard 45 Blöcke).
+
+- **Begrüßung:** Wer den Markt betritt, bekommt einen Titel („Weihnachtsmarkt“) mit Glockenklang (`market.welcome.enable`).
+- **Musik:** Im Markt spielen leise Weihnachtsmelodien mit Glocken, dazwischen sind Pausen (`market.music`: `enable`, `volume`, `tempo`, `pause-seconds`).
+- **Schnee nur im Markt:** Mit `market.snow-only-in-market: true` fällt der Schnee nur im Markt. Das gilt erst, wenn ein Marktplatz gesetzt ist.
+- **Santa auf dem Markt:** `/xmas market santa set` stellt Santa an deine Stelle. Er dreht sich zu Spielern in der Nähe und winkt. Jeder Spieler bekommt per Rechtsklick **einmal pro Tag** ein Geschenk (`market.santa.rewards`). Die Tagesgrenze wird in `market-life.yml` gespeichert. Santa erscheint nur, solange Spieler in der Nähe sind, und kommt nach einem Neustart von selbst wieder.
+- **Wichtel:** Kleine Wichtel-Figuren laufen zwischen den Ständen herum (`market.elves`: `count`, `radius`, `speed`, `names`, eigener Skin möglich). Sie sind nur da, solange Spieler im Markt sind.
+- **Glühwein-Stand:** `/xmas market spawn gluehwein` stellt einen Stand mit Glühwein, Kinderpunsch und heißer Schokolade auf. Beim Trinken gibt es Effekte (Regeneration, Feuerresistenz, Tempo, Absorption) und Dampf-Partikel. Die Getränke stehen unter `cookies` und lassen sich wie Plätzchen verschenken (`cookie:gluehwein:2`).
+
 **Portale (Spieler):** Sie funktionieren **nur, wenn ein Admin den Marktplatz festgelegt hat**.
 
 - `/xmas portal create`: Schau auf den Boden und gib den Befehl ein. Das Plugin baut einen Torbogen aus **Schneeblöcken** (10 Stück, werden verbraucht, Admins zahlen nichts). Er braucht 5 Blöcke Breite und Höhe sowie festen Boden.