Skip to content

Latest commit

 

History

History
230 lines (162 loc) · 9.06 KB

File metadata and controls

230 lines (162 loc) · 9.06 KB

Documentation Index — gregModmanager

Version: v1.5.1 Last Updated: May 2026


Quick Navigation

For Users

For Mod/Plugin Creators

For Contributors

General Resources


Documentation by Topic

Installation & Setup

Topic Link Audience
Windows installation End-User Guide § Windows End Users
Linux installation End-User Guide § Linux End Users
First-run setup End-User Guide § First-Run Setup End Users
Development environment Contributor Guide § Setup Contributors

Building & Release

Topic Link Audience
Build script reference Contributor Guide § Build System Contributors
Release workflow Contributor Guide § Release Process Maintainers
Packaging (installer, portable, Linux) build.ps1 source Contributors

Modding & Package Management

Topic Link Audience
Package types overview Mod Creator Guide § Modding Ecosystem Creators
Creating game mods Mod Creator Guide § Game Mods Creators
Creating MelonLoader plugins Mod Creator Guide § MelonLoader Plugins Creators
gregCore mods and extensions Mod Creator Guide § gregCore Creators
UserLibs / shared libraries Mod Creator Guide § UserLibs Creators
Dependency declarations Mod Creator Guide § Dependencies Creators
Manifest format reference Mod Creator Guide § Manifests Creators

UI & Features

Topic Link Audience
UI overview End-User Guide § User Interface End Users
Managing games End-User Guide § Managing Games End Users
Managing mods End-User Guide § Managing Mods End Users
Mod profiles End-User Guide § Profiles End Users

Troubleshooting

Topic Link Audience
Common errors End-User Guide § Troubleshooting End Users
Log file locations End-User Guide § Reading Logs End Users
Reporting bugs End-User Guide § Reporting Issues End Users
Debugging code Contributor Guide § Debugging Contributors

Development

Topic Link Audience
Architecture Contributor Guide § Architecture Contributors
Coding standards Contributor Guide § Coding Standards Contributors
Testing Contributor Guide § Testing Contributors
Contributing workflow Contributor Guide § PR Workflow Contributors
Localization Contributor Guide § Localization Contributors

Example Resources

Manifest Examples

Located in docs/examples/manifests/:

File Type Use Case
01_simple_mod.json Game Mod No dependencies, basic mod
02_gregcore_mod_with_deps.json gregCore Mod Complex dependencies, multiple requirements
03_universal_plugin.json MelonLoader Plugin Works with any game
04_game_specific_plugin.json MelonLoader Plugin Game-specific optimization
05_gregcore_extension.json gregCore Extension Extends gregCore services
06_userlib.json UserLib Shared library with versioning

How to use: Copy an example manifest, modify fields for your mod, then validate and publish.

Example Mod Structures

Located in docs/examples/mods/ (to be populated with working examples)


External Resources

Official Ecosystems

Related Technologies

Community


Documentation Maintenance

Wiki (Submodule)

The wiki/ folder is a Git submodule pointing to gregModmanager.wiki.

To update wiki:

# Navigate to wiki submodule
cd wiki

# Make changes (using GitHub web or local editor)
git add .
git commit -m "docs: update [topic]"
git push origin main

# Return to main repo and commit submodule update
cd ..
git add wiki
git commit -m "chore: update wiki submodule"
git push origin main

docs/ Folder

The docs/ folder contains generated/supplementary documentation:

  • 01_END_USER_GUIDE.md — User-facing guide
  • 02_MOD_CREATOR_GUIDE.md — Modding documentation
  • 03_CONTRIBUTOR_GUIDE.md — Developer/contributor guide
  • examples/ — Code examples and templates
  • INDEX.md — This file

To update docs:

# Edit .md files directly
git add docs/
git commit -m "docs: update [topic]"
git push origin main

Contributing to Documentation

Want to improve the docs? Here's how:

  1. Identify the gap: Missing info, outdated section, unclear explanation?
  2. Create an issue: GitHub Issues with label documentation
  3. Fork and edit: Edit the relevant .md file
  4. Submit PR: Include a clear description of changes
  5. Review: Maintainers will review for clarity and accuracy

Documentation style guide:

  • Use clear, concise language
  • Include code examples where relevant
  • Link to related sections
  • Add screenshots for UI-heavy topics
  • Test any instructions you add

Version Compatibility

This documentation is for:

  • gregModmanager v1.5.1
  • .NET 9.0+
  • Avalonia UI 11.2+
  • MelonLoader 0.6.0+
  • gregCore 2.0.0+

Documentation for other versions:


Last Updated: May 2026 Next Review: November 2026