Skip to content

Latest commit

 

History

209 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

gregModmanager

Cross-platform desktop mod manager for the gregFramework ecosystem — local Workshop projects, Steam Workshop publishing, Mod Store, and one-click game launch for Data Center.

Discord gregFramework License Version Release Sponsors DotNet Avalonia Windows Linux

Links

Overview

gregModmanager is a cross-platform desktop client for the gregFramework modding ecosystem. It manages local Workshop projects, publishes them to the Steam Workshop via native Steamworks calls, browses and subscribes Mod Store items, and launches Data Center with or without mods — on Windows and Linux.

Compatibility

Platform Build status Distribution status
Windows x64 Supported Portable ZIP, Inno Setup EXE, WiX MSI
Linux x64 Supported Portable ZIP/tarball, DEB, RPM, APK, Arch package
macOS x64 Experimental cross-publish Manual testing on a real Mac only; no signed or notarized release
Requirement Version
.NET SDK pinned in global.json (.NET 10)
Steam client running (for Workshop features)
Data Center Steam AppID 4170200

Features

  • Projects — local projects tab (search, refresh, edit) + Workshop uploads tab (import, update, open on Steam)
  • Editor — title, description, tags, visibility, preview image, screenshots, changelog, upload readiness check
  • Steam Workshop publishing — native ISteamUGC calls (create + update), change notes, live progress
  • Mod Store — browse and subscribe Workshop items (Full / Decide-later modes)
  • Start Game — launch Data Center via Steam, with or without mods
  • Headless mode — scripted/CI publishing without UI
  • Settings — workspace folder, game root, language, mod-store mode
  • Localization — English + German (minimum), more via AppStrings resources

The desktop UI exposes Projects, New Project, and Settings. In Full and Decide-later modes, it also exposes a Steam Workshop Mod Store. Profile management, manual load-order editing, automatic conflict resolution, and an in-app updater are not currently released features.

Installation

Windows

  1. Download gregModmanager-<version>-Windows.zip (or the Setup EXE) from the releases page
  2. Extract the ZIP anywhere (or run the installer) and start GregModmanager.exe
  3. Make sure Steam is running before starting the app

Linux

  1. Download gregModmanager-<version>-Linux.tar.gz (or a DEB/RPM/APK/Arch package) from the releases page
  2. Extract the tarball anywhere and start ./GregModmanager (or install the package)
  3. Make sure Steam is running before starting the app — libsteam_api64.so / libsteam_api.so ship next to the binary

Dependencies

Runtime

  • Steam client (running — required for Workshop features only)
  • Data Center on Steam (AppID 4170200, for game launch + Workshop target)

NuGet packages (bundled in release)

  • Avalonia 12.1.1, Cherry.Facepunch.Steamworks 2.5.0, Microsoft.Extensions.DependencyInjection 10.0.10

Build only

  • .NET SDK pinned in global.json
  • Inno Setup 6 + WiX CLI 5 (Windows installer artifacts only)
  • nfpm (Linux distro packages only)

Build from Source

Requirements:

  • .NET SDK pinned in global.json
  • A running Steam client (only needed for Workshop features, not for build/test)
git clone <forgejo-url>/gregModmanager.git
cd gregModmanager
dotnet restore GregModmanager.sln
dotnet build GregModmanager.sln -c Release
dotnet test GregModmanager.sln -c Release
dotnet run --project src/GregModmanager.Avalonia/GregModmanager.Avalonia.csproj

For release artifacts, start with the build-script reference. The normal Windows release build requires Inno Setup 6 and WiX CLI 5. Linux packages are built directly by the Linux packaging script or from Windows through WSL; a non-Windows invocation of build.ps1 does not create distro packages.

Repository Layout

src/
  GregModmanager.Avalonia/       Avalonia desktop application
  GregModmanager.Core/           models, services, Steam and local-state code
  GregModmanager.Melons/         MelonLoader integrations, including SubDirectoryFixer
tests/GregModmanager.Tests/      xUnit test project
build/                           interactive builders, release scripts, installers
docker/                          Linux build/test container and Windows-container notes
docs/                            repository documentation (the tracked wiki content)
.forgejo/workflows/ + .gitea/workflows/   CI pipelines, byte-identical (Forgejo + Gitea Actions; GitHub is a read-only archive mirror)
VERSION                          single source of truth for the version (.csproj is the fallback)
LICENSE                          Apache 2.0

SubDirectoryFixer targets .NET 6 because MelonLoader requires that runtime. It is built separately from the main solution and copied to the Avalonia assets by build/scripts/build.ps1.

Documentation

Credits

Role Contributor
Codebase mleem97 (TeamGreg Modding)

Contributing

See CONTRIBUTING.md for guidelines.

License

This project is licensed under the Apache License 2.0. See LICENSE.

🚀 Join the gregFramework Team!

Building the ultimate modding framework for Data Center is a massive undertaking. gregFramework is currently maintained by a passionate core team of three, and we are looking for fellow creators to help us scale this mission!

Your place in the team: We won't throw you into the deep end. Depending on your individual strengths and skills, we will match you with the right areas of the project so you can contribute exactly where you have the most fun.

🌍 Language Requirement: A solid grasp of written English is required (without relying on machine translation). Being comfortable speaking English in voice chats is a huge plus, but we completely respect those who prefer to stick to text!

We are looking for motivated volunteers to join our crew across several roles:

  • 💻 Code Wizards (C#, Rust, Lua, TS, GO) — Build and expand the core framework and mod packages
  • 🎨 Asset Creators (3D Models, hardware assets) — Bring the framework to life visually
  • 📚 Technical Writers — Craft wiki entries, maintain documentation, and write user guides
  • 🎮 Alpha Testers — Hunt down bugs, stress-test the framework, and provide critical feedback
  • ⚙️ System Guardians — Maintain our Linux servers, Docker containers, and infrastructure
  • 🤝 Community Managers — Foster our Discord community, gather feedback, and keep the energy high

Interested in joining the project? Everyone is absolutely welcome! Send us an email at apply@gregframework.eu, shoot a quick DM, or drop a message on Discord.


gregFramework — powered by the community.

About

gregModmanager is a modern, user-friendly application that simplifies installing, managing, and publishing mods for MelonLoader-based games. It supports Windows and Linux (macOS coming soon), integrates with Steam, and provides an intuitive interface

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Releases

Sponsor this project

Used by

Contributors

Languages