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 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

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

Client

• Mod in den BepInEx/plugins Ordner kopieren
• 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 │

││

│ │

│ 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