vhvac

VHVAC - Valheim Anti-Cheat

Ein moderner Anti-Cheat Mod für Valheim Server, der sicherstellt, dass Server und Client die gleichen Mod-Versionen verwenden.

Achtung: Die Info Anzeige hat ein Branding zur https://valheim-server.de Webseite. Es handelt sich um einen internen Community-Mod.

✨ Features

🔒 Mod-Versionsprüfung

• Überprüft ob alle Mods auf Server und Client in der gleichen Version vorliegen
• Detaillierte Anzeige von Versions-Unterschieden (Server vs. Client)
• Verhindert Verbindung bei Versions-Mismatch

📋 Erlaubte Mods Liste

• Konfigurierbare Liste von erlaubten Mod-GUIDs
• Wenn leer, werden automatisch alle Server-Mods als erlaubt behandelt
• Blockiert Clients mit unerlaubten Mods (zeigt bis zu 3 Mods, Rest als "+X weitere")

🔑 Hash-Prüfung

• MD5-Hash-Vergleich aller Plugin-DLLs
• Erkennt modifizierte Mod-Dateien

👑 Admin-Bypass

• Admins können alle Prüfungen umgehen (konfigurierbar)

🎨 Eigene Fehler-Anzeige

• Benutzerdefiniertes UI-Panel mit farbcodierten Fehlermeldungen
• Klare Darstellung aller Probleme auf einen Blick
• Kompatibel mit Jotunn (Jotunn-Patches werden automatisch deaktiviert)

📁 Keine Client-Config

• Clients erstellen keine Konfigurationsdatei
• Alle Einstellungen werden vom Server synchronisiert

📦 Installation

Server

1. Mod in den BepInEx/plugins Ordner kopieren
2. Server starten - Konfigurationsdatei vhvac.core.cfg wird erstellt
3. Konfiguration nach Bedarf anpassen

Client

1. Mod in den BepInEx/plugins Ordner kopieren
2. Fertig - keine Konfiguration nötig

> Hinweis: Sowohl Server als auch Client müssen den Mod installiert haben!

⚙️ Konfiguration

Die Konfigurationsdatei vhvac.core.cfg wird nur auf dem Server im BepInEx/config Ordner erstellt.

Allgemeine Einstellungen

| Einstellung | Standard | Beschreibung | |-------------|----------|--------------| | Aktiviert | true | Aktiviert oder deaktiviert den VHVAC Mod | | Config gesperrt | true | Nur Admins können die Konfiguration ändern | | Debug Modus | false | Erweiterte Debug-Ausgaben im Log |

Anti-Cheat Einstellungen

| Einstellung | Standard | Beschreibung | |-------------|----------|--------------| | Exakte Mods erzwingen | true | Client muss exakt die gleichen Mods wie der Server haben | | Admin Bypass | true | Admins umgehen alle Prüfungen | | Hash Prüfung | true | Überprüft MD5-Hash der Mods | | Versions Prüfung | true | Überprüft Mod-Versionen | | Erlaubte Mods Prüfung | true | Nur Mods aus der Liste werden akzeptiert | | Erlaubte Mods | (leer) | Komma-getrennte Liste von erlaubten Mod-GUIDs |

Beispiel für erlaubte Mods

[2. Anti-Cheat]
Erlaubte Mods = vhvac.core,shudnal.ProtectiveWards,WackyMole.EpicMMOSystem

Wenn die Liste leer ist, werden automatisch alle auf dem Server installierten Mods als erlaubt behandelt.

Kick-Nachrichten

| Einstellung | Beschreibung | |-------------|--------------| | Kick Versions Mismatch | Nachricht bei unterschiedlichen Mod-Versionen | | Kick Hash Mismatch | Nachricht bei unterschiedlichen Mod-Dateien | | Kick Unerlaubter Mod | Nachricht wenn Client unerlaubte Mods hat | | Kick Fehlender Mod | Nachricht wenn Client benötigte Mods nicht hat |

🔧 Wie es funktioniert

┌─────────────┐                           ┌─────────────┐
│   Client    │                           │   Server    │
└──────┬──────┘                           └──────┬──────┘
       │                                         │
       │  1. Verbindungsaufbau                   │
       │────────────────────────────────────────>│
       │                                         │
       │  2. VHVAC_ModCheck Request              │
       │<────────────────────────────────────────│
       │                                         │
       │  3. Mod-Liste + Versionen + Hashes      │
       │────────────────────────────────────────>│
       │                                         │
       │           4. Server prüft:              │
       │           - Mod-Versionen               │
       │           - Erlaubte Mods               │
       │           - Fehlende Mods               │
       │           - Hash-Werte                  │
       │                                         │
       │  5. OK oder Fehlermeldung               │
       │<────────────────────────────────────────│
       │                                         │

📋 Anforderungen

• Valheim - Aktuellste Version
• BepInEx 5.4.x oder höher
• ServerSync (wird automatisch integriert via ILRepack)

MIT License - Siehe LICENSE für Details.

🙏 Credits

• Inspiriert vom originalen VAC Mod von João Pedro Viana Freitas
• ServerSync für die Konfigurationssynchronisation
• BepInEx Framework