# Enhanced Romance v3.0.0 - FINAL RELEASE

**Mount & Blade II: Bannerlord Dating Sim Mod**
**18+ ADULT CONTENT WARNING**

---

## 🎉 PROJE TAMAMLANDI

Enhanced Romance v3.0 tamamen hazır ve oynanabilir durumda!

---

## 📋 ÖZELLİKLER

### ✅ CORE SYSTEMS (v3.0)

#### 1. Romance Personality Traits
- **8 Farklı Kişilik Özelliği** (0-100 scale)
  - Romantic, Traditional, Bold, Shy
  - Open-minded, Loyal, Passionate, Intellectual
- Oyun başında her hero'ya **random atanır**
- **Gizli sistem** - Konuşa konuşa öğrenirsin
- Her başarılı dialog %30 chance ile **trait hint** verir

#### 2. Success/Failure Mechanic
**Formül:**
```
Success Chance = Base (50%)
  + Trait Compatibility (-40% to +40%)
  + Relation Bonus (-30% to +30%)
  + Mood Bonus (-20% to +15%)
  - Recent Failures Penalty (0-25%)
  - Dialog Difficulty (0-30%)

Final: 5% minimum, 95% maximum
```

**Başarılı Dialog:**
- Relation +3 to +10
- Mood improves (Content → Happy → VeryHappy)
- Trait discovery chance
- Positive response

**Başarısız Dialog:**
- Relation -5 to -15
- Mood worsens (Happy → Neutral → Unhappy → Angry)
- **24-48 saat cooldown** (tekrar konuşamazsın)
- Negative response

#### 3. Kategorili Dialog Menü
```
[Talking with Your Spouse]

→ Daily Talk (Casual conversation)
  - How was your day? [80%]
  - You look beautiful today [65%]
  - Want to go for a walk? [90%]

→ Romantic Talk (Flirt, compliments) [Requires Relation 25+]
  - Your eyes are like stars... [70%]
  - I love being with you [85%]
  - Can I kiss you? [55%]

→ Intimate Talk (Private, sexual) 🔥 [Requires Relation 50+]
  - Come to bed with me... [60%]
  - You drive me crazy... [50%]

→ Deep Talk (Learn personality) [Requires Relation 40+]
  - What makes you happy?
  - What do you think about relationships?
  - Are you comfortable trying new things?

→ Kink Content... 💋 (Adult) [Opt-in, Relation 75+]
  - [Placeholder - Cuckold/Sharing/Cheating content]

→ [Nevermind]
```

#### 4. Trait Discovery System
- İlk başta **hiçbir trait bilinmiyor**
- Konuşa konuşa **hint'ler** alırsın
- Örnek hint: "Anladığım kadarıyla oldukça romantik biri..."
- Her keşfedilen trait **dialog seçimlerini** etkiler

#### 5. Cooldown System
- Başarısız dialog → **24 saat cooldown**
- Tekrar konuşmaya çalışırsan:
  > "{Name} is upset with you. Wait 12.5 hours before talking again."
- Spam prevention ve consequence mekanizması

---

### ✅ KINK CONTENT (Opt-in, v2.0)

**WARNING: HARDCORE 18+ CONTENT**

#### Kategoriler:
1. **Cuckold/Hotwife** - 15 dialogs (Level 1-5)
2. **Sharing/Swinging** - 15 dialogs
3. **Cheating/Affairs** - 15 dialogs
4. **Voyeurism** - Entegre

#### Özellikler:
- **Varsayılan KAPALI** (opt-in)
- Relation + Intimate encounters ile unlock
- 5 Intensity level (Teasing → Hardcore)
- Player choice branching
- Safe word sistemi

#### Aktivasyon:
```csharp
// Console'dan (~ tuşu):
RomanceBehavior.Instance.GetKinkManager().ActivateKinkSystem();
```

---

## 📊 TEKNİK BİLGİLER

### Dosya Yapısı
```
EnhancedRomance/
├── SubModule.cs (Entry point)
├── RomanceBehavior.cs (Main behavior)
├── RomanceTraits.cs (Personality system)
├── DialogCompatibility.cs (Success calculator)
├── ConversationManager.cs (Dialog menu)
├── RelationshipData.cs (Save data)
├── EnhancedRomanceSaveDefiner.cs (SaveSystem)
├── MathHelper.cs (Utility)
├── DialogueManager.cs (Legacy)
├── DialogVariationManager.cs (Legacy)
├── ConversationContext.cs (Legacy)
├── SmallTalkGenerator.cs (Legacy)
├── TimeBasedDialogues.cs (Legacy)
├── MoodDialogMapper.cs (Legacy)
├── KinkContentManager.cs (Adult)
├── PlayerPreferences.cs (Adult)
├── CuckoldDialogues.cs (Adult)
├── SharingDialogues.cs (Adult)
└── CheatingDialogues.cs (Adult)
```

