Getting Started - ModNexus Docs

The Universal Mod Distribution Engine

Phase One

Installation

The ModNexus Launcher is a lightweight, cross-platform client that manages dependencies, verifies file integrity, and syncs your library across Windows, macOS, and Linux.

Windows & macOS

Download the `.exe` or `.dmg` installer from our releases page. Run the executable and follow the setup wizard. The launcher will automatically detect your game directories for titles like Skyrim Special Edition, Cyberpunk 2077, and Factorio.

Download Launcher v2.4.1

Linux & Steam Deck

Install via Flatpak from Flathub or use the AppImage bundle. Ensure `libgtk-3-0` and `zenity` are present for the dependency resolver. The client runs natively under Proton without compatibility layers.

View Linux Build Notes

Phase Two

Account Setup

A ModNexus account is required to track downloads, manage mod profiles, and access developer tools. Authentication is handled securely via OAuth 2.0.

Click Register in the launcher's top-right corner or visit the web portal. You can sign up with an email address, or link your existing Steam, GOG, or Epic Games account for instant profile import. Once verified, navigate to Settings > API & Keys to generate a personal access token if you plan to use the CLI tool for automated mod pack deployments.

Profile Configuration

Set your default game library paths, configure download mirrors for your region, and enable two-factor authentication. The launcher caches your session securely using platform-specific keychain services.

Developer Portal Access

Mod creators can enable the Publisher Dashboard toggle to upload builds, manage versioning, and track live install metrics. API rate limits start at 1,200 requests per hour for verified accounts.

Phase Three

First Download

With the launcher running and your account synchronized, you're ready to install your first modification. The dependency manager handles conflicting files and automatic backups.

Open the Discover tab and search for a verified mod, such as "Skyrim: High-Fidelity Textures v4.2" or "Factorio: Space Exploration 2.1.0". Click the Install button. ModNexus will resolve required frameworks, stage the files in your local `.modnexus/cache` directory, and apply them using your selected method (VFS overlay, direct file replacement, or Wabbajack-style manifest). A progress dialog will show hash verification and rollback points. Once complete, launch the game through the client to ensure proper injection.

Manage & Update

Your installed mods appear in the Library tab. Click the three-dot menu on any entry to pin versions, force updates, or generate a shareable `.nexus-pack` manifest. The background updater checks for new releases every 6 hours.

Browse Verified Mods

Troubleshooting

If a mod fails to apply, check the Logs panel for `ERROR_CODE_404` or `DEP_MISMATCH` flags. Clear the cache via `Ctrl+Shift+R`, verify game file integrity through your store client, and retry. Community support is available in the #modding-help Discord channel.