# 🖼️ Enhanced Romance - Görsel Ekleme Rehberi

Bu rehber, mod'a sahne görselleri nasıl ekleneceğini adım adım açıklar.

---

## 📁 1. Klasör Yapısı

Görseller şu klasöre konulmalıdır:
```
Mount & Blade II Bannerlord\
  └── Modules\
      └── EnhancedRomance\
          └── GUI\
              └── SpriteParts\
                  └── ui_erscenes\    ← BURADA GÖRSELLER!
                      ├── solo_1.png
                      ├── solo_2.png
                      ├── gang_1.png
                      ├── romance_1.png
                      └── ...
```

---

## 🎨 2. Görsel Gereksinimleri

### Format:
- **PNG** (önerilen - en iyi kalite)
- **JPG** (çalışır ama kalite düşer)

### Boyut:
- **Herhangi bir boyut olabilir!** (1024x768, 1024x685, 864x512, 1920x1080 vs.)
- **Landscape (yatay)**: 1024x768, 1280x720, 1920x1080 gibi
- **Portrait (dikey)**: 768x1024, 720x1280 gibi
- **Kare**: 1024x1024, 512x512 gibi

**NOT**: Görsel **aspect ratio'su korunur**, ekrana fit edilir. Siyah bantlarla tamamlanır.

### Minimum/Maksimum:
- **Minimum**: 512x512 (daha küçük pixelated görünür)
- **Maksimum**: 4096x4096 (performans için)
- **Önerilen**: 1024x768 veya 1920x1080

---

## 📝 3. İsimlendirme Kuralları

Dosya isimleri **prefix (ön ek)** ile başlamalı:

| Prefix | Açıklama | Örnek |
|--------|----------|-------|
| `solo_` | Tek tecavüz (player only) | `solo_1.png`, `solo_2.png` |
| `gang_` | Toplu tecavüz (player + soldiers) | `gang_1.png`, `gang_2.png` |
| `romance_` | **Karınla sevişme sahneleri** | `romance_1.png`, `romance_2.png` |
| `capture_` | Karının esir edilip tecavüz edilmesi | `capture_1.png`, `capture_2.png` |
| `story_tavern_` | Meyhane hikayesi | `story_tavern_1.png`, `story_tavern_2.png` |
| `story_market_` | Market hikayesi | `story_market_1.png` |
| `story_festival_` | Festival hikayesi | `story_festival_1.png` |

**YENİ! Romance (Sevişme) Sistemi**: Karınla normal sevişme sahneleri için `romance_` prefix'li görseller ekle!

**Örnekler**:
```
✅ solo_1.png          (çalışır)
✅ solo_2.png          (çalışır)
✅ gang_1.png          (çalışır)
✅ romance_scene_1.png (çalışır - "romance_" ile başlıyor)
❌ mysolo.png          (çalışmaz - prefix yok)
❌ 1_solo.png          (çalışmaz - prefix sonunda değil)
```

**NOT**: Numaralandırma serbest! `solo_1`, `solo_2`, `solo_100` hepsi çalışır.

---

## 🔧 4. Görselleri Ekleme (Adım Adım)

### **ADIM 1: Görselleri Kopyala**
```
Dosyalarını kopyala:
  mysolo1.png, mysolo2.png, mygang1.png

Klasöre yapıştır:
  EnhancedRomance\GUI\SpriteParts\ui_erscenes\

Yeniden adlandır:
  solo_1.png, solo_2.png, gang_1.png
```

### **ADIM 2: SpriteSheetGenerator Çalıştır**

1. **Klasöre git**:
   ```
   Mount & Blade II Bannerlord\bin\Win64_Shipping_wEditor\
   ```

2. **TaleWorlds.TwoDimension.SpriteSheetGenerator.exe** dosyasına çift tıkla

3. **Module seç**: Dropdown'dan `EnhancedRomance` seç

4. **Generate** butonuna bas

5. **Tamamlandı mesajı** gelene kadar bekle

**Sonuç**:
- `Assets/erscenes_1_tex.tpac` oluşturulur (compressed texture)
- `EnhancedRomance_SpriteData.xml` güncellenir

### **ADIM 3: Resource Browser (Oyun İçinde)**

1. **Oyunu başlat** (launcher'dan)

2. **Ana menüde** bekle

3. **Console aç**: `Alt + `` (Alt + Ters Apostrof)

4. **Komut yaz**:
   ```
   resource.show_resource_browser
   ```
   Enter'a bas

5. **Resource Browser** açılır

6. **Scan** butonuna bas (sol üstte)

7. **Import** butonuna bas

8. **Tamamlanana kadar bekle**

**Sonuç**: Görseller artık oyuna yüklendi!

---

## ✅ 5. Test Et

### **Test 1: Tecavüz Sahneleri**
1. **Kampanya başlat** veya devam et
2. **Bir tecavüz eventi tetikle**:
   - Esir aldığın bir kadınla konuş → "I want to... use you" seç
   - Solo veya gang rape seç
3. **Dialog açılır** → **"View Scene"** butonu görünmeli
4. **View Scene**'e tıkla → Görsel full screen açılmalı
5. **ESC veya Close** ile kapat

### **Test 2: Romance Sahneleri (Karınla Sevişme)** 🆕
1. **Settlement'ta karınla konuş**:
   - "Let's spend some time together..." seçeneği çıkmalı
   - Seç → Romance görseli açılır
2. **Hikaye sonrası**:
   - Karın hikaye anlattıktan sonra → "Tell me more..." seç
   - "Now it's our turn..." seçeneği çıkmalı
   - Seç → Romance görseli açılır
3. **Random event** (%5 şans/gün):
   - Oynarken rastgele "Your wife wants to be intimate tonight" mesajı gelir
   - "I want you too" seç → Romance görseli açılır

---

## 🐛 6. Sorun Giderme

### **Problem**: "View Scene" butonu görünmüyor
**Çözüm**:
- Görsellerin doğru isimlendirildiğinden emin ol (`solo_`, `gang_` vb.)
- SpriteSheetGenerator'ı çalıştırdın mı?
- Resource Browser'da Import yaptın mı?

### **Problem**: Görsel açılmıyor / siyah ekran
**Çözüm**:
- Console'da hata mesajı var mı? (Alt + `)
- `.tpac` dosyası `Assets/` klasöründe oluşturuldu mu?
- Görsel boyutu çok mu büyük? (>4096x4096)

