Yellowcake Mod Manager

Modern free and open-source Mod Manager

A powerful, modern desktop application for managing mods in Nuclear Option. Built with .NET 10 and Avalonia UI, Yellowcake provides a seamless experience for browsing, installing, and managing game modifications.

✨ Features

🎮 Core Functionality

One-Click Mod Installation - Download and install mods directly from curated repositories
Automatic BepInEx Management - Install, update, and uninstall BepInEx with a single click
Smart Dependency Resolution - Automatically detect and resolve mod dependencies
Conflict Detection - Identify and warn about incompatible mods before installation
Mod Enable/Disable - Toggle mods on/off without uninstalling
Batch Operations - Install, update, or remove multiple mods simultaneously

📦 Advanced Mod Management

Local Mod Installation - Import mods from ZIP files or individual DLLs
Official Manifest Source - Uses the NOMNOM manifest endpoint
Mod Library Sync - Share and restore mod configurations via sync codes
Update Detection - Automatic notification when mod updates are available
Version Control - Track installed mod versions and update history
Categorization - Organize mods by type (Plugins, Voice Packs, Liveries, Missions)

🚀 Performance & Analytics

Performance Dashboard - Real-time download statistics and metrics
- Total downloads and success rates
- Average download speeds and peak performance
- Data transfer analytics
- Top downloaded mods leaderboard
Download Queue - Parallel download management with configurable concurrency
Progress Tracking - Live progress indicators for all operations
Performance Metrics Export - Export analytics to CSV for analysis

🎨 User Experience

Modern UI - Beautiful, responsive interface with smooth animations
Theme System - Multiple built-in themes (Dark, Light, Synthium)
- Custom theme support
- Live theme switching
- Per-user theme preferences
Search & Filter - Powerful search with filtering by category, status, and tags
Sorting Options - Sort by name, author, date, or popularity
Screenshot Viewer - Preview mod screenshots in an integrated gallery
Empty States - Helpful guidance when no content is available

⚡ Advanced Features

Keyboard Shortcuts - Comprehensive hotkey support for power users
- Ctrl+F - Focus search
- F5 - Refresh mod list
- Ctrl+, - Open settings
- Ctrl+P - Performance dashboard
- Ctrl+L - Log viewer
- F1 - Hotkeys guide
Notification System - Rich notifications with action buttons
- Success/Error/Warning/Info messages
- Clickable actions for quick retries
- Toast notifications with auto-dismiss
Log Viewer - Real-time application logs with filtering
- Multiple log levels (Debug, Info, Warning, Error)
- Search and filter capabilities
- Export logs for troubleshooting
Diagnostics Window - System health checks and troubleshooting tools
Auto-Update - Automatic application updates with changelog display

🌐 Network & Hosting

Google Drive Support - Direct downloads from Google Drive links
- Automatic URL conversion
- Virus scan warning bypass
- Large file handling
GitHub Integration - Fetch BepInEx versions from GitHub releases
Retry Logic - Automatic retry on network failures
Download Resumption - Resume interrupted downloads
Parallel Downloads - Multiple simultaneous downloads with throttling

🔧 System Integration

Auto Game Detection - Automatically locate Nuclear Option installation
Desktop Shortcuts - Create modded game launcher shortcuts
File Associations - Drag-and-drop mod installation
System Tray - Minimize to tray for background operation
Command-Line Support - Launch game with --launch parameter
Cross-Platform - Windows, Linux, and macOS support

💾 Data Management

Local Database - LiteDB for fast, reliable data storage
Import/Export - Backup and restore mod configurations
Cache Management - Intelligent caching with configurable limits
- Thumbnail cache (50 images in memory)
- Manifest cache (persistent between sessions)
- Automatic cache cleanup
Settings Persistence - All preferences saved locally

🖥️ System Requirements

Minimum

OS: Windows 10 (1903+), Linux (GTK3), macOS (10.15+)
CPU: 64-bit processor, 1 GHz or faster
RAM: 512 MB available memory
Storage: 100 MB free space
.NET: .NET 10 Runtime (automatically installed)

📥 Installation

Windows

Download the latest release from Releases
Extract the ZIP archive
Run Yellowcake.exe
On first launch, set your Nuclear Option game path

Linux

wget https://github.com/NaghDiefallah/Yellowcake/releases/latest/download/Yellowcake-linux-x64.tar.gz
wget https://github.com/NaghDiefallah/Yellowcake/releases/latest/download/Yellowcake-linux-x64.tar.gz.sha256
sha256sum -c Yellowcake-linux-x64.tar.gz.sha256
tar -xzf Yellowcake-linux-x64.tar.gz
chmod +x Yellowcake
./Yellowcake

macOS

curl -L https://github.com/NaghDiefallah/Yellowcake/releases/latest/download/Yellowcake-osx-x64.tar.gz -o Yellowcake-osx-x64.tar.gz
curl -L https://github.com/NaghDiefallah/Yellowcake/releases/latest/download/Yellowcake-osx-x64.tar.gz.sha256 -o Yellowcake-osx-x64.tar.gz.sha256
shasum -a 256 -c Yellowcake-osx-x64.tar.gz.sha256
tar -xzf Yellowcake-osx-x64.tar.gz
chmod +x Yellowcake
./Yellowcake

