Skip to content

Latest commit

 

History

6 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🛡️ Valheim ModSync (Professional Edition)

An automated infrastructure tool for Valheim server administrators. This tool bridges the gap between local r2modman profiles and Dedicated Servers by providing a modular, configuration-driven sync engine.

🚀 The Problem

In Valheim modding, many plugins (UI, Camera, Lighting) are client-side only. Uploading these to a dedicated server often leads to crashes or performance issues. Manually filtering these out every time you update is tedious and error-prone.

✨ Key Features

  • Logic/Data Separation: Logic resides in ModSync.bat, while all user settings are stored in config.ini.
  • Dynamic Blacklisting: Easily exclude client-side-only folders (e.g., PlantEasily, FirstPersonMode) via the configuration file.
  • Robust Mirroring: Uses Windows robocopy with /MIR to ensure the server is a perfect, clean reflection of your local setup.
  • Path Validation: Automatically checks for environment variables and mounted network drives before execution.
  • Logging: Generates a detailed sync_log.txt for auditing and troubleshooting.

🛠️ Installation & Setup

  1. Download: Download the latest release (ModSync.bat and config.ini.example).
  2. Setup Config: Rename config.ini.example to config.ini.
  3. Configure: Open config.ini in any text editor and enter your specific source and destination paths.
  4. Run: Execute ModSync.bat whenever you update your local mods.

📋 Recommended Blacklist

The following mods should typically be blacklisted for server stability: PlantEasily,FirstPersonMode

👨‍💻 Project Context

Developed by Marcel Sölter as part of the Nebirrs Lab infrastructure project. This tool demonstrates proficiency in Windows automation, file system management, and user-centric software design within the scope of professional training as an Application Developer (Fachinformatiker für Anwendungsentwicklung).


Created for the Valheim community. Use responsibly and always keep backups of your world.

About

"A robust, configuration-driven tool to sync r2modman profiles to Valheim Dedicated Servers with smart mod blacklisting."

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages