Skip to content

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

Latest commit

 

History

269 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 (by Waseku).

Built With Rust Made With Slint Discord Join Modmanager Website License Apache Release Version Release Version Staging Release Version Dev GitHub Sponsors Rust Version Slint Version Supported OS Linux & Windows

Powered by MelonLoader Powered by Datacentermods


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/arm64 Experimental Real-Mac validation required; no signed or notarized release yet

The APK package is experimental until Alpine runtime and Steam compatibility have been validated. Native installation and upgrade tests are required before publishing the newly prepared installers and packages.

Requirement Version
Rust toolchain stable via rustup
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 without local mods
  • With Mods — launch Data Center with the installed local mods
  • Headless mode — scripted/CI publishing without UI
  • Settings — workspace folder, game root, language, mod-store mode
  • Localization — English + German (minimum), more via the greg-core l10n modules

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, and automatic conflict resolution are not currently released features.

Installation

Windows

  1. Download gregmodmanager-<version>-win-x64.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-x64.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)

The app checks GitHub Releases at startup and can also check from Settings. After confirmation it downloads the matching package and opens the installer or system package handler. Portable installations receive an archive and must be replaced manually. Some Linux desktops need a package handler installed for the chosen format. Downloads are verified against GitHub's release-asset SHA-256. 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)

Rust crates (workspace dependencies)

  • slint / slint-build 1.18.1 + lucide-slint 1.49.1 — desktop UI (retained mode, single binary)
  • steamworks 0.13.1 + steamworks-sys — Steam Workshop integration (native library staging)
  • tokio, reqwest (rustls) — async runtime / Modstore REST + OAuth
  • serde / serde_json, thiserror, anyhow, semver, dirs, clap, rfd, notify, zip, tracing

Build only

  • Rust toolchain via rustup (stable)
  • cargo xtask dist — release build + portable package incl. native Steam library
  • nfpm (Linux distro packages only)

Build from Source

Requirements:

  • Rust stable toolchain via rustup
  • Linux X11 / font / GL development packages for Slint (libxkbcommon, fontconfig, freetype6, libgl1) — see the devcontainer Dockerfile for the full set
  • A running Steam client (only needed for Workshop features, not for build/test)
git clone <forgejo-url>/gregModmanager.git
cd gregModmanager
cargo build --workspace
cargo test --workspace
cargo run -p greg-app

For release artifacts, start with cargo xtask dist (portable package incl. native Steam library). See the build-script reference and Docker build and test containers.

The Windows release build produces the portable ZIP via cargo xtask dist and the Setup EXE and MSI via build/installer/build-windows.ps1 on Windows. Linux distro packages are built via build/scripts/linux/build-rust-packages.sh. GitHub Actions publishes stable releases after successful builds on main; see GitHub release automation for prerequisites and limitations.

Repository Layout

crates/
  greg-core/                     domain models, docs/changelog logic, errors — NO UI deps
  greg-platform/                  cfg(target_os) shims (replaces Unix/Windows/MacOs projects)
  greg-steam/                     Steam Workshop via the `steamworks` crate
  greg-modstore/                  Modstore REST client (catalog, updates, atomic installs, publish)
  greg-loader/                    game/MelonLoader discovery, installs, adapters, launch
  greg-app/                       desktop UI binary (Slint)
  greg-cli/                       headless publish/status/list binary
xtask/                           build orchestration (`cargo xtask …`)
scripts/                         local developer workflow scripts (check, build, run, release)
build/                           release scripts, installers, Linux packaging
docker/                          Rust build/test containers
docs/                            repository documentation
.github/workflows/               GitHub test builds and guarded promotion
VERSION                          single source of truth for the version (workspace Cargo.toml is the fallback)
LICENSE                          Apache 2.0

SubDirectoryFixer targets .NET 6 because MelonLoader requires that runtime. It stays frozen in .reference/modmanager-old/ and is built separately from the Rust workspace.

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