mirror of
https://github.com/mleem97/gregWiki.git
synced 2026-04-11 03:29:19 +02:00
fcac837bd9
Revised multiple documentation files to replace instances of "FrikaMF" with "gregCore," reflecting the updated naming conventions and project structure. This change enhances consistency and clarity across the documentation, ensuring that users and contributors have accurate information regarding the framework and its components.
135 lines
4.6 KiB
Markdown
135 lines
4.6 KiB
Markdown
---
|
|
id: enduser-workshop
|
|
title: End-User Guide — GregModManager
|
|
sidebar_label: End-User Guide
|
|
description: How to browse, install, and manage Data Center mods using GregModManager (Gregtools Modmanager).
|
|
sidebar_position: 10
|
|
tags:
|
|
- audience:enduser
|
|
- workshop
|
|
---
|
|
|
|
# End-User Guide — GregModManager
|
|
|
|
This guide is for players who want to **install and manage mods** for Data Center using **GregModManager** — the Gregtools desktop app (executable on disk is still `WorkshopUploader.exe`; sources live under **`gregModmanager/`**).
|
|
|
|
## What you need
|
|
|
|
- **Data Center** installed via Steam.
|
|
- **Steam** running and logged in.
|
|
- **GregModManager** (`WorkshopUploader.exe` in release builds) — either built from source or installed from a release.
|
|
|
|
## Installation
|
|
|
|
You can run GregModManager from **any folder you prefer** (for example `Program Files`, Desktop, Downloads, or a folder next to the game). **Source code** for the app lives in the repo folder **`gregModmanager/`** (release ZIPs ship `WorkshopUploader.exe` / **Gregtools Modmanager**).
|
|
|
|
### Option A — Installer setup (recommended)
|
|
|
|
1. Run the latest `GregToolsModmanager-<version>-Setup.exe`.
|
|
2. Complete the installer wizard (default path is under `Program Files`).
|
|
3. Start the app from the Start Menu or desktop shortcut.
|
|
|
|
### Option B — Portable / ZIP build
|
|
|
|
1. Download or build the GregModManager files.
|
|
2. Extract/copy the folder to any location you want.
|
|
3. Launch `WorkshopUploader.exe` directly from that folder.
|
|
|
|
After startup, the Steam status indicator in the top-right should turn green.
|
|
|
|
## Browsing mods (Mod Store)
|
|
|
|
1. Open the **Mod Store** tab.
|
|
2. Use the **Store** sub-tab to browse all available mods.
|
|
3. Filter by tag (vanilla, modded, melonloader, fmf, framework) or sort by popularity, date, score, etc.
|
|
4. Use the **Search** bar to find specific mods by name.
|
|
5. Click on any mod to see its **detail page** with full stats, description, and action buttons.
|
|
|
|
## Installing mods (Subscribe)
|
|
|
|
1. In the Store or on an item's detail page, click **Subscribe**.
|
|
2. Steam downloads the mod automatically.
|
|
3. Check the **Installed** sub-tab to see all your subscribed mods.
|
|
|
|
Subscribed mods are managed by Steam — they update automatically when the author publishes changes.
|
|
|
|
## Favorites
|
|
|
|
1. On an item's detail page, click **Favorite** to bookmark it.
|
|
2. View all your favorites in the **Favorites** sub-tab.
|
|
3. Click **Unfavorite** to remove.
|
|
|
|
## Voting
|
|
|
|
On an item's detail page:
|
|
|
|
- Click **Vote Up** to recommend the mod.
|
|
- Click **Vote Down** if there's a quality issue.
|
|
|
|
Your votes help the community find the best mods.
|
|
|
|
## Dependency Health (Health tab)
|
|
|
|
The **Health** sub-tab checks whether your game has:
|
|
|
|
- MelonLoader installed
|
|
- Il2Cpp interop assemblies generated
|
|
- FrikaModFramework core DLL
|
|
- FMF plugins directory
|
|
- Mod config directory
|
|
|
|
If anything is missing, follow the instructions shown.
|
|
|
|
### Installing MelonLoader
|
|
|
|
1. Go to the Health tab and click **Download page**.
|
|
2. Download the latest **MelonLoader Installer** from GitHub.
|
|
3. Run the installer, select **Data Center** as the game, choose **IL2CPP**.
|
|
4. Start the game once and close it (this generates required assemblies).
|
|
|
|
## Troubleshooting
|
|
|
|
### "Steam - offline" in the title bar
|
|
|
|
- Make sure Steam is running and you are logged in.
|
|
- Ensure `steam_appid.txt` (containing `4170200`) exists next to `WorkshopUploader.exe`.
|
|
- If you use the portable/ZIP variant, make sure you copied the full app folder (not just the `.exe`).
|
|
|
|
### Mod does not load in-game
|
|
|
|
- Check `MelonLoader/Latest.log` in the game directory.
|
|
- Ensure `gregCore.dll` is in `<game>/Mods/`.
|
|
- Verify the mod DLL is also in `<game>/Mods/` or `<game>/FMF/Plugins/`.
|
|
|
|
### Subscription does not appear
|
|
|
|
- Wait a few seconds and refresh the Installed list.
|
|
- Steam may need a moment to process the subscription.
|
|
|
|
### App crashes only after installer install
|
|
|
|
- Reinstall using the latest setup build.
|
|
- Open **Settings -> Logs** and include the newest log lines when reporting the issue.
|
|
- If available, report crash details via GitHub Issues.
|
|
|
|
## Reporting bugs and issues
|
|
|
|
If you find a bug, crash, or unexpected behavior, please open an issue on GitHub:
|
|
|
|
- [Report an issue](https://github.com/mleem97/GregToolsModmanager/issues)
|
|
|
|
To help us fix issues faster, include:
|
|
|
|
- What you were doing when the problem happened
|
|
- Clear steps to reproduce
|
|
- Your app version and Windows version
|
|
- Error message or screenshot (if any)
|
|
- Relevant logs from **Settings -> Logs**
|
|
- A repro ZIP from **Settings -> Create repro bundle**
|
|
|
|
## Uninstalling mods
|
|
|
|
1. Go to the **Installed** sub-tab.
|
|
2. Click **Unsubscribe** on the mod you want to remove.
|
|
3. Steam removes the mod files automatically.
|