r2modmac Description r2modmac is a native mod manager for macOS/Windows/Linux that allows you to easily manage mods for Thunderstore supported games and Outer Wilds (via OWML). Designed with a modern and intuitive interface, it offers a smooth experience to install, update, and organize your favorite mods. Features Multi-Game Support: Browse Thunderstore communities and manage mods for supported game loaders Outer…
r2modmac is a native mod manager for macOS/Windows/Linux that allows you to easily manage mods for Thunderstore supported games and Outer Wilds (via OWML). Designed with a modern and intuitive interface, it offers a smooth experience to install, update, and organize your favorite mods.
Features
Multi-Game Support: Browse Thunderstore communities and manage mods for supported game loaders
Outer Wilds Support: Full support for Outer Wilds mods via OWML — browse, install and launch directly from the app
Profile Management: Create and manage multiple profiles for different mod setups
Browse Mode: Explore and discover mods without creating a profile first
Import/Export: Share your profiles with friends via codes or files
Custom Profile Images: Add custom images to your profiles
Fast Search: Intelligent caching system for instant searches
Modern Interface: Clean and intuitive design optimized for macOS
Dependency Management: Automatic installation of required dependencies
Smart Install Modes:
New Mode (Default): Install adds mods to your profile list. Download only when you click “Apply to Game” (saves disk space)
Legacy Mode: Mods download immediately to a local cache when you click Install (faster but uses more storage)
📸 Screenshots
Game Selection
Profile Management
Browse Mods
Mod loader compatibility
These are the loaders currently handled by r2modmac. Other Thunderstore communities can still be browsed, but their mods may not install correctly.
Loader
Status
Notes
BepInEx
✅ Supported
Standard Thunderstore packages.
Lovely
✅ Supported
Balatro mods and runtime.
ReturnOfModding
✅ Supported
Risk of Rain Returns mods and runtime.
OWML
✅ Supported
Outer Wilds; separate from the standard Thunderstore flow.
MelonLoader
❌ Not supported
Loader-specific install and launch are not implemented.
Northstar
❌ Not supported
Titanfall 2/Northstar integration is not implemented.
GDWeave
❌ Not supported
WEBFISHING/GDWeave integration is not implemented.
Other custom loaders
❌ Not supported
Requires a dedicated integration.
If a loader is missing from this list, please open an issue before relying on it.
On Apple Silicon, BepInEx 5 games normally run under Rosetta even when the game itself is universal. tools/apple-silicon (experimental) lets them run natively with mods; macOS release builds set it up by themselves at launch.
🛠️ Technologies Used
Frontend
React 19 - Modern UI framework with the latest features
TypeScript - Type safety and better developer experience
Tailwind CSS - Utility-first styling for consistent design
Zustand - Lightweight and performant state management
Vite - Lightning fast build tool for development and production
Backend
Tauri 2 - Framework for native desktop applications using Rust
Rust - Safe and performant language for backend logic
Reqwest - HTTP client for communicating with Thunderstore API
Tokio - Asynchronous runtime for non-blocking operations
Serde - JSON serialization/deserialization
Key Libraries
@tanstack/react-virtual - List virtualization for optimal performance
adm-zip - ZIP archive management for mods
js-yaml - Profile configuration file parsing
regex - Pattern matching for parsing and validation
Enter your password when prompted, then try opening the app again.
🚀 Development
Prerequisites
Node.js 18+
Rust 1.77+
Xcode Command Line Tools
Setup
# Clone the repository
git clone https://github.com/Zard-Studios/r2modmac.git
cd r2modmac
# Install dependencies
npm install
# Start in development mode
npm run dev
# Build for production
npm run tauri build
r2modmac is and will always remain open-source. It has no analytics or telemetry, and it does not share personal data or application content. I dedicate all my free time to it as a student and independent developer. If this tool has saved you hours of configuration and headaches, please consider supporting its development with a micro donation!
评论