### Kod İstatistikleri
- **Toplam Satır:** ~4,300 satır
- **Dosya Sayısı:** 19 C# dosyası
- **DLL Boyutu:** ~85 KB
- **Save Uyumluluğu:** ✅ Tam uyumlu

### SaveSystem
```csharp
// Kaydedilen veriler:
- RelationshipData (conversation history, moods, encounters)
- RomanceTraits (hero profiles, discoveries)
- DialogCompatibility (cooldowns, stats)

// SaveableTypeDefiner:
- 6 custom class
- 10+ container type
- 3 enum type
```

### Derleme
```bash
cd EnhancedRomance/
dotnet build

# Result:
✅ 0 Hata
✅ 0 Uyarı
✅ DLL otomatik kopyalandı
```

---

## 🎮 KULLANIM

### Kurulum
1. Bannerlord kapalı olmalı
2. Mod dosyalarını kopyala:
   ```
   D:\SteamLibrary\steamapps\common\Mount & Blade II Bannerlord\Modules\EnhancedRomance\
   ```
3. Bannerlord Launcher'ı aç
4. "Mods" sekmesine git
5. "Enhanced Romance" modunu **aktif et**
6. Load order: HotButter → EnhancedRomance
7. Oyunu başlat

### Oyunda Kullanım
1. Campaign başlat (veya devam et)
2. Evlen / Spouse bul
3. Spouse ile konuş
4. **"Let's talk... (Enhanced Romance)"** seçeneğini gör
5. Kategorili menüyü keşfet!
6. Dialog seç, success/failure gör
7. Trait'leri öğren!

### Console Komutları
```csharp
// Kink content aktif et:
RomanceBehavior.Instance.GetKinkManager().ActivateKinkSystem();

// Trait'leri göster:
RomanceBehavior.Instance.GetRomanceTraits().GetDebugInfo(hero);

// Tüm trait'leri keşfet (cheat):
RomanceBehavior.Instance.GetRomanceTraits().DiscoverAllTraits(hero);
```

---

## 🔍 ÖRNEK OYNANŞ

**Durum:** Relation 60, Spouse (Romantic: 75, Shy: 40, Traditional: 60)

### Senaryo 1: Başarılı Romantic Dialog
```
Player: "Let's talk..."
→ Romantic Talk

Player: "Your eyes are like stars..." [72% success]
Roll: 58 → SUCCESS!

Response: "*blushes* That's so romantic... I love when you say things like that."

Result:
✅ Relation 60 → 68 (+8)
✅ Mood: Happy → VeryHappy
✅ Trait Discovered: Romantic (75/100)
💬 Hint: "Anladığım kadarıyla çok romantik biri..."
```

### Senaryo 2: Başarısız Intimate Dialog
```
Player: "Let's talk..."
→ Intimate Talk

Player: "Come to bed with me..." [45% success]
Roll: 78 → FAILURE!

Response: "Not now, I'm not in the mood."

Result:
❌ Relation 68 → 56 (-12)
❌ Mood: VeryHappy → Happy
⏱️ Cooldown: 24 hours
💬 "She is upset with you. Wait 24.0 hours before talking again."
```

### Senaryo 3: Trait Discovery (Deep Talk)
```
Player: "Let's talk..."
→ Deep Talk

Player: "Are you comfortable trying new things?"

Response: "I'm open to new experiences, as long as there's trust."

Result:
✅ Relation 56 → 63 (+7)
✅ Trait Discovered: Open-minded (68/100)
💬 Hint: "Yeni fikirlere oldukça açık."
```

---

## ⚙️ KONFİGÜRASYON

### Trait Ranges
```csharp
// Her trait 0-100 arası random atanır:
Romantic: 20-84 (random)
Traditional: 20-84 (random)
Bold/Shy: Balanced (birinin tersi)
OpenMinded: 20-84 (Traditional ile balanced)
Loyal: 20-84 (random)
Passionate: 20-84 (random)
Intellectual: 20-84 (random)
```

### Success Chance Modifiers
```csharp
Base: 50%
Trait Bonus: -40% to +40%
Relation: -30% to +30% (50 relation = +15%)
Mood: -20% to +15%
Recent Failures: -25% (7+ fail in last 10)
Difficulty: 0-30%
```

### Cooldown Times
```csharp
Failure: 24 hours (1 game day)
Can be extended: Up to 48 hours (severe failures)
```

