# Enhanced Romance for Mount & Blade II: Bannerlord

**A comprehensive romance and relationship expansion mod for Mount & Blade II: Bannerlord**

## Features

### Romance & Intimacy System
- **Party Romance Events**: Romantic encounters while traveling with your spouse
  - Starlight conversations under the night sky
  - River encounters during rest stops
  - Forest moments away from the group
  - Morning intimacy in camp
  - Scout missions together
  - Post-battle passion
  - Night watch encounters
  - Travel bonding

### Cuckold/Hotwife Content
- **Story System**: Your spouse can share intimate stories from their encounters
  - Tavern meetings
  - Market guard encounters
  - Festival nobles
  - Bathhouse encounters
  - Tournament champions
  - Castle feast lords

- **Party Events**: Encounters during travels
  - Camp stories
  - Travel encounters
  - Night watch events
  - River moments
  - Scout missions
  - Post-ambush passion

### Customization
- **Intensity Levels**: Choose your preferred content level
  - Kibar (Polite/Romantic): Sweet and romantic
  - Sert (Explicit): More detailed intimate content
  - Aşağılayıcı (Humiliating): Extreme humiliation content

### Additional Features
- **MCM Integration**: Full mod configuration menu
- **Multi-language Support**: English and Turkish
- **Image System**: Custom scene images (optional)
- **Relationship Tracking**: Detailed relationship progression
- **Pregnancy System**: External pregnancy mechanics
- **Partner Tracking**: Remember past encounters

## Requirements

- Mount & Blade II: Bannerlord v1.2.0 or higher
- **Harmony** (included)
- **ButterLib** (included)
- **MCM v5** (Mod Configuration Menu) - **REQUIRED**

## Installation

1. Extract the mod archive
2. Copy the `EnhancedRomance` folder to your Bannerlord `Modules` directory:
   - Default: `C:\Program Files (x86)\Steam\steamapps\common\Mount & Blade II Bannerlord\Modules\`
3. Launch the game
4. Enable the mod in the launcher (make sure it loads AFTER Harmony, ButterLib, and MCM)
5. Configure settings in Mod Options menu

## Load Order (IMPORTANT!)

```
1. Harmony
2. ButterLib
3. Mod Configuration Menu v5
4. Enhanced Romance
5. [Other mods]
```

## Configuration

Access mod settings through the game's **Mod Options** menu:

### General Settings
- Enable/Disable mod features
- Change language (Auto/English/Turkish)
- Debug options

### Content Settings
- Enable/Disable cuckold content
- Story frequency (days between events)
- Maximum stories per month
- Intensity level (Kibar/Sert/Aşağılayıcı)

### Pregnancy
- Enable/Disable external pregnancy
- Pregnancy chance percentage
- Pregnancy notifications

### Party Events
- Enable/Disable party romance events
- Enable/Disable party cuckold events
- Show/Hide story images
- Notification settings

## How to Use

### Starting Romance Events

**With spouse in settlement:**
1. Talk to your spouse in a settlement
2. Select "Do you have something to tell me?"
3. Listen to their story and respond

**With spouse in party (while traveling):**
1. Make sure your spouse is in your party
2. Talk to them while NOT in a settlement (on the road/wilderness)
3. Select "Tell me about our journey together, my love..."
4. Enjoy romantic moments together

### Persuading Your Spouse (Cuckold Content)

1. Talk to your spouse in a settlement
2. Select persuasion option
3. Complete persuasion checks (requires high relationship)
4. Once persuaded, stories will become available

## Adding Custom Images (Optional)

See `HOW_TO_ADD_IMAGES.md` for detailed instructions on adding custom scene images.

## Troubleshooting

**Dialog options not appearing:**
- Make sure you meet the requirements (married, high relationship, persuaded for cuckold content)
- Check that party events are enabled in Mod Options
- For party events, make sure spouse is in your party AND you're not in a settlement

**Stories are empty/blank:**
- Update to the latest version
- Make sure language files are properly installed
- Check Mod Options → Debug → Enable Debug Mode and check game logs

**Images not showing:**
- Images are optional and must be added manually
- See HOW_TO_ADD_IMAGES.md for setup instructions
- Make sure sprite sheets are generated

## Compatibility

- **Compatible** with most gameplay mods
- **May conflict** with other romance/relationship mods
- Uses Harmony patches for compatibility

## Known Issues

- None currently reported

## Credits

- **Developer**: [Your Name]
- **Localization**: English, Turkish
- **Special Thanks**: Mount & Blade II: Bannerlord Modding Community

## Support & Updates

- **LoversLab**: [Your mod page link]
- **Nexus Mods**: [If you upload there]
- **Discord**: [If you have one]

## Changelog

### Version 1.0.0
- Initial release
- Party romance system
- Cuckold/hotwife story system
- Party travel events
- MCM integration
- English and Turkish localization
- Custom image support

## License

This mod is free to use and modify for personal use. Please credit if you use any code or assets.

---

**Adult Content Warning**: This mod contains mature sexual content and is intended for adults only (18+).
