PostSystem – Mod Dokumentation

Version: 1.0.0
Minecraft: 1.21.1
Mod-Loader: NeoForge
Abhängigkeiten: RegionGuard, Lightman's Currency

Was ist PostSystem?

PostSystem ist ein Server-Mod für Minecraft 1.21.1 (NeoForge), der ein vollständiges schildbasiertes Postsystem für Multiplayer-Server bereitstellt. Spieler können Pakete zwischen RegionGuard-Schutzgebieten versenden, Postboten transportieren die Pakete und erhalten ihren Lohn automatisch über Lightman's Currency Bankkonten.

⚠️ Hinweis: PostSystem wurde speziell für den Minecraft-Server Day & Night Life entwickelt. Einige Features sind auf diesen Server zugeschnitten. Bei Verwendung auf anderen Servern können Anpassungen notwendig sein.

Features

📦 Pakete versenden (`[PostLaden]`)

Lege Items in eine verknüpfte Kiste und klicke das Schild
Ein Chat-Dialog führt durch die Einrichtung:
1. Zielregion eingeben (RegionGuard-Regionsname)
2. Notiz optional hinzufügen
3. Express-Versand wählen (doppelter Preis, bevorzugte Zustellung)
4. Versicherung optional (+ 50% Aufpreis – Items werden bei Ablauf zurückgegeben)
5. Bestätigung – Geld wird vom Bankkonto abgebucht
Pakete werden automatisch in je 9 Stacks aufgeteilt

📬 Briefkasten (`[Briefkasten]`)

Jede Region kann einen eigenen Briefkasten haben
Postboten liefern Pakete direkt am Briefkasten ab
Regionsmitglieder holen Pakete per Rechtsklick ab (direkt ins Inventar)
Benachrichtigung beim Eingang neuer Pakete (online & offline)

🚚 Postboten-System (`[PostJob]`)

Spieler können per Rechtsklick Postbote werden
Fahrzeugschlüssel-System: Beim Annehmen des Jobs wird automatisch ein Key-Post-XX-Schlüssel aus der verknüpften Kiste entnommen und dem Spieler gegeben
Beim Kündigen muss der Schlüssel zurückgegeben werden – sonst wird die Kündigung blockiert
Lohn pro zugestelltem Paket (konfigurierbar)
Pakete werden bei Kündigung automatisch zurückgegeben

🏭 Verteildepot (`[Verteildepot]`)

Postboten liefern abgeholte Pakete im Depot ab
Pakete werden nach Zuständigkeit und Express-Status sortiert
Postboten nehmen Pakete aus dem Depot zur Zustellung mit

📋 PostAbholung (`[PostAbholung]`)

Postboten holen aufgegebene Pakete ab
Erster Klick: Liste aller verfügbaren Pakete
Zweiter Klick: Alle Pakete direkt abholen

ℹ️ Job-Info-Schild (`[PostInfo]`)

Zeigt alle wichtigen Job-Infos beim Rechtsklick:
- Lohn pro Paket, Max. Pakete, Paketpreis, Express-Aufpreis, Versicherung
- Aktive Postboten, wartende Pakete, verfügbare Schlüssel
Schild-Block zeigt Echtzeit-Daten (Lohn, Postbotenanzahl, Schlüsselanzahl)

Schildtypen

Schild	Typ-Nr.	Beschreibung
`[PostLaden]`	1	Pakete aufgeben (mit Kiste)
`[PostAbholung]`	2	Pakete für Postboten abholen
`[Verteildepot]`	3	Pakete im Depot abliefern/aufnehmen
`[PostJob]`	4	Job annehmen/kündigen (mit Kiste für Schlüssel)
`[Briefkasten]`	5	Pakete empfangen (pro Region)
`[PostInfo]`	6	Job-Infos anzeigen (mit Kiste für Schlüssel)

Befehle

Für alle Spieler

Befehl	Beschreibung
`/post status`	Eigene Pakete und Status anzeigen
`/post info <paket-id>`	Details zu einem Paket

Für Postboten

Befehl	Beschreibung
`/post pakete`	Eigene aktiven Pakete anzeigen
`/post schicht`	Schicht-Statistiken anzeigen

Für OPs (Berechtigung Level 2)

Befehl	Beschreibung
`/post admin schild <typ>`	Neues Post-Schild erstellen
`/post admin kiste`	Kiste mit letztem Schild verknüpfen
`/post admin depot <name> <region>`	Depot-Zuständigkeit setzen
`/post admin config <key> <value>`	Konfiguration ändern
`/post admin stats`	Server-Statistiken anzeigen
`/post admin pakete`	Alle Pakete auflisten
`/post admin reset <paket-id>`	Paket zurücksetzen

Konfiguration

Parameter	Standard	Beschreibung
`paketPreis`	10	Preis pro Paket in Münzen
`postbotenLohn`	5	Lohn pro zugestelltem Paket
`postbotenLimit`	20	Max. Pakete pro Postbote (0 = unbegrenzt)
`expressAufpreis`	2	Express-Multiplikator
`versicherungAufpreis`	50	Versicherungs-Aufpreis in %
`paketAblaufTage`	0	Paket-Ablauf in Tagen (0 = kein Ablauf)
`briefkastenMaxWarn`	10	Warnung ab X Paketen im Briefkasten
`alarmStunden`	24	Stunden bis Paket als steckengeblieben gilt

Fahrzeugschlüssel-System

Das Schlüsselsystem verhindert, dass mehrere Postboten gleichzeitig dasselbe Fahrzeug nutzen:

Admin legt Items mit dem Display-Namen Key-Post-01, Key-Post-02 etc. in die Kiste des [PostJob]-Schilds
Beim Job-Annehmen: System entnimmt automatisch einen Schlüssel und gibt ihn dem Spieler
Keine Schlüssel verfügbar → Job wird verweigert
Beim Kündigen: Spieler muss den Schlüssel im Inventar haben → wird zurückgelegt
Das [PostInfo]-Schild zeigt die Anzahl verfügbarer Schlüssel in Echtzeit

Abhängigkeiten

RegionGuard – für Gebietsschutz und Mitgliederverwaltung
Lightman's Currency – für das Bankkonten-System (Zahlungen & Lohn)

Lizenz

Dieser Mod ist frei zur Nutzung für jeden.

Post System