Anno 117 Mod Manager v1.0

Simple, powerful mod manager for Anno 117: Pax Romana with full mod.io integration.

Features

• ✅ Simple Mode - Toggle to hide advanced features for beginners
• ✅ Browse & install all available mods from mod.io (pagination loads everything)
• ✅ Enable All / Disable All - Bulk operations for quick mod management
• ✅ Load order control (drag-and-drop)
• ✅ Auto-Fix Load Order - Smart conflict resolution based on mod overlap analysis
• ✅ Conflict detection with severity analysis (Critical/Moderate/Minor)
• ✅ Mod profiles for different setups (auto-loads last used profile)
• ✅ Backup & restore your configuration
• ✅ Bulk Collection Install - Download entire collections with one click
• ✅ Enable/disable mods without uninstalling
• ✅ Smart Backup Prompts - Optional backup before installs with "don't ask again"
• ✅ Keyboard shortcuts for fast workflow

Quick Start

Requirements

• Python 3.8+
• mod.io API key (Get free here)

Installation

Windows: Double-click run_mod_manager.bat

macOS/Linux:

chmod +x run_mod_manager.sh
./run_mod_manager.sh

Manual:

pip install -r requirements.txt
python anno117_mod_manager.py

Getting Your API Key

1. Go to mod.io and sign in
2. Click your profile → "API Access"
3. Copy your API key (NOT OAuth token)
4. Paste when the app asks on first launch

See API_KEY_GUIDE.html for step-by-step visual guide.

Usage

New users: Check "Simple Mode" for a cleaner interface!

• Install mod: Select mod → "Download & Install"
• Enable/Disable: Toggle button or press Space
• Simple Mode: Check the box to hide advanced features
• Load Order: Click "Load Order" → drag mods up/down (Advanced)
• Check Conflicts: Click "Conflicts" button (Advanced)
• Create Backup: Press Ctrl+B or click "Backup" (Advanced)
• Search: Press Ctrl+F or use search box
• Refresh: Press F5

Keyboard Shortcuts

Ctrl+F   - Focus search
F5       - Refresh mod list
Ctrl+B   - Open backup manager
Enter    - Install selected mod
Delete   - Uninstall selected mod
Space    - Toggle enable/disable
Esc      - Clear search / Close dialogs

Troubleshooting

"Network Error" → Check internet connection and mod.io access

"Permission Denied" → Run as administrator or check folder permissions

Mods not in game → Verify mod is enabled (not disabled)

Can't update mod → Press F5 to refresh, check if mod still exists on mod.io

File Locations

Windows:

• Mods: Documents\Anno 117 - Pax Romana\mods\
• Backups: Documents\Anno 117 - Pax Romana\mod_backups\

macOS/Linux:

• Mods: ~/Documents/Anno 117 - Pax Romana/mods/
• Backups: ~/Documents/Anno 117 - Pax Romana/mod_backups/

Features Explained

Load Order: Higher mods load first. If two mods modify the same file, the lower mod wins.

Conflict Detection: Scans for overlapping files, categorizes as Critical/Moderate/Minor.

Profiles: Save different mod setups, switch instantly.

Smart Caching: Loads all mods once, caches for 10 minutes. Minimal API usage.

Contributing

Issues and pull requests welcome! See CONTRIBUTING.md for guidelines.

License

MIT License - Free to use, modify, distribute.

Credits

• Built for the Anno 117 community
• Powered by mod.io API
• Made with ❤️ using Python & tkinter

---

⭐ Star this repo if it's useful!