ServerCharacters.md - BeardyLP/Valheim GitHub Wiki

📦 ServerCharacters

Erzwingt servergebundene Charaktere – für faires Gameplay, RP-Welten, Progression und Schutz vor externem Cheat-Import.

📝 Beschreibung

ServerCharacters speichert Charakterdaten nicht mehr lokal, sondern auf dem Server, sodass:

  • 🛡️ Keine lokal erstellten/hochgelevelten Charaktere genutzt werden können
  • 🔒 Spieler immer mit dem gleichen Charakter auf deinem Server spielen
  • 🌍 Fortschritt & Inventar an den Server gebunden sind
  • 🧠 Offline-Fortschritt auf anderen Servern / SP wird verhindert

Ideal für:

  • 🎮 Fairen PvP / Survival
  • 🏹 Progressionsbasierte Server
  • 🎭 RP-Server
  • 🔧 Mod-Server mit serverseitigem Balancing

⚙️ Konfiguration (BepInEx/config/escadadev.ServerCharacters.cfg)

EnableServerCharacters=true
ForceNewCharacter=true
RestrictToServerWorld=true
SaveOnLogout=true
KickOnMismatch=true
ShowWarningMessage=true

🔐 Rechte

  • ✅ Member: Werden automatisch auf serverseitigen Charakter umgestellt
  • 🛠️ Admin: Kann erzwingen, ob Spieler neue Chars brauchen, gewarnt oder gekickt werden
  • 🔧 Ideal mit ServerSync für vollständige Serverbindung

➕ Vorteile

  • Vollständiger Schutz vor „Savegame-Schummlern“
  • Gleiche Voraussetzungen für alle Spieler
  • Perfekt für Server mit Progression, Fraktionen, Klassen etc.
  • Kombinierbar mit Inventarmods, RPG-Perks oder Skillsystemen

➖ Nachteile

  • Kein Offline-Spielstand-Transfer möglich
  • Spieler verlieren ihren Charakter bei Serverwechsel
  • Muss transparent kommuniziert werden (z. B. im Server-Join-Info)

💡 Konfigurationsbeispiele

Beschreibung Konfigurationsblock
Nur neue Charaktere zulassen ini\nForceNewCharacter=true\n
Bei falschem Charakter automatisch kicken ini\nKickOnMismatch=true\n
Warnung beim Join anzeigen ini\nShowWarningMessage=true\n
Lokalen Fortschritt komplett verhindern ini\nRestrictToServerWorld=true\n

🌐 Link

ServerCharacters auf Thunderstore

📊 Kompatibilität

Client erforderlich Server erforderlich
✅ Ja ✅ Ja

🧰 Features

🔁 Backups

  • Erstellt automatisch Backups aller Charakterprofile auf dem Server.
  • Die Anzahl der gespeicherten Backups ist konfigurierbar.
  • Speicherort: Gleicher Ordner wie die Server-Charakterdaten.

🚨 Notfall-Backups

  • Bei plötzlichem Verbindungsverlust eines Clients wird automatisch ein Notfall-Backup erzeugt.
  • Dieses wird beim nächsten Verbindungsaufbau hochgeladen & wiederhergestellt – kein Fortschrittsverlust bei Abstürzen oder Internetproblemen.
  • Backups sind signiert – Manipulation macht sie ungültig. Der Server akzeptiert nur authentische Backups.

⏱️ AFK-Kick-Timer

  • Automatisches Kicken inaktiver Spieler nach konfigurierbarer Zeitspanne.
  • Ein Spieler gilt als AFK, wenn er sich für eine bestimmte Zeit nicht bewegt.

☠️ Gift-Debuff-Speicherung

  • Poison-Debuffs werden beim Logout gespeichert und beim Login erneut angewendet.
  • Verhindert Exploits wie Debuff-Reset durch Relog.
  • Kann in der Konfiguration deaktiviert werden.

🎒 Serverseitiges Inventar

  • Das komplette Inventar wird auf dem Server gespeichert – schützt vor Duplizieren von Items.

👤 Einzelcharakter-Modus

  • Aktivierbar in der Serverkonfig: Pro Steam-ID darf nur ein Charakter erstellt werden.
  • Ausgenommen: Admins

💀 Hardcore-Modus

  • Aktivierbar in der Serverkonfig:
    Wenn ein Spieler stirbt, wird er vom Server gekickt und sein Charakterprofil gelöscht.
    Der Charakter bleibt im Einzelspieler weiterhin nutzbar.

🗂️ Backup-Only-Modus

  • Aktivierbar in der Serverkonfig:
    Nur Backups werden erstellt, aber der Server erzwingt keine vollständige Serverbindung.

🧬 Charakter-Vorlagen

  • Erstelle auf Serverseite eine Datei namens CharacterTemplate.yml im Mod-Ordner.
  • Neue Spieler erhalten automatisch:
    • Start-Items
    • Vorkonfigurierte Skills
    • Benutzerdefinierten Spawnpunkt

🔧 Admin-Befehle (Konsole)

Alle Befehle beginnen mit ServerCharacters und bieten volle Kontrolle über Spielerprofile:

---


ServerCharacters resetskill [skill] [name] [ID]
ServerCharacters raiseskill [skill] [level] [name] [ID]
ServerCharacters teleport [name] [ID]
ServerCharacters summon [name] [ID]
ServerCharacters giveitem [item] [anzahl] [name] [ID]