### **Problem**: Görsel bozuk / uzamış görünüyor
**Çözüm**:
- Bu olmamalı! Aspect ratio korunur.
- Eğer oluyor ise, görsel dosyası corrupt olabilir. Yeni bir PNG kaydet.

### **Problem**: SpriteSheetGenerator hata veriyor
**Çözüm**:
- Görseller gerçekten `ui_erscenes` klasöründe mi?
- Config.xml dosyası var mı? (`EnhancedRomance\GUI\Config.xml`)
- Oyun açık değil değil mi? (kapalı olmalı)

---

## 📊 7. Örnek Klasör Yapısı

```
EnhancedRomance\
  ├── GUI\
  │   ├── Config.xml                    ✅ Otomatik oluşturuldu
  │   ├── SpriteParts\
  │   │   └── ui_erscenes\
  │   │       ├── solo_1.png           ← SEN EKLEDIN
  │   │       ├── solo_2.png           ← SEN EKLEDIN
  │   │       ├── solo_3.png           ← SEN EKLEDIN
  │   │       ├── gang_1.png           ← SEN EKLEDIN
  │   │       ├── gang_2.png           ← SEN EKLEDIN
  │   │       ├── romance_1.png        ← SEN EKLEDIN
  │   │       ├── capture_1.png        ← SEN EKLEDIN
  │   │       ├── story_tavern_1.png   ← SEN EKLEDIN
  │   │       └── story_market_1.png   ← SEN EKLEDIN
  │   ├── Prefabs\
  │   │   └── SceneViewerScreen.xml    ✅ Mod ile geldi
  │   └── EnhancedRomance_SpriteData.xml  ✅ Otomatik generate
  ├── Assets\
  │   └── erscenes_1_tex.tpac          ✅ Otomatik generate
  └── AssetSources\                     ✅ Otomatik generate
```

---

## 💡 8. İpuçları

### **Çok sayıda görsel eklemek**:
- Tek seferde 50+ görsel ekleyebilirsin
- `solo_1.png` ... `solo_50.png` gibi numaralandır
- SpriteSheetGenerator hepsini tek seferde işler

### **Görselleri güncelleme**:
- Görseli değiştir
- SpriteSheetGenerator'ı yeniden çalıştır
- Resource Browser'da **Reimport** yap (Import yerine)

### **Görselleri silme**:
- Dosyayı sil
- SpriteSheetGenerator'ı yeniden çalıştır
- Oyunu yeniden başlat

### **Performans**:
- 1024x768 boyut performans için iyi
- 1920x1080 daha net ama biraz yavaş yüklenebilir
- 100+ görsel eklenirse mod load time artabilir

---

## 🎯 9. Hızlı Başlangıç (TL;DR)

1. Görselleri `EnhancedRomance\GUI\SpriteParts\ui_erscenes\` klasörüne kopyala
2. İsimlendirmeyi düzelt: `solo_1.png`, `gang_1.png` vb.
3. `SpriteSheetGenerator.exe` çalıştır → Module: EnhancedRomance → Generate
4. Oyunu aç → Console → `resource.show_resource_browser` → Scan → Import
5. Kampanyada test et!

---

## ❓ 10. Sıkça Sorulan Sorular

**S: Kaç tane görsel ekleyebilirim?**
C: Sınırsız! Ama 100+ eklenirse yükleme süresi artabilir.

**S: GIF animasyon ekleyebilir miyim?**
C: Hayır, sadece PNG/JPG desteklenir.

**S: Görsel boyutu sabit mi olmalı?**
C: Hayır! Herhangi bir boyut olabilir (512x512'den 4096x4096'ya kadar).

**S: Mod güncellenince görseller kaybolur mu?**
C: Hayır, `GUI/SpriteParts/` klasöründeki görsellerin üzerine yazılmaz.

**S: Multiplayer'da çalışır mı?**
C: Bu mod singleplayer için tasarlandı, multiplayer desteklenmez.

---

## 📞 11. Destek

Sorun mu yaşıyorsun?
1. Console'da (`Alt + ``) hata mesajlarını kontrol et
2. `ModuleLogs/` klasöründeki log dosyalarını oku
3. Bu README'yi baştan sona oku
4. GitHub Issues'da yeni konu aç

---

**🎉 Keyifli Modding!**
