Übersicht
Saro's Char System verwandelt deinen Minecraft-Server in ein tiefgehendes Rollenspiel-Erlebnis. Es ermöglicht Spielern, mehrere "Charaktere" auf einem einzigen Account zu erstellen und zwischen ihnen zu wechseln. Jeder Charakter hat sein eigenes getrenntes Inventar, Gesundheit, Hunger, Position und Trankeffekte.
Hauptfunktionen
👤 Charakter-Management
- Charaktere erstellen: Definiere Vorname, Nachname, Geburtsdatum und Geschlecht für jede Persona.
- Nahtloses Wechseln: Tausche Charaktere sofort mit Tab-Complete-Unterstützung.
- Charakter bearbeiten: Ändere nachträglich Eigenschaften deiner Charaktere.
- Charakter-Info: Zeige detaillierte Informationen über Charaktere anderer Spieler.
💾 Gespeicherte Daten pro Charakter
Beim Wechseln werden folgende Daten für jeden Charakter separat gespeichert und geladen:
| Daten | Beschreibung |
|---|---|
| Position | X/Y/Z Koordinaten - du wirst beim Wechseln teleportiert |
| Gesundheit | Aktuelle Lebenspunkte |
| Hunger | Hungerbalken |
| Erfahrung | XP Level |
| Inventar | Hauptinventar + Rüstung + Nebenhand (inkl. NBT-Daten) |
| Effekte | Aktive Trank-/Statuseffekte mit Dauer und Stärke |
| Geld | Kontostand (bei Money Mod Integration) |
💰 Money Mod Kompatibilität
- Automatische Erkennung: Prüft automatisch, ob ein Money Mod installiert ist.
- Getrennte Kontostände: Jeder Charakter hat sein eigenes Geldkonto.
- Startgeld: Neue Charaktere erhalten automatisch das konfigurierte Startgeld (Standard: 500).
🛠️ Admin-Funktionen
- Charakter für andere wechseln: Admins (OP Level 2+) können
/char <ID> <spielername>verwenden. - Charakter-Liste einsehen: Zeigt alle Charaktere eines Spielers mit
/charinfo <spieler> list.
Befehle
| Befehl | Nutzung | Beschreibung |
|---|---|---|
| /createchar | /createchar <vorname> <nachname> <datum> <geschlecht> |
Erstellt einen neuen Charakter-Slot. |
| /char | /char <ID> |
Wechselt zur angegebenen Charakter-ID. |
| /char | /char <ID> <spieler> |
(Admin) Wechselt den Charakter eines anderen Spielers. |
| /editchar | /editchar <ID> |
Zeigt alle Eigenschaften eines Charakters an. |
| /editchar | /editchar <ID> firstname <wert> |
Ändert den Vornamen. |
| /editchar | /editchar <ID> lastname <wert> |
Ändert den Nachnamen. |
| /editchar | /editchar <ID> birthdate <wert> |
Ändert das Geburtsdatum. |
| /editchar | /editchar <ID> gender <wert> |
Ändert das Geschlecht. |
| /charinfo | /charinfo <spieler> |
Zeigt den aktuellen Charakter eines Spielers. |
| /charinfo | /charinfo <spieler> list |
Listet alle Charaktere eines Spielers auf. |
| /charinfo | /charinfo <spieler> <ID> |
Zeigt Details zu einem bestimmten Charakter. |
Konfiguration
Alle Einstellungen in config/saroscharsystem-common.toml:
| Option | Standard | Beschreibung |
|---|---|---|
maxChars |
2 |
Maximale Anzahl Charaktere pro Spieler (1 - ∞) |
requireOpForCommands |
false |
Ob Befehle OP-Berechtigungen erfordern |
Daten-Speicherung
Charakter-Daten werden im Weltordner gespeichert:
world/data/chars/<spieler-uuid>/
├── current-char.json # Aktuelle Charakter-ID
├── 1.json # Charakter 1 Daten
├── 2.json # Charakter 2 Daten
└── ...
JSON-Struktur eines Charakters
{
"id": 1,
"first_name": "Max",
"last_name": "Mustermann",
"birth_date": "01.01.2000",
"gender": "männlich",
"x": 100.5,
"y": 64.0,
"z": -200.3,
"health": 20.0,
"hunger": 20,
"experience": 30,
"money": 1500.0,
"effects": [...],
"inventory": [...]
}
Hinweis: Dieses Wiki dient als Dokumentation. Für aktive Diskussionen tritt bitte dem Discord-Server bei.
