GalCiv IV Mod Editor
====================
A visual mod editor for Galactic Civilizations IV.
Adjust 6,800+ gameplay values with sliders and the mod is saved automatically.

WHAT IT DOES
------------
- Opens a local web page in your browser with sliders for every
  editable gameplay value (difficulty, techs, factions, ships, etc.)
- Changes auto-save instantly as a mod in your GalCiv4 Mods folder
- Only saves the values you changed (compatible with other mods)
- Export your mod as a .zip to share with others

REQUIREMENTS
------------
- Windows 10/11
- Python 3.10 or newer (https://www.python.org/downloads/)
  IMPORTANT: Check "Add Python to PATH" during Python install!
- Galactic Civilizations IV (Steam)

HOW TO USE
----------
1. Install Python from https://www.python.org/downloads/
   - On the first install screen, CHECK the box "Add Python to PATH"
2. Double-click run.bat
   - First time: it will install Flask automatically
   - Your browser opens to http://localhost:5000
3. Use the sidebar to pick a category (Difficulty, Techs, Factions, etc.)
4. Drag sliders or type values to change anything
5. Changes auto-save to: Documents\My Games\GalCiv4\Mods\GalCiv4ModEditor_Output\
6. Launch GalCiv IV and enable the "GalCiv4ModEditor_Output" mod
7. To share your mod: click "Export Mod (.zip)" in the top bar

SHARING YOUR MOD
----------------
Click "Export Mod (.zip)" to download your changes as a zip file.
Other players just need to:
1. Extract the zip into: Documents\My Games\GalCiv4\Mods\
2. Enable the mod in GalCiv IV

They do NOT need Python or this editor - the zip is a normal GalCiv4 mod.

CATEGORIES (18 total, 6,810 fields)
------------------------------------
- Difficulty & AI    - AI bonuses per difficulty level
- Factions           - Starting credits, population, AI weights for all 69 factions
- Technologies       - Research costs for 520 techs
- Ship Components    - Weapon/module costs and stats for 291 components
- Improvements       - Colony building costs for 337 improvements
- Starbase Modules   - 139 starbase module stats
- Racial Abilities   - Ability modifier values
- Ideology Traits    - 73 ideology bonuses
- Policies           - Government policy effects
- Battle Mechanics   - Weapon cooldowns, ranges, durations
- Global Settings    - Rush cost, tech inflation, production multipliers
- Game Pacing        - Speed multipliers
- Race Traits        - Trait bonus values
- Ship Hulls         - Hull class base stats
- Trade & Economy    - Trade route income settings
- Diplomacy          - Relation effects and AI weights
- Status Effects     - Rebellion penalties, etc.
- Espionage          - Espionage thresholds

CUSTOM GAME DIRECTORY
---------------------
If your game is not in the default Steam location, set the
environment variable GALCIV4_DIR before running:

  set GALCIV4_DIR=D:\Games\Galactic Civilizations IV
  python app.py

TROUBLESHOOTING
---------------
- "Python is not installed" -> Download from python.org, check "Add to PATH"
- Browser doesn't open -> Go to http://localhost:5000 manually
- "Module not found" -> Run: pip install flask
- Wrong game path -> Set GALCIV4_DIR environment variable (see above)