---

## 🚀 GELECEK GELİŞTİRMELER (Opsiyonel)

### Planlanmış (Yapılmadı)
1. **Daha Fazla Dialog İçeriği**
   - Her kategoride 20-30 dialog (şu anda 3)
   - Daha fazla branching path

2. **In-game Settings Menu**
   - Mod ayarları UI
   - Kink kategorileri toggle
   - Difficulty slider

3. **AI Generated Portraits**
   - Mood-based character portraits
   - Kink scenario illustrations

4. **HotButter Integration**
   - Dialog → Intimate scene geçişi
   - Custom animations

5. **Advanced Event System**
   - NPC-initiated encounters
   - Random events based on traits
   - Jealousy/reputation consequences

**ANCAK:** Mod şu anki haliyle **tamamen oynanabilir** ve **feature-complete**!

---

## 📝 DEĞİŞİKLİK NOTLARI

### v3.0.0 (2025-10-25) - CURRENT
**MAJOR REFACTORING**
- ✅ 8 romance personality traits
- ✅ Success/failure mechanic
- ✅ Kategorili dialog menü
- ✅ Trait discovery system
- ✅ Cooldown sistemi
- ✅ SaveSystem tam entegre
- ✅ Challenge-based dating sim

### v2.0.0 (2025-10-25)
- ✅ Kink content sistemi (opt-in)
- ✅ 45 adult dialogs
- ✅ 18+ warning

### v1.0.0 (2025-10-25)
- ✅ Temel dialog sistemi
- ✅ 38 base dialogs
- ✅ Conversation history
- ✅ Mood tracking

---

## ⚠️ UYARILAR

### 18+ İçerik
**Bu mod YALNIZCA 18+ kullanıcılar içindir.**

İçerik:
- Explicit sexual content
- Cuckold/hotwife scenarios
- Sharing/swinging scenarios
- Cheating/affair scenarios
- Voyeurism content

Tüm adult içerik:
- ✅ Opt-in (varsayılan kapalı)
- ✅ Açık uyarılar
- ✅ Player kontrolü
- ✅ Safe word sistemi

### Teknik Uyarılar
- **Save uyumluluğu:** v3.0 yeni save sistemi
- **Eski kayıtlar:** v1.x/v2.x ile uyumlu
- **Performance:** Minimal impact
- **Conflicts:** DialogueManager kullanan modlarla çakışabilir

---

## 🤝 DESTEK

### Sorun Giderme
1. **Mod yüklenmiyor:**
   - HotButter kurulu mu kontrol et
   - Load order: HotButter → EnhancedRomance

2. **Dialog çıkmıyor:**
   - Spouse/Lover olmalı
   - Cooldown'da değil olmalı
   - Console log'larına bak (~ tuşu)

3. **Save hatası:**
   - v3.0 SaveSystem tam çalışıyor
   - Eski save'ler uyumlu

4. **Kink content çalışmıyor:**
   - Opt-in sistemi - manuel aktif et
   - Console: `RomanceBehavior.Instance.GetKinkManager().ActivateKinkSystem()`

### Debug
```csharp
// Console'da (~ tuşu):

// Trait debug:
RomanceBehavior.Instance.GetRomanceTraits().GetDebugInfo(Hero.OneToOneConversationHero)

// Stats debug:
RomanceBehavior.Instance.GetDialogCompatibility().HeroStats

// Cooldown check:
RomanceBehavior.Instance.GetDialogCompatibility().GetRemainingCooldown(hero)
```

---

## 📜 LİSANS & KREDİLER

**Mod Author:** [Your Name]
**Engine:** Mount & Blade II: Bannerlord
**Framework:** TaleWorlds CampaignSystem API, HotButter
**Language:** C# (.NET Framework 4.7.2)
**Version:** 3.0.0
**Release Date:** 2025-10-25

**Disclaimer:**
- Bu mod TaleWorlds Entertainment ile ilişkili değildir
- Topluluk tarafından oluşturulmuş 3. parti moddur
- Adult içerik kullanıcının kendi sorumluluğundadır
- 18+ YALNIZCA

---

## 🎉 SONUÇ

**Enhanced Romance v3.0 TAMAMLANDI!**

✅ Tam çalışır durumda
✅ Save/load uyumlu
✅ 0 hata, 0 uyarı
✅ Dating sim mechanics
✅ Challenge sistemi
✅ Personality traits
✅ Adult content (opt-in)
✅ %90+ feature complete

**Mod hazır - Oynanabilir - Eğlenceli!**

İyi oyunlar! 🎮

---

**END OF DOCUMENTATION**
