Rome2 Mod Manager Mac

Rome2 Mod Manager Mac is a native macOS MOD manager purpose-built for Total War: ROME II.

Crafted with SwiftUI and seamlessly adapted to macOS design conventions, it lets you manage your Steam Workshop MODs effortlessly: scan, enable/disable, reorder, rename, and launch the game — all from one elegant interface.

Core

• 🔍 Auto Scan — Automatically detects Steam Workshop directory and scans all .pack MOD files
  
• ✅ One-Click Enable — Check/uncheck to enable or disable MODs instantly
  
• 📝 Auto-Generate Script — Automatically writes user.script.txt based on your selection — no manual editing
  
• 🚀 Launch Game — Built-in one-click game launcher, automatically saves script before launching
  
• ↔️ Drag & Drop Sort — Drag MODs to adjust load order (top loads first)
  
• ✏️ Custom Rename — Double-click any MOD to rename it; names persist across restarts
  
• 🖼️ Preview Thumbnails — Auto-scans MOD folders for preview images, visible during rename too

Advanced

• 🌐 Bilingual UI — Supports Chinese / English, or auto-follow system language
  
• ⚙️ Custom Paths — Customizable Workshop directory, user.script.txt path, and Rome2.app path
  
• 🩺 Diagnostics — Built-in path diagnostics to quickly troubleshoot "MOD not found" or "cannot write script" issues
  
• 💾 Data Persistence — Enabled list, load order, and custom names are all persisted via UserDefaults — survive restarts
  
• 🔔 Toast Notifications — Real-time feedback for all operations

Grab the latest .app from the Releases page and drag it into /Applications.

https://github.com/sundaylee91/Rome2ModManagerMac/releases

Typical Workflow:

1. Launch App → Auto-scans Workshop MODs
2. Check desired MODs → Drag to adjust order
3. Click a MOD to see its preview thumbnail
4. Double-click the pencil icon → Rename to something readable
5. Press ⌘Enter → Auto-writes script & launches game ✅

Renaming MODs:

• How: Select a MOD → click the pencil icon (or double-click the row)
  
• Effect: Only changes the display name in the manager; .pack files are untouched
  
• Persistence: Names survive app restarts, system reboots — permanently saved
  
• Reset: Settings panel → Reset Defaults → Clear all custom names

Settings Panel:

• Click the ⚙️ toolbar icon to open settings:
  
• UI Language: Chinese / English / Auto
  
• Game Path: Custom Rome2.app location (auto-detects Steam install by default)
  
• Workshop Directory: Custom MOD scan directory
  
• user.script.txt Path: Custom script output location
  
• Diagnostics: Check path statuses for quick troubleshooting

This project is open-sourced under the MIT License.

Copyright © 2026 Sunday Lee

• Total War: ROME II — Creative Assembly
  
• Steam Workshop platform
  
• SwiftUI & AppKit community
  
• DeepSeek V4 Pro — AI assistance
  
• Google NanoBanana 2 — AI assistance