====================================
ENHANCED ROMANCE MOD - LOVERSLAB VERSION
====================================

VERSION: 1.0
BUILD DATE: 2025-10-30
COMPATIBLE WITH: Mount & Blade II: Bannerlord v1.2.x+

====================================
INSTALLATION INSTRUCTIONS:
====================================

1. Extract this folder to your Bannerlord Modules directory:
   Example: C:\Program Files\Steam\steamapps\common\Mount & Blade II Bannerlord\Modules\

2. Your folder structure should look like:
   Modules\
     EnhancedRomance\
       bin\
       GUI\
       ModuleData\
       SubModule.xml
       etc...

3. Launch the game and enable "Enhanced Romance" in the Mods menu

====================================
FEATURES:
====================================

✅ Cuckold/Wife Sharing System
✅ Spouse Capture Events with Rape Mechanics
✅ Post-Capture Storytelling (Dynamic dialog system)
✅ Player Rape Mechanics (Solo & Gang rape against prisoners)
✅ Prisoner Interaction System (Taunt/Humiliate or Show Kindness)
✅ External Pregnancy System
✅ NPC Affair System
✅ Jealous Husband Mechanics
✅ Gossip System
✅ Image Display System (Windows Photo Viewer integration)
✅ Full MCM (Mod Configuration Menu) Support
✅ Turkish & English Localization

====================================
IMAGE SYSTEM:
====================================

The mod includes an image display system that opens PNG files using Windows Photo Viewer.

Image Location: GUI\SpriteParts\ui_erscenes\

Included Images:
- solo_1.png to solo_4.png (Solo rape scenes)
- gang_1.png to gang_5.png (Gang rape scenes)
- romance_1.png to romance_3.png (Romance scenes)
- wife_capture_1.png to wife_capture_4.png (Capture scenes)
- party_*.png (Party event scenes)
- story_*.png (Story event scenes)

You can add your own images to this folder. Follow the naming convention:
- solo_*.png for solo rape scenes
- gang_*.png for gang rape scenes
- Any other name for general romance/story scenes

====================================
MCM SETTINGS:
====================================

Access the MCM menu (Mod Options) to configure:
- Enable/Disable specific features
- Adjust difficulty and frequency
- Control image display
- Set notification levels
- Customize relationship penalties/bonuses

====================================
REQUIREMENTS:
====================================

REQUIRED:
- Mount & Blade II: Bannerlord (v1.2.0 or newer)
- Harmony (usually included with game)
- ButterLib (v2.0+)
- UIExtenderEx (v2.0+)
- MCM v5 (Mod Configuration Menu)

OPTIONAL BUT RECOMMENDED:
- Newtonsoft.Json (for save data serialization)

====================================
TROUBLESHOOTING:
====================================

Images not opening:
1. Check MCM → "Show Rape Images" is enabled
2. Check Image Display Method is NOT set to "Disabled"
3. Verify PNG files exist in GUI\SpriteParts\ui_erscenes\
4. Check game logs for "[Enhanced Romance] Romance Images: X loaded"

Dialogs not appearing:
1. Verify MCM settings are enabled for the feature
2. Check relationship requirements
3. Ensure you're talking to the correct character (spouse/prisoner)

Story loops/freezes:
1. Choose "That's enough for now" to exit story dialogs
2. If stuck, restart the conversation

====================================
KNOWN ISSUES:
====================================

- None currently reported

====================================
CREDITS:
====================================

Developed by: [Your Name]
Special Thanks to:
- LoversLab Community
- Bannerlord Modding Discord
- Mount & Blade II Modding Community

====================================
SUPPORT & UPDATES:
====================================

For support, bug reports, or feature requests:
- Visit the LoversLab thread
- Check for updates regularly

====================================
LICENSE:
====================================

This mod is provided as-is for adult entertainment purposes.
Not for redistribution without permission.
Adults only (18+).

====================================