Verify Downloads (All Platforms)

Every release now includes .sha256 checksum files and a release-manifest.json asset.

Compare your downloaded artifact hash with the matching .sha256 file before running binaries.
Use release-manifest.json for automated verification workflows.

🚀 Quick Start

Launch Yellowcake - The app will auto-detect your game installation
Install BepInEx - Click "SETUP ENGINE" to install the modding framework
Browse Mods - Navigate to the Browse tab to see available mods
Install a Mod - Click on any mod and press "Install"
Launch Game - Use the "Launch Game" button to start Nuclear Option with mods

🎯 Usage Guide

Installing Mods

From Repository:

Open the Browse tab
Search or filter for the mod you want
Click the mod to view details
Click Install button
Wait for download and installation

From Local File:

Open Settings
Click Install from ZIP or Install DLL
Select your mod file
Mod is automatically installed

Managing Installed Mods

Enable/Disable:

Click the checkbox next to any installed mod
Disabled mods remain installed but inactive

Update:

Mods with updates show a green "Update Available" badge
Click the update button to install the latest version

Uninstall:

Right-click a mod and select "Uninstall"
Or use the trash icon in the mod details

BepInEx Management

Install:

Open Settings
Select a BepInEx version from dropdown
Click INSTALL

Uninstall:

Click "Uninstall BepInEx" in Settings
Confirm the removal

Performance Monitoring

View Statistics:

Press Ctrl+P or click the stats icon
View download metrics, speeds, and history
Export data as CSV for analysis

Clear History:

Click "Clear History" to reset all performance data

⌨️ Keyboard Shortcuts

Shortcut	Action
`F1`	Show hotkeys guide
`F5`	Refresh mod list
`Ctrl+F`	Focus search box
`Ctrl+,`	Open settings
`Ctrl+L`	Open log viewer
`Ctrl+P`	Performance dashboard
`Ctrl+B`	Toggle batch mode
`Ctrl+A`	Select all (batch mode)
`Ctrl+Shift+D`	Diagnostics window
`Escape`	Close overlays

🎨 Themes

Yellowcake includes multiple themes:

Dark (Default) - Modern dark theme
Light - Clean light theme
Synthium - Gree accent theme made for

Custom Themes:

Navigate to %AppData%/Yellowcake/Themes (Windows)
Create a new .axaml theme file
Reload themes in Settings
Select your custom theme

🔧 Configuration

Settings Location

Windows: %LocalAppData%\Yellowcake\
Linux: ~/.local/share/Yellowcake/
macOS: ~/Library/Application Support/Yellowcake/

Configuration Files

data.db - Local database (mods, settings, performance)
cache/ - Thumbnail and manifest cache
logs/ - Application logs
themes/ - Custom theme files

🛠️ Development

Prerequisites

.NET 10 SDK
Visual Studio 2022+ or JetBrains Rider
Git

Building from Source

git clone https://github.com/NaghDiefallah/Yellowcake.git
cd Yellowcake
dotnet restore
dotnet build
dotnet run

Key Dependencies

Avalonia UI 11.0+ - Cross-platform UI framework
CommunityToolkit.Mvvm 8.4+ - MVVM helpers
LiteDB 5.0+ - Embedded database
Serilog 4.0+ - Logging framework
Octokit 13.0+ - GitHub API client
SharpCompress 0.37+ - Archive extraction

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Fork the repository
Create your feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

Nuclear Option - The game this mod manager is built for
BepInEx Team - For the modding framework
Avalonia Team - For the amazing UI framework
Community Contributors - For mod submissions and testing

📞 Support

Issues: GitHub Issues
Discussions: GitHub Discussions

📊 Statistics

Made with ❤️ by NaghDiefallah

⬆ Back to Top

Name		Name	Last commit message	Last commit date
Latest commit History 38 Commits
.github/workflows		.github/workflows
Converters		Converters
Helpers		Helpers
Manifests		Manifests
Models		Models
Mods		Mods
Properties/PublishProfiles		Properties/PublishProfiles
Resources		Resources
Services		Services
Styles		Styles
Themes		Themes
ViewModels		ViewModels
Views		Views
Yellowcake.Tests		Yellowcake.Tests
.gitattributes		.gitattributes
.gitignore		.gitignore
App.axaml		App.axaml
App.axaml.cs		App.axaml.cs
FodyWeavers.xml		FodyWeavers.xml
FodyWeavers.xsd		FodyWeavers.xsd
LICENSE		LICENSE
Program.cs		Program.cs
README.md		README.md
Yellowcake.csproj		Yellowcake.csproj
Yellowcake.slnx		Yellowcake.slnx
app.manifest		app.manifest

Folders and files

Latest commit

History

Repository files navigation