Ren'Py ile
kendi hikayeni yaz

Ren'Py Nedir?

Ren'Py, visual novel yapmanın en kolay yolu. Ücretsiz, açık kaynak ve dünyanın en popüler VN motoru.

Onunla neler yapabilirsin:

• Karakter diyalogları, seçenekler, dallanmalar
• Arkaplan ve karakter görselleri
• Müzik, ses efektleri
• Save/Load, ayarlar, geçmiş paneli. hepsi hazır geliyor
• Windows, Mac, Linux, Android, Web'e tek tuşla export

Kurulum

Ren'Py Launcher: tüm işlerini buradan yapacaksın

Sol tarafta projelerini görürsün. Sağ tarafta "Create New Project", "Preferences" gibi butonlar var.

İlk Projen

Kendi oyununu başlatmak için Launcher'da "Create New Project" tıkla. 3 adımda hazır:

1. Proje Adı

Oyununa bir isim ver. Boşluk ve Türkçe karakter kullanabilirsin.

Proje adını gir, sonradan değiştirebilirsin

2. Çözünürlük

Oyunun ekran boyutu. 1920x1080 veya 1280x720 seç. Emin değilsen 1280x720 ile başla, yeterli olur.

1280x720 çoğu proje için yeterli

3. Renk Şeması

Ren'Py menülerin ve butonların renk tonunu sorar. Birini seç, sonra istediğin gibi değiştirirsin.

Vurgu rengi ve arkaplan rengi seç

Tamamlandıktan sonra proje listesinde görünür. "Open Directory" > "game" ile oyun dosyalarının olduğu klasörü aç.

Basit Bir Oyun

script.rpy dosyasını aç ve içindeki her şeyi sil. Şunları yaz:

label start:
    "Sabah erkenden mahalle kahvecisine geldim."

    "Defne" "Günaydın! Bugün ne içersin?"

    "Ben" "Bir Türk kahvesi alayım."

    "Defne" "Hemen hazırlıyorum!"

    returnkopyala

Şimdi Launcher'da "Launch Project" tıkla. Oyunun çalışıyor!

Neler oldu burada:

• label start:: oyunun başlangıç noktası. Her Ren'Py oyunu buradan başlar.
• "Metin": tek başına yazılırsa anlatıcı (narrator) konuşur, adı gözükmez.
• "İsim" "Metin": karakter konuşması. İsim üstte gözükür.
• return: oyunu bitirir, ana menüye döner.

Karakterler (Characters)

Visual novel'de konuşan kişilere karakter denir. Karakter tanımı yapınca Ren'Py diyalog kutusunda o kişinin adını otomatik gösterir, her karaktere ayrı renk verebilirsin. Tanımlamadan da yazabilirsin ama her satırda ismi tekrar yazman gerekir. Tanımla, kısa kodla çağır:

define d = Character('Defne', color="#c8ffc8")
define b = Character('Ben', color="#c8c8ff")kopyala

label start:
    "Sabah erkenden mahalle kahvecisine geldim."

    d "Günaydın! Bugün ne içersin?"

    b "Bir Türk kahvesi alayım."

    d "Hemen hazırlıyorum!"

    returnkopyala

Neler değişti:

• define d = Character('Defne', color="#c8ffc8"): d artık "Defne" demek. Yeşil renkte görünecek.
• d "Metin": tırnak işareti olmadan, direkt d yaz.
• color="#c8ffc8": ismin rengi. Herhangi bir hex renk kodu koyabilirsin.

# ─── 1. BÖLGE: TANIMLAR (en üst, girintisiz) ───
define d = Character('Defne', color="#c8ffc8")
define b = Character('Ben', color="#c8c8ff")
default sade_icti = False

# ─── 2. BÖLGE: HİKAYE (label blokları, 4 boşluk girintili) ───
label start:
    d "Günaydın!"
    jump bolum2

label bolum2:
    d "Devam edelim."
    return

Görseller (Images)

Visual novel'de oyuncunun gördüğü iki tür görsel var: arka planlar (mekanlar: kafe, park, sokak) ve karakter sprite'ları (konuşan kişilerin çizimleri). Bu görselleri kendin çizersin, AI ile üretirsin ya da ücretsiz arşivlerden indirirsin. Ren'Py'nin işi bunları ekranda göstermek.

Oyunda görseller böyle görünür: arka plan (scene), karakter (show), diyalog kutusu üst üste katmanlanır

Arkaplan (scene)

    scene bg kafe
    with fadekopyala

scene ekrandaki her şeyi temizler ve yeni arka plan gösterir. bg kafe yazmak: "images/ klasöründe bg kafe.png (veya .jpg/.webp) adlı dosyayı kullan" demek. Uzantıyı yazmana gerek yok, Ren'Py kendisi bulur.

Karakter Gösterme (show)

    show defne mutlu
    with dissolvekopyala

show arkaplanın üstüne karakter görseli koyar. defne mutlu demek: images/ klasöründe defne mutlu.png veya defne_mutlu.webp adında dosya ara.

Karakter Gizleme (hide)

    hide defnekopyala

Karakteri ekrandan tamamen kaldırır. Ne zaman lazım? Bir karakterin sahneden tamamen çıkması gerektiğinde. Aynı karakterin farklı bir ifadesine geçmek için kullanmana gerek yok. show defne kizgin yazınca Ren'Py önceki Defne görselini otomatik değiştirir, silip tekrar eklemen gerekmez.

Karakter İfadeleri: Dosyaları Nasıl Düzenlersin?

Bir karakterin mutlu, üzgün, kızgın gibi farklı hallerini göstermek istiyorsan her ifade için ayrı bir görsel dosyası oluşturursun. Dosya adının ilk kelimesi karakterin etiketi, ikinci kelimesi ifade adı olur:

Scriptte ifade değiştirmek çok kolay:

label start:
    scene bg kafe
    with fade

    show defne mutlu
    d "Günaydın!"

    show defne saskin         # önceki defne mutlu otomatik gider
    d "Ne? Gerçekten mi?"

    show defne kizgin         # yine otomatik değişir
    d "Bunu yapmamalıydın!"kopyala

İstersen alt klasörlere ayırabilirsin:

Görsel Dosya İsimlendirmesi

Dosyayı game/images/'e koyduğunda Ren'Py dosya adını otomatik olarak koda çevirir. Uzantıyı (.png) atar, büyük harfleri küçültür, alt çizgileri boşluğa çevirir. Sonuç: kodda kullanacağın isim.

Dönüşümün adımlarını merak ediyorsan:

image Komutu: Manuel İsimlendirme

Dosya adında tire, sayı veya özel karakter varsa Ren'Py otomatik bulamaz. image komutu ile kendin eşleştirirsin. ÜST BÖLGE'ye yaz (define'ların yanına):

# Tire veya özel karakter içeren dosyalar için
image logo = "renpy-logo.png"
image defne happy = "defne-ifade-mutlu.png"
image bg gece = "backgrounds/sehir-gece-v2.jpg"kopyala

Bundan sonra show defne happy veya scene bg gece yazman yeterli. Ren'Py hangi dosyayı açacağını bilir.

Hepsini Birleştirelim

define d = Character('Defne', color="#c8ffc8")
define b = Character('Ben', color="#c8c8ff")

label start:
    scene bg kafe
    with fade

    "Sabah erkenden mahalle kahvecisine geldim."

    show defne mutlu
    with dissolve

    d "Günaydın! Bugün ne içersin?"

    b "Bir Türk kahvesi alayım."

    show defne saskin

    d "Sade mi, şekerli mi?"

    returnkopyala

Geçişler (Transitions)

Bir sahne veya karakter değiştiğinde ekran aniden değişir, bu sert ve yapay görünür. Geçişler bu değişimi yumuşatır: sahne yavaşça belirir (fade), karakter eriyerek değişir (dissolve), görsel kayarak gelir (move). Oyuna sinematik his katar. with komutuyla eklenir:

    scene bg kafe
    with fade          # Siyaha gider, yeni sahne gelir

    show defne mutlu
    with dissolve      # Yavaş yavaş belirirkopyala

En çok kullanılan geçişler:

• dissolve: yavaş geçiş (en yaygın)
• fade: siyaha gidip gelir (sahne değişikliği için)
• None: geçiş yok, anında değişir

Birden Fazla Değişiklik, Tek Geçiş

    scene bg park
    show defne mutlu at left
    with dissolve      # Her ikisi aynı anda geçiş yaparkopyala

Burada tek bir with var. Ren'Py üstteki tüm değişiklikleri toplar, hepsini aynı anda oynatır: arka plan ve karakter birlikte dissolve olur.

Ardışık Geçiş: Önce Sahne, Sonra Karakter

Peki ya arka planın önce gelmesini, karakterin sonra belirmesini istiyorsan? Her değişikliğin altına ayrı with koy. Böylece Ren'Py birincisini bitirir, sonra ikincisine geçer:

    scene bg park
    with fade          # Önce arka plan kararır, park açılır

    show defne mutlu at left
    with dissolve      # Sonra Defne ayrıca belirirkopyala

    scene bg park
    with None          # Park hazırlandı ama geçiş gösterilmedi
    show defne mutlu
    with dissolve      # Sadece karakter geçişi görülür

Tüm Yerleşik Geçişler

Bunlar ek mod gerektirmez. Ren'Py'ye dahil. with yazdıktan sonra aşağıdakilerden birini yaz:

    # ── Sahne değiştirme ───────────────────────────────────────────────
    with fade            # Siyaha kararak gider, yeni sahne siyahtan açılır
    with dissolve        # Önceki üstüne yavaş yavaş erir (en çok kullanılan)
    with ease            # dissolve gibi ama hız: yavaş başlar, ortada hızlanır, yavaşlar

    # ── Kaydırma (slide) ───────────────────────────────────────────────
    with moveinright     # Yeni sahne sağdan kayarak girer
    with moveinleft      # Yeni sahne soldan kayarak girer
    with moveintop       # Yeni sahne alttan yukarı kayarak girer
    with moveinbottom    # Yeni sahne üstten aşağı kayarak girer
    with moveoutright    # Eski sahne sağa kayarak çıkar
    with moveoutleft     # Eski sahne sola kayarak çıkar

    # ── Perde efektleri ────────────────────────────────────────────────
    with wiperight       # Yeni sahne soldan sağa doğru perde gibi açılır
    with wipeleft        # Yeni sahne sağdan sola doğru perde gibi açılır
    with wipeup          # Yeni sahne aşağıdan yukarı doğru açılır
    with wipedown        # Yeni sahne yukarıdan aşağı doğru açılır
    with blinds          # Yatay jaluzi (stor perde) şeklinde açılır
    with squares         # Küçük kareler halinde rastgele belirir

    # ── Sarsıntı (punch): shock/patlama anı ───────────────────────────
    with vpunch          # Ekran dikey sarsıntısı: patlama, ani darbe için
    with hpunch          # Ekran yatay sarsıntısı: güçlü vuruş, feryat için

    # ── Özel efektler ──────────────────────────────────────────────────
    with pixellate       # Ekran pikselleşir, sonra yeni sahne çözünür (retro geçiş)
    with irisin          # Ortadan dışa doğru daire açılır (klasik sinema geçişi)
    with irisout         # Dıştan merkeze doğru daire kapanır (sahne sonu)
    with zoomin          # Yeni sahne yakınlaşarak girer (zoom in)
    with zoomout         # Yeni sahne uzaklaşarak girer (zoom out)
    with zoominout       # Eski zoom-in ile çıkar, yeni zoom-out ile girer

    # ── Genel ──────────────────────────────────────────────────────────
    with None            # Geçiş yok: ekranı sessizce hazırla, sonra with dissolve ile getirkopyala

Zaman Geçişi: Gündüz'den Geceye

VN'lerde zaman geçişi için sahneyi yavaşça karartırsın. İki farklı arka plan görseli lazım (gündüz + gece), aralarına yavaş Dissolve() koy:

# ÜST BÖLGE: define'ların yanına yaz
define gunduz_gece = Dissolve(4.0)   # 4 saniyede yavaşça geçer
define hizli_aksam = Dissolve(1.5)   # 1.5 saniye: hızlı sahne kesilmesikopyala

    scene bg_park_gunduz
    with dissolve

    kai "Buluşmayı bekliyordum..."

    scene bg_park_gece
    with gunduz_gece   # 4 saniyede gündüz görüntüsü yavaşça gece oluyor

    kai "Saatler geçmiş."kopyala

Geçiş Hızını Ayarlama

Yerleşik geçişlerin varsayılan süresi yaklaşık 0.5 saniyedir. Yavaşlatmak veya hızlandırmak için Dissolve(), Fade() gibi sınıfları kullan:

define yavas_giris = Dissolve(1.5)    # 1.5 saniyede dissolve
define hizli_fade  = Fade(0.2, 0.0, 0.2) # 0.2s kararma, 0s bekle, 0.2s açılma
define dramatik_fade = Fade(0.5, 1.0, 0.5) # 0.5s kararma, 1s tam siyah, 0.5s açılmakopyala

    scene bg kafe
    with dramatik_fadekopyala

Pozisyonlar (Positions)

Birden fazla karakter sahnedeyken hepsi üst üste ortada durmasın diye konumlandırma yaparsın. Bir karakter solda, biri sağda, kimin konuştuğu görsel olarak belli olur. at komutuyla karakteri ekranın istediğin yerine koyarsın:

    show defne mutlu at left       # Solda
    show defne mutlu at right      # Sağda
    show defne mutlu at center     # Ortada (varsayılan)
    show defne mutlu at truecenter # Tam ortada (dikey+yatay)

    # Ekran dışı pozisyonlar: giriş/çıkış animasyonları için
    show defne mutlu at offscreenleft   # Sol dışında (görünmez)
    show defne mutlu at offscreenright  # Sağ dışında (görünmez)kopyala

Birden fazla karakter aynı anda gösterirken farklı pozisyonlar kullan:

    show defne mutlu at left
    show emre dusunceli at right
    with dissolvekopyala

Özel Konum: xalign / yalign

Hazır konumlar (left, right, center) yetmiyorsa sayıyla tam konum ver. xalign: 0.0 = sol kenar, 0.5 = tam orta, 1.0 = sağ kenar. yalign: 0.0 = üst, 1.0 = alt:

    show defne mutlu at Position(xalign=0.2, yalign=1.0)  # Solda, altta
    show emre dusunceli at Position(xalign=0.8, yalign=1.0)  # Sağda, alttakopyala

Sık kullandığın konumları bir kere transform ile tanımla, sonra ismiyle çağır:

transform sol:
    xalign 0.2 yalign 1.0
transform sag:
    xalign 0.8 yalign 1.0

# Kullanımı:
    show defne mutlu at sol
    show emre dusunceli at sag
    with dissolvekopyala

Müzik ve Ses (Audio)

Ses olmadan visual novel sessiz film gibi kalır. Arka plan müziği sahnenin atmosferini kurar (kafede sakin caz, gerilim anında hızlı ritim), ses efektleri anları güçlendirir (kapı çarpması, bardak sesi). Ses dosyalarını game/audio/ klasörüne koy, kodda çağır. OGG formatı önerilir (küçük boyut, döngüde kesinti yok).

Arka Plan Müziği

Sahne boyunca döngüde çalar. fadeout ile geçiş yumuşak olur.

    play music "audio/kafe-ambiyans.ogg"              # Başlatır, döngüde çalar
    play music "audio/kafe-ambiyans.ogg" fadeout 1.0  # Önceki müzik 1 saniyede solar
    stop music fadeout 2.0                               # Müziği 2 saniyede durdururkopyala

Ses Efekti

Bir kere çalıp biter. Kapı, adım, patlama gibi anlık sesler için.

    play sound "audio/bardak.ogg"     # Bir kere çalar, döngü yokkopyala

Sıra ile Çalma

İlk parça bitince ikincisi başlar. Birden fazla sahneyi aynı müzik akışıyla kaplarsın.

    play music "audio/sabah.ogg"
    queue music "audio/ogle.ogg"    # Sabah bitince öğle başlarkopyala

Gelişmiş Ses Kontrolleri

Müziği yavaşça aç, ses seviyesini ayarla, aynı parçayı boşuna baştan başlatma:

    # Müzik 2 saniyede yavaşça açılır (fade in)
    play music "audio/kafe.ogg" fadein 2.0

    # Hem eski müzik solar, hem yeni yavaşça girer
    play music "audio/gece.ogg" fadeout 1.0 fadein 2.0

    # Ses seviyesi: 0.0 (sessiz) ile 1.0 (tam) arası
    play music "audio/kafe.ogg" volume 0.5  # Yarı ses

    # Aynı parça çalıyorsa baştan başlatma
    play music "audio/kafe.ogg" if_changedkopyala

Bekleme (Pause)

Bazen diyalog arasında bir an durup sahnenin etkisini hissettirmek istersin: dramatik bir sessizlik, manzaranın tadını çıkarma anı, ya da bir olayın sindirimi. pause komutu oyunu belirli süre bekletir veya oyuncu tıklayana kadar durur.

    pause          # Oyuncu tıklayana kadar bekle
    pause 3.0      # 3 saniye bekle, sonra devam etkopyala

    scene bg gece_gokyuzu
    with fade

    "Gökyüzüne baktım. Yıldızlar her zamankinden parlaktı."

    pause 2.0      # 2 saniye sessizlik: manzara sindiriliyor

    "O an bir dilek tuttum."kopyala

Oyunu Bitirme (Return)

Her hikayenin bir sonu var. Ren'Py'de return komutu oyunu bitirir ve oyuncuyu ana menüye döndürür. Birden fazla son istiyorsan farklı yerlere farklı return'ler koyarsın, oyuncunun seçimlerine göre farklı finallere ulaşır.

    "Ve böylece güzel bir gün geçirdim."

    "--- SON ---"

    returnkopyala

Menüler ve Seçenekler (Menus & Choices)

Visual novel'i filmden ayıran şey oyuncunun seçim yapabilmesi. "Kahve mi çay mı?", "Ona güven / Güvenme" gibi seçenekler sunarsın, oyuncunun tıkladığı şıkka göre hikaye dallanır. Bu dallanma sayesinde oyun her seferinde farklı deneyim verir. menu: komutuyla seçenek sunarsın:

Oyuncunun gördüğü menü ekranı: tıklayarak seçim yapar

label start:
    scene bg kafe
    with fade

    show defne mutlu
    with dissolve

    d "Sade mi, şekerli mi?"

    menu:
        "Sade olsun.":
            jump sade
        "Şekerli olsun.":
            jump sekerli

label sade:
    d "Sade Türk kahvesi, geliyooor!"
    d "Gerçek kahve tiryakisi!"
    jump devam

label sekerli:
    d "Şekerli, hemen hazırlıyorum!"
    d "Tatlı can, tatlı kahve sever!"
    jump devam

label devam:
    "Kahvemi alıp camdan dışarıyı seyrettim."
    returnkopyala

Neler oluyor:

• menu:: ekranda seçenekler gösterir
• "Metin":: bir seçenek (sonunda iki nokta şart)
• jump sade: oyun akışını label sade'ye atlatır
• label sade:: akışın atlayacağı nokta

Koşullu Seçenekler: Duruma Göre Menü

Bazı seçeneklerin sadece belirli durumlarda görünmesini isteyebilirsin. Mesela oyuncu önceki bölümde bir anahtar bulduysa yeni bir kapıyı açabilsin:

default anahtar_buldu = False

label koridor:
    "Koridorun sonunda üç kapı var."

    menu:
        "Sol kapıyı aç.":
            jump sol_oda
        "Sağ kapıyı aç.":
            jump sag_oda
        "Kilitli kapıyı aç." if anahtar_buldu:
            jump gizli_odakopyala

Seçenek metninin sonuna if koşul ekliyorsun. Koşul True değilse o seçenek ekranda hiç görünmez, oyuncu varlığından bile haberdar olmaz.

Save / Load: Kayıt Sistemi

Kayıt sistemi Ren'Py'de hazır gelir, tek satır kod yazmana gerek yok. Oyuncu oyun sırasında:

• Sağ tıkla veya Escape → Kaydet / Yükle menüsü açılır
• S tuşu → Hızlı kayıt (quicksave)
• L tuşu → Hızlı yükle (quickload)

Kayıtlar saves/ klasörüne otomatik yazılır. Kaç kayıt yuvası olacağını gui.rpy'den ayarlayabilirsin:

define config.has_quicksave = True   # Hızlı kayıt açık (varsayılan: True)
define gui.file_slot_cols = 3         # Kayıt ekranında kaç sütun
define gui.file_slot_rows = 2         # Kaç satır (toplam 6 kayıt yuvası)kopyala

Özelleştirilmiş kayıt ekranı: slot görselleri gui/ klasöründen gelir

Butonlar (Buttons & Imagebuttons)

menu: komutu sadece hikaye akışında seçenek sunar. Ama bazen ekranın köşesine bir "Envanter" butonu, bir harita simgesi ya da tıklanabilir bir nesne koymak istersin. Butonlar bunu sağlar, ekranın istediğin yerine metin veya görsel olarak tıklanabilir alan koyarsın. Bunun için screen kullanıyorsun.

Metin Butonu (textbutton)

screen secim_ekrani():
    vbox:
        textbutton "Devam Et" action Return(True)
        textbutton "Ana Menü" action MainMenu()
        textbutton "Bir Sahneye Atla" action Jump("sahne3")kopyala

label start:
    call screen secim_ekranikopyala

Görsel Buton (imagebutton)

screen ozel_menu():
    imagebutton:
        idle "images/btn_normal.png"    # Normal hali
        hover "images/btn_hover.png"    # Üstüne gelince
        action Jump("galeri_label")kopyala

Sık Kullanılan action'lar

Değişkenler (Variables)

Oyuncu bir seçim yaptığında o seçimi hatırlaman lazım. "Kahve mi aldı, çay mı?", "Defne'ye güvendi mi?" gibi bilgileri saklamak için değişken kullanırsın. Sonra bu bilgiye göre hikayeyi dallandırırsın: güven puanı yüksekse iyi son, düşükse kötü son. Kısacası değişkenler oyunun hafızası.

default sade_icti = False

label start:
    scene bg kafe
    with fade

    d "Sade mi, şekerli mi?"

    menu:
        "Sade olsun.":
            $ sade_icti = True
            d "Gerçek tiryaki!"
        "Şekerli olsun.":
            d "Tatlı cansın!"

    "Bir saat sonra..."

    if sade_icti:
        d "Bir sade daha ister misin? İkincisi benden."
    else:
        d "Şekerli sevdiysen bir de damla sakızlı dene!"

    returnkopyala

• default sade_icti = False: oyun başlamadan değişkeni tanımlar. ÜST BÖLGE'ye yaz (define'ların yanına).
• $ sade_icti = True: değeri değiştirir. $ işareti "bu satır Python kodu" demek.
• if sade_icti:: koşul kontrolü. True ise altındaki blok çalışır.
• else:: koşul sağlanmazsa bu blok çalışır.

elif: Birden Fazla Koşul

İki seçenek yetmez, üç-dört farklı durumu kontrol etmen gerekirse elif ("else if"in kısaltması) kullan:

default kahve_tipi = "sade"

label yorum:
    if kahve_tipi == "sade":
        d "Sade sever, gerçek tiryaki!"
    elif kahve_tipi == "sekerli":
        d "Tatlı cansın!"
    elif kahve_tipi == "sutlu":
        d "Latte tipi, modern!"
    else:
        d "Hmm, ilginç bir tercih."kopyala

Akış şöyle işler: Ren'Py yukarıdan aşağı kontrol eder. İlk True olan koşulu çalıştırır, gerisini atlar. Hiçbiri tutmazsa else devreye girer.

define vs default: Fark Nedir?

Ren'Py'de iki tane "tanımlama" komutu var. İkisi de aynı yere yazılır (label start:'ın üstüne) ama çok farklı işler yapar.

┌────────────────────────────────────────────────┐
│  ▲ ÜST BÖLGE (label start:'dan ÖNCE)         │
│  Buraya define ve default yazılır.            │
│  Girintisiz, satır başından başla.             │
│                                                │
│  define d = Character("Defne")                │
│  default ruh_hali = 0                         │
│                                                │
├────────────────────────────────────────────────┤
│  ▼ ALT BÖLGE (label start:'dan SONRA)          │
│  Buraya hikaye yazılır.                       │
│  Her satır 4 boşluk girintili.                │
│                                                │
│  label start:                                 │
│      d "Günaydın!"                              │
│      $ ruh_hali += 1                             │
│                                                │
└────────────────────────────────────────────────┘

# ▲ ÜST BÖLGEYE yaz (label start:'dan önce)
define d = Character("Defne", color="#c8ffc8")
define b = Character("Ben", color="#c8c8ff")

# ▲ ÜST BÖLGEYE yaz (define'ların hemen altına)
default ruh_hali = 0       # sayı: artıp azalacak
default sade_icti = False  # bayrak: True veya False
default bolum = 1          # sayı: ilerledikçe artacak

Minik örneklerle fark:

define d = Character("Defne")
# oyun boyunca d hep "Defne" kalır
# kimse bunu değiştiremez

default ruh_hali = 0
# oyuncu "Lila ile konuş" seçerse:
#   $ ruh_hali += 1  → artık 1
# oyuncu "yalnız kal" seçerse:
#   $ ruh_hali -= 1  → artık -1

Hangisini ne zaman kullanırım?

label start:
    # oyuncu "Lila ile konuş" seçti, ruh hali artıyor:
    $ ruh_hali += 1

    # oyuncu sade kahve seçti, bayrağı True yap:
    $ sade_icti = True

Metin Etiketleri (Text Tags)

Diyalog metninin içine özel etiketler koyarak yazıyı kalın, eğik, renkli yapabilir veya metnin nasıl gösterileceğini kontrol edebilirsin. Süslü parantez { } içinde yazılırlar.

Biçimlendirme Etiketleri

Metnin görünümünü değiştiren etiketler:

    d "{b}Bu kalın metin.{/b} Bu normal."
    d "{i}Bu eğik metin.{/i}"
    d "{u}Altı çizili metin.{/u}"
    d "{s}Üstü çizili metin.{/s}"
    d "{color=#ff0000}Kırmızı metin.{/color}"
    d "{size=+10}Daha büyük{/size} ve {size=-5}daha küçük.{/size}"kopyala

d "{b}Bu kelime kalın.{/b} Bu normal."
d "{b}Tüm cümle kalın olur.{/b}"
d "{b}{i}Kalın ve eğik birlikte.{/i}{/b}"

d "{i}İç ses veya düşünce.{/i}"
n "{i}Rüzgar hafifçe esiyordu.{/i}"
d "{i}{color=#aaaacc}Sessiz iç monolog.{/color}{/i}"

d "{u}Önemli not:{/u} bunu unutma."
d "{color=#4ecdc4}{u}tıklanabilir gibi{/u}{/color} görünür."

d "Fiyat: {s}50 TL{/s} 30 TL!"
d "{s}Bunu söylememeliydim.{/s} Şey, yani..."
d "{s}{color=#888}eski plan{/color}{/s} → yeni plan"

d "{color=#ff0000}Tehlike!{/color} Buradan kaç."
d "{color=#4ecdc4}Sakin ol.{/color} Her şey yolunda."
d "{color=#ffd166}Altın{/color} anahtar bulundu."

d "{size=+15}BAĞIRMA!{/size}"
d "{size=-4}(fısıldayarak) duydun mu?{/size}"
d "{size=+8}Önemli:{/size} kapıyı {size=-3}sessizce{/size} kapat."

# Önce gui.rpy'de outline tanımla (yoksa etiket çalışmaz):
define gui.text_outlines = [(2, "#000000", 0, 0)]

# Sonra script.rpy'de kullan:
d "{outlinecolor=#ff0000}Tehlike!{/outlinecolor} Normal metin."
d "{outlinecolor=#ffd166}Altın parıltı.{/outlinecolor}"

d "Bu net. {alpha=0.3}Bu çok soluk.{/alpha}"
d "{alpha=0.5}Hayalet gibi konuşuyorum...{/alpha}"
d "{alpha=0.0}Görünmez metin (ama yer kaplar).{/alpha}"

    # Outline ve saydamlık örnekleri
    d "{outlinecolor=#ff0000}Tehlike!{/outlinecolor} Sakin ol."
    d "Bu {alpha=0.3}soluk{/alpha} ama bu net."kopyala

Akış Kontrol Etiketleri

Metnin ekranda nasıl ve ne zaman gösterileceğini kontrol eden etiketler. Bunlar dramatik anlatım için çok önemli:

    # Oyuncu tıklayana kadar bekle, sonra devam et
    d "Kapıyı açtım ve...{w} içeride kimse yoktu."

    # Otomatik 2 saniye bekle, sonra devam et
    d "3...{w=1.0}2...{w=1.0}1...{w=1.0}Başla!"

    # Satır sonu + tıklama bekle (sayfa gibi)
    d "İlk paragraf.{p}İkinci paragraf yeni satırda."

    # Tıklama beklemeden anında göster (NPC acele konuşsun)
    d "Dur!{nw}"
    d "Dur! Beni dinle!"

    # Önceki metin görünmeden direkt buradan başla
    d "Bla bla uzun metin...{fast}ama sadece burayı görürsün."kopyala

{nw} ile Metin Birleştirme

Bir karakter cümlenin ortasında kesilip devam etsin istersen {nw} ile {fast} birlikte kullanılır:

    d "Ben aslında...{nw}"
    d "Ben aslında...{fast} seni çok seviyorum!"kopyala

İlk satır ekranda "Ben aslında..." gösterir ve hemen ikinci satıra geçer. İkinci satırda {fast}'tan önceki kısım anında yazılır (tekrar gösterilmez), sadece "seni çok seviyorum!" yeni metin olarak eklenir. Sonuç: oyuncu kesintisiz bir cümle görür.

Değişkenleri Metin İçinde Gösterme

Köşeli parantez [ ] ile değişken değerlerini diyaloğun içine yerleştir:

default oyuncu_adi = "Oyuncu"

label start:
    $ oyuncu_adi = renpy.input("Adın ne?")
    d "Merhaba, [oyuncu_adi]! Hoş geldin."
    d "Bugün kahve [oyuncu_adi] ikramı!"kopyala

Dosya Yapısı (File Structure)

Ren'Py projesinin tüm dosyaları game/ klasörünün içinde yaşar: senaryonun, görsellerini, müziklerini, arayüz ayarlarını, her şey burada. Hangi dosyanın ne işe yaradığını bilirsen "bunu nereye koyacağım?" sorusu kalmaz. İşte yapı:

En çok dokunacağın dosyalar:

• script.rpy: tüm senaryon
• images/: görsellerini buraya koy
• audio/: müzik ve sesleri buraya koy
• gui.rpy: görünümü özelleştirmek için
• options.rpy: oyun başlığı, sürümü vs.

Ekranlar (Screens & Screen Language)

Ren'Py'de oyuncunun gördüğü her arayüz parçası bir ekran (screen). Diyalog kutusu, ana menü, kayıt ekranı, seçenek menüsü, hepsi birer screen. Ren'Py bunları screens.rpy dosyasında tanımlar.

Ekran Nedir? (What is a Screen?)

Bir screen, ekranda gösterilen UI elementlerinin tarifnamesi. scene, show ve hide komutlarıyla gösterilir, ama asıl güçleri screen deyimiyle kendi ekranlarını yazmanda.

Yerleşik Ekranlar (Built-in Screens)

Ren'Py yeni projede bu ekranları otomatik oluşturur. Hepsini screens.rpy içinde bulursun:

Basit Ekran Yazımı (Screen Language Basics)

Kendi ekranını yazmak için screen deyimini kullan. İçine text, textbutton, vbox, hbox, imagebutton gibi elementler koyarsın:

screen bilgi_ekrani():
    vbox:
        xalign 0.5
        yalign 0.5
        spacing 20

        text "Hoş geldin!" size 40
        text "Bu senin ilk ekranın."
        textbutton "Kapat" action Hide("bilgi_ekrani")kopyala

Ekranı göstermek ve gizlemek için:

label start:
    show screen bilgi_ekrani
    "Ekran göründü."
    hide screen bilgi_ekrani
    "Ekran kapandı."kopyala

Screen Elementleri (Screen Displayables)

Screen Actions (Eylemler)

Butonlara ve elementlere bağlanan aksiyonlar. En çok kullanılanlar:

# Sayfalar arası geçiş
textbutton "Yeni Oyun" action Start()
textbutton "Devam Et" action ShowMenu("load")
textbutton "Ayarlar" action ShowMenu("preferences")
textbutton "Çıkış" action Quit(confirm=True)

# Ekranları aç/kapat
textbutton "Göster" action Show("bilgi_ekrani")
textbutton "Kapat" action Hide("bilgi_ekrani")

# Değişken değiştir
textbutton "Kabul Et" action SetVariable("kabul", True)
textbutton "Sesi Aç" action SetMute("music", False)kopyala

Özelleştirme (GUI Customization)

Ren'Py'nin varsayılan arayüzü her projede aynı görünür: gri butonlar, standart font, düz diyalog kutusu. Oyununa kimlik kazandırmak için arayüzü özelleştirirsin: renkler, fontlar, diyalog kutusu, arka plan görselleri, buton tasarımları. Tek bir gui.rpy dosyasından neredeyse her şeyi kontrol edebilirsin.

Bu bölümde şunları değiştirmeyi öğreneceksin:

Ren'Py yeni proje oluşturduğunda game/gui/ klasörüne otomatik PNG dosyaları koyar. Bu PNG'leri herhangi bir görsel editörle (Photoshop, GIMP, Figma) değiştirince arayüzün her parçası değişir. gui.rpy'daki ayarlarla renkler, fontlar ve boyutlar ayarlanır.

Ana menü: gui/main_menu.png değiştirilerek özelleştirilmiş

Diyalog ekranı: textbox.png ve namebox.png ile şekillendirilmiş

VN Arayüzü: Hangi Parça Nereden Geliyor?

gui/ Klasör Haritası

Proje oluşturulduğunda otomatik gelen dosyalar, bunları değiştirerek arayüzü şekillendir:

Pencere Başlığı ve Simgesi

options.rpy dosyasında:

define config.name = "Kahve Hikayesi"      # Pencere başlığında görünür
define config.version = "1.0"              # Kayıt dosyası adında kullanılırkopyala

Görev çubuğu simgesini değiştirmek için gui/window_icon.png dosyasını istediğin simgeyle değiştir.

Renkler

Tüm menüler, butonlar ve metinlerin rengi buradan yönetilir. Tek bir değeri değiştirince arayüzün her yerinde güncellenir:

define gui.accent_color = '#e84855'          # Vurgu rengi (buton çerçeveleri, başlıklar)
define gui.idle_color = '#888888'            # Pasif menü yazıları
define gui.hover_color = '#ffffff'           # Buton üzerine gelinince
define gui.selected_color = '#e84855'       # Seçili öğe (radio, checkbox vb.)
define gui.text_color = '#ffffff'            # Diyalog metin rengi
define gui.interface_text_color = '#ffffff'  # Menü arayüz yazılarıkopyala

Renk, font ve metin boyutu ayarları uygulandıktan sonra oyun böyle görünüyor

Font

Kendi fontunu eklemek 2 adım:

Örnek: game/fonts/Orbitron.ttf → gui.rpy'ye "fonts/Orbitron.ttf" yaz.

define gui.text_font = "NotoSans.ttf"        # Diyalog metin fontu
define gui.name_text_font = "NotoSans.ttf"   # Karakter adı fontu
define gui.interface_font = "NotoSans.ttf"   # Menü ve arayüz fontu
define gui.text_size = 22                      # Diyalog yazı boyutu (piksel)
define gui.name_text_size = 30                # Karakter adı boyutukopyala

Metin Dış Çizgisi (Outline)

Diyalog metninin etrafına dış çizgi ekler, arka plan ne olursa olsun yazı okunur kalır. Format: (kalınlık, renk, x_offset, y_offset)

# gui.rpy: diyalog metni dış çizgisi
define gui.text_outlines = [(2, "#000000", 0, 0)]   # 2px siyah çizgi, ortalı

# Karakter adı dış çizgisi
define gui.name_text_outlines = [(2, "#000000", 0, 0)]

# Menü yazıları dış çizgisi
define gui.interface_text_outlines = [(1, "#000000", 0, 0)]

# Glow efekti: birden fazla katman üst üste
define gui.text_outlines = [
    (4, "#0044ff44", 0, 0),   # Dışta: mavi parlama (hafif saydam)
    (2, "#0088ffaa", 0, 0),   # Ortada: daha yoğun mavi
    (1, "#ffffff",   0, 0),   # İçte: beyaz ince çizgi
]kopyala

Karakter Bazında Outline

Her karakterin isim ve diyalog metnine ayrı outline verebilirsin. gui.rpy'deki genel ayarı geçersiz kılar:

define d = Character('Defne',
    color="#c8ffc8",
    who_outlines=[(2, "#005500", 0, 0)],    # Karakter adının çizgisi
    what_outlines=[(1, "#000000", 0, 0)]     # Diyalog metninin çizgisi
)kopyala

Metin İçinde Outline Rengi Değiştirme

Diyaloğun belirli bir kelimesine farklı outline rengi vermek için {outlinecolor} text tag'ini kullan:

    d "{outlinecolor=#ff0000}Tehlike!{/outlinecolor} Sakin ol, panik yapma."

    # Buton veya arayüz metninde de çalışır
    d "Bu {outlinecolor=#ffaa00}önemli{/outlinecolor} bir karar."kopyala

Diyalog Kutusu: Şekil, Boyut, Konum

define gui.textbox_height = 185    # Kutu yüksekliği (piksel)
define gui.textbox_yalign = 1.0    # Konum: 1.0 = en alt, 0.5 = ortada, 0.0 = en üstkopyala

Diyalog kutusunu değiştirmenin iki yolu var, şekle göre birini seç:

# gui.rpy: Yöntem 2: yuvarlatılmış köşe (12 = köşe yarıçapı piksel)
style window:
    background Frame(RoundedRectangle("#0a0a1aee", 12), Borders(20, 16, 20, 16))
    xpadding 24
    ypadding 16kopyala

textbox.png, namebox.png ve renk ayarları uygulandıktan sonraki diyalog görünümü

İsim Kutusu

Karakter adının göründüğü kutunun görseli namebox.png'dan gelir. PNG'yi değiştirerek şeklini, gui.rpy'de aşağıdaki değerleri değiştirerek boyutunu ayarlarsın:

define gui.namebox_width = None    # None = metne göre otomatik genişlik
define gui.namebox_height = None   # None = otomatik yükseklik
define gui.namebox_borders = Borders(5, 5, 5, 5)  # İç boşluk: sol, üst, sağ, altkopyala

Arka Plan Görselleri

game_menu.png değiştirildikten sonraki Hakkında ekranı: Kaydet/Yükle/Ayarlar aynı arka planı kullanır

Buton Görünümleri

Menü butonları (Yeni Oyun, Kaydet, Yükle vb.) dört durumda farklı görüntü gösterebilir. PNG'leri bu klasöre koy:

Buton görselleri değiştirildikten sonraki Ayarlar (Preferences) ekranı

Karakter Adı Rengi

Her karakterin ekranda görünen adı farklı renkte olabilir, diyalog kutusunda kimin konuştuğunu renkle ayırt etmek için kullanılır:

define d = Character('Defne', color="#c8ffc8")     # Açık yeşil
define e = Character('Emre', color="#c8c8ff")       # Açık mavi
define n = Character('Anlatıcı', color="#ffd166")   # Sarı/altınkopyala

Bu renk sadece namebox'taki isim metnine uygulanır. Diyalog metninin rengini değiştirmez.

Geliştirici Kısayolları

Oyun çalışırken bunları kullanabilirsin, geliştirici modunda aktif olur (yeni projede varsayılan olarak açık):

Bonus: NVL Modu: Tam Ekran Metin

Klasik VN diyalog kutusuna alternatif olarak NVL modu var: metin ekranın tamamını kaplar, roman gibi paragraflar halinde ilerler:

NVL modu: metin tüm ekranı kaplar, roman okuma hissi verir

# NVL karakter tanımı:
define anlatici = Character(None, kind=nvl)
define d_nvl = Character("Defne", kind=nvl)

# Kullanımı:
    anlatici "Sabah sisi çoktan kalkmıştı."
    anlatici "Kahvenin buğusu pencerede iz bırakıyordu."
    d_nvl "Günaydın."
    nvl clear  # Ekranı temizle, yeni sayfaya geçkopyala

Seçenek Menüsü (Choice Screen)

Oyuncuya sunulan seçenekler de özelleştirilebilir. Seçenek butonlarının iki durumu var:

choice/idle_background.png: normal durum

choice/hover_background.png: fare üzerindeyken

Özelleştirilmiş seçenek ekranı: buton görselleri değiştirilmiş, arka plan ve renk uyumlu

# gui.rpy: seçenek buton boyutları
define gui.choice_button_width = 1185         # Buton genişliği (piksel)
define gui.choice_button_height = None        # None = metne göre otomatik
define gui.choice_button_text_font = gui.text_font
define gui.choice_button_text_size = gui.text_sizekopyala

Overlay: Menü Üstü Katman

Ana menü ve oyun menüsünün arka plan görseli üstüne yarı saydam bir katman bindirilir. Böylece butonlar okunabilir kalır:

main_menu.png üstüne overlay bindirilmiş, sol taraf karartılarak butonlar okunur

game_menu.png üstüne overlay, sağ panel butonlar ve ayarlar için

Kayıt ve Yükleme Ekranı

Kayıt slotlarının görünümü de PNG ile değiştirilir. Her slot ekran görüntüsü (thumbnail) ve bilgi içerir:

slot/idle_background.png: normal durum

slot/hover_background.png: fare üzerindeyken

Özelleştirilmiş kayıt ekranı: her slot kendi ekran görüntüsünü ve tarihini gösteriyor

# gui.rpy: kayıt slotu ayarları
define gui.slot_button_width = 414       # Slot genişliği
define gui.slot_button_height = 309      # Slot yüksekliği
define config.thumbnail_width = 384      # Ekran görüntüsü genişliği
define config.thumbnail_height = 216     # Ekran görüntüsü yüksekliği
define gui.file_slot_cols = 3            # Satır başına slot sayısı
define gui.file_slot_rows = 2            # Sayfa başına satır sayısıkopyala

Slider ve Scrollbar

Ses seviyesi, metin hızı gibi ayarlar slider ile, geçmiş panel ve uzun listeler scrollbar ile kaydırılır. İkisi de PNG ile özelleştirilir:

Slider'lar: ses seviyesi, metin hızı, otomatik ilerleme süresi

Scrollbar: geçmiş ekranında dikey kaydırma çubuğu

Skip ve Bildirim Göstergesi

Oyuncu diyalogları atladığında veya ekranda bir bildirim çıkması gerektiğinde bu görseller kullanılır:

Sol üst: skip göstergesi (atlatma modu açık). Sol alt: bildirim popup'ı (renpy.notify ile tetiklenir)

# Script'ten bildirim göndermek:
    $ renpy.notify("Oyun kaydedildi!")

# Başarım kilidi açıldığında:
    $ renpy.notify("🏆 Başarım: İlk Kahve")kopyala

Onay Ekranı (Confirm)

Oyundan çıkma, yeni oyun başlatma gibi kritik işlemlerde açılan "Emin misin?" penceresi:

Onay ekranı: gui/overlay/confirm.png arka planı, Frame ile çerçevelenmiş

Borders Sistemi: PNG'leri Esnetmeden Ölçekle

Ren'Py, buton ve kutu PNG'lerini Borders ile ölçekler: köşeler sabit kalır, kenarlar uzar. Bu sayede tek PNG'yle her boyutta buton yapılır:

Borders(25,5,25,5): köşe boyutları

Aynı PNG genişletilmiş: köşeler bozulmadan

tile=True: kenarlar tekrarlanarak dolduruluyor

# Borders(sol, üst, sağ, alt): köşelerin piksel boyutu
define gui.frame_borders = Borders(25, 5, 25, 5)

# Kullanımı: Frame ile birlikte
style confirm_frame:
    background Frame("gui/frame.png", gui.frame_borders)kopyala

Yayınlama (Build & Distribution)

Oyunun hazır, ama şu an sadece senin bilgisayarında çalışıyor. Yayınlama, projeyi başkalarının indirebileceği bir pakete dönüştürme işlemi. Ren'Py tek tuşla Windows, Mac, Linux ve Android için dosya oluşturur. Bu dosyayı itch.io gibi platformlara yükleyince herkes oynayabilir.

Şimdi Ne Yapmalıyım?

• Launcher'daki "Tutorial" oyununu oyna, daha fazla özellik öğrenirsin
• GUI Customization Guide: arayüzü tamamen özelleştir
• Lemma Soft Forums: topluluk, yardım, kaynak paylaşımları
• Ren'Py Dokümantasyonu: resmi rehber (İngilizce)

Topluluk Kaynakları (Community & Plugins)

Ren'Py'nin en güçlü yanlarından biri kocaman bir topluluğu. Yüzlerce geliştirici ücretsiz efektler, arayüz şablonları, mini oyun motorları ve araçlar paylaşıyor.

Aşağıda 20 adet kurulu kütüphane kod örnekleriyle anlatılıyor.

Nerede Takılırsan Nereye Sor?

Eklenti Nasıl Kurulur?

Mod Nasıl Kurulur?

    show defne mutlu
    show expression Glitch("defne mutlu") as glitch_char  # bu satırı ekle
    d "Ne oluyor?!"

Glitch, CRT, hologram, ateş, parçacıklar, dalga... Oyununa sinematik atmosfer kat. Karta tıkla, kodu gör.

⚡

ChromaGlitch: Glitch Efekti GitHub ↗

DDLC tarzı RGB kayması + yatay dilim bozulması. Arka plan veya sprite'a tek satırla uygulanır.

S3 stüdyo çatışmasıbeat drop anıkavga & gerilimkötü son kapısı

▶

    # Arka plana glitch uygula
    show expression Glitch("bg sokak") as glitch_bg
    pause 0.5
    scene bg sokak   # Normal haline dön

    # Karakter sprite'ına glitch
    show expression Glitch("defne kizgin") as glitch_char

    # İnce ayar: offset büyük + her seferinde farklı glitch
    glitch("bg sokak", offset=60, randomkey=None)

    # Sürekli titreyen glitch animasyonu
    show expression animated_glitch("bg sokak", timeout_base=0.08) as glitch_bgkopyala

⚙ Parametreler

offsetDilim kayma miktarı (piksel). Yükseldikçe daha sert glitch. varsayılan: 30

randomkeyNone = her renderda farklı görünür. Sabit değer = hep aynı glitch desenini üretir. varsayılan: otomatik

chromaKromatik aberasyon (RGB kayması) açık/kapalı. varsayılan: True

minbandheightBir dilimin minimum piksel yüksekliği. Küçük = çok ince dilimler. varsayılan: 1

timeout_base(animated_glitch) Glitch titreme hızı saniye cinsinden. 0.08 = çok hızlı. varsayılan: 0.1

    # Sahneye RGB split uygula
    show bg studyo at rgb_split_transform
    with vpunch
    d "Ne yaptın sen?!"kopyala

    # Metin dalgalandırma (text tag)
    d "{wave}Her şey dönüyor...{/wave}"

    # Sahne dalga efekti (ATL ile)
    show bg klub:
        parallel:
            function WaveShader()   # Sürekli dalga: asla bitmez
        parallel:
            3.0   # 3 sn sonra dur
    show bg klub  # Normal hale dönkopyala

    # Flashback sahne: eski TV efekti
    show expression CRT("bg cocukluk_evi") as crt_bg
    d "{fi}O günü hatırlıyorum...{/fi}"
    scene bg cocukluk_evi  # Normal haline dönkopyala

👁️

SWHolo: Hologram Efekti GitHub ↗

Mavi ton + tarama çizgisi + titreşim. Karakteri "sanal varlık" gibi sunar.

S8 Demir telefon sahnesiprojeksiyon / hologramuzaktan iletişim

▶

game/libs/holo/

    # Karakter hologram olarak belirsin
    show expression Holo("demir ciddi") as demir_holo
    d "Demir'in hologramı belirdi."

    # Renk ve yoğunluk ayarla (options.rpy'e veya script başına ekle):
    define holovalues.tintcolor = "#06f"    # Mavi (varsayılan)
    define holovalues.totalpha   = 0.9      # Genel saydamlık
    define holovalues.lineheight = 4        # Tarama çizgisi kalınlığıkopyala

⚙ Parametreler: script başına tanımla

tintcolorHologram rengi. "#06f" = mavi, "#0f6" = yeşil, "#f06" = kırmızı. varsayılan: "#06f"

totalphaHologramın genel saydamlığı. 0.0 = görünmez, 1.0 = tam opak. varsayılan: 0.9

interalphaÇizgiler arası saydamlık. Düşürdükçe tarama efekti güçlenir. varsayılan: 0.75

blinkingTitreşim/yanıp sönme sıklığı. 0.0 = hiç, 1.0 = sürekli. varsayılan: 0.5

lineheightTarama çizgilerinin kalınlığı (piksel). varsayılan: 4

    # Neon ışığı overlay olarak ekle
    show expression Screen("neon_isik.png", "bg sokak") as lit_bg

    # Karanlık sahne: multiply ile gölge
    show expression Multiply("golge.png", "bg oda") as dark_bgkopyala

    # Karaktere neon dış çizgi
    show defne mutlu at outline(color="#ff00ff", width=3)kopyala

    # Sahnenin altına ateş şeridi
    show expression DoomFire(1280, 200) as fire_effect
    d "Stüdyo yanıyor!"
    hide fire_effect  # Bitince kaldır

    # İnce ayar: daha küçük, daha yoğun ateş
    show expression DoomFire(400, 120, fire_mult=2.0) as fire_smallkopyala

    # Konfeti efekti (konser/kutlama)
    show expression Particles("confetti.png") as confetti
    d "Sahne patladı!"

    # Duman efekti (klüp/stüdyo)
    show expression Particles("smoke.png") as smokekopyala

Fare hareketine tepki veren 3D parallax arka planlar. Statik bir sahneye derinlik ve hareket katar, oyuncunun dikkatini hikayeye çeker.

Visual novel'lerde arka planlar genelde sabit durur. Fare takipli parallax efektiyle sahneye derinlik katabilirsin: fare hareket ettikçe arka plan hafifçe kayar, eğilir ve yakınlaşır. Tek bir görsel ile 3D his yaratırsın.

Canlı Önizleme

Fareyi aşağıdaki sahnenin üzerinde gezdirin:

fareyi gezdirin

init python:
    class ParallaxBG(renpy.Displayable):

        def __init__(self, path, shift=40, tilt=3.0, smooth=0.05, **kwargs):
            super(ParallaxBG, self).__init__(**kwargs)
            self.image = Image(path)
            self.shift = shift    # piksel cinsinden kayma miktarı
            self.tilt = tilt      # derece cinsinden eğim
            self.smooth = smooth  # lerp hızı (0-1, düşük = yumuşak)
            self.sx = 0.0
            self.sy = 0.0

        def render(self, width, height, st, at):
            mx, my = renpy.get_mouse_pos()

            # Fare pozisyonunu -1..1 aralığına normalize et
            nx = max(-1.0, min(1.0, (mx / max(1.0, float(width)) - 0.5) * 2.0))
            ny = max(-1.0, min(1.0, (my / max(1.0, float(height)) - 0.5) * 2.0))

            # Yumuşak takip (lerp)
            self.sx += (nx - self.sx) * self.smooth
            self.sy += (ny - self.sy) * self.smooth

            # Dinamik zoom: merkez=1.12, kenar=1.08
            dist = min(1.0, (self.sx ** 2 + self.sy ** 2) ** 0.5)
            dyn_zoom = 1.12 - dist * 0.04

            # 3D perspektif eğimi
            rx = -self.sy * self.tilt
            ry = self.sx * self.tilt

            t = Transform(self.image,
                zoom=dyn_zoom,
                anchor=(0.5, 0.5),
                align=(0.5, 0.5),
                subpixel=True,
                perspective=True,
                matrixtransform=Matrix.rotate(rx, ry, 0)
            )

            cr = renpy.render(t, width, height, st, at)
            cw, ch = cr.get_size()

            ox = (width - cw) / 2.0 - self.sx * self.shift
            oy = (height - ch) / 2.0 - self.sy * self.shift * 0.5

            r = renpy.Render(width, height)
            r.subpixel_blit(cr, (ox, oy))

            renpy.redraw(self, 0)
            return r

        def event(self, ev, x, y, st):
            return None

        def visit(self):
            return [self.image]

# Arka planları parallax ile tanımla
image bg kafe gunduz = ParallaxBG("images/bg/bg kafe gunduz.jpg")
image bg kafe aksam  = ParallaxBG("images/bg/bg kafe aksam.jpg")kopyala

Karakter sprite'larına nefes animasyonu ve fare parallax'ı ekleyerek sahneye canlılık kat. Ek asset gerekmez, tek sprite yeterli.

Statik bir sprite sahnede durduğunda "karton" hissi verir. İki basit efektle bunu kırabilirsin:

• Nefes animasyonu: Sprite çok hafif zoom salınımı yapar (bilinçaltı canlılık)
• Fare parallax: Arka plandan daha az kayma. BG ile karakter arasındaki hız farkı derinlik yaratır

Canlı Önizleme

Fareyi sahnenin üzerinde gezdirin, karakterin BG'den bağımsız hareket ettiğine dikkat edin:

fareyi gezdirin

    class ParallaxSprite(renpy.Displayable):

        def __init__(self, child, shift=5, breath_amount=0.004, breath_speed=0.3, **kwargs):
            super(ParallaxSprite, self).__init__(**kwargs)
            self.child = renpy.displayable(child)
            self.shift = shift              # fare kayma (BG'den çok daha az)
            self.breath_amount = breath_amount  # nefes genliği (%0.4)
            self.breath_speed = breath_speed    # nefes hızı (Hz)
            self.sx = 0.0
            self.sy = 0.0
            self.cur_breath = 1.0

        def render(self, width, height, st, at):
            import math

            sw = float(renpy.config.screen_width or 1920)
            sh = float(renpy.config.screen_height or 1080)
            mx, my = renpy.get_mouse_pos()
            nx = max(-1.0, min(1.0, (mx / sw - 0.5) * 2.0))
            ny = max(-1.0, min(1.0, (my / sh - 0.5) * 2.0))
            self.sx += (nx - self.sx) * 0.03
            self.sy += (ny - self.sy) * 0.03

            # Nefes: sinüs dalgası ile yumuşak zoom salınımı
            target = 1.0 + math.sin(st * 2.0 * math.pi * self.breath_speed) * self.breath_amount
            self.cur_breath += (target - self.cur_breath) * 0.02

            cr = renpy.render(self.child, width, height, st, at)
            cw, ch = cr.get_size()

            bw = cw * self.cur_breath
            bh = ch * self.cur_breath
            ox = self.sx * self.shift + (cw - bw) * 0.5
            oy = self.sy * self.shift * 0.1 + (ch - bh)

            r = renpy.Render(int(cw), int(ch))
            r.subpixel_blit(cr, (ox, oy))

            renpy.redraw(self, 0)
            return r

        def event(self, ev, x, y, st):
            return None

        def visit(self):
            return [self.child]

# Karakter sprite'ını parallax ile tanımla
image lila normal = ParallaxSprite("images/chars/lila normal.png")kopyala

Aura titreşimi + kılıç hamlesi + parçalanma: tek .rpy dosyasına kopyala, çalışır. Harici modül gerekmez.

Canlı Önizleme

# ── parlayan_buton.rpy ── game/ klasörüne kaydet ──────────

# Aura: Pillow ile üretilmiş yumuşak gaussian glow PNG
# (Solid + blur kare görünür — PNG ile gerçek glow)
image p_aura = "images/fx/aura_glow.png"

# Sürekli titreyerek parlayan aura
transform p_aura_pulse:
    alpha 0.25
    linear 0.7 alpha 0.75
    linear 0.7 alpha 0.25
    repeat

# Buton stili (9-patch PNG ile border)
style p_buton is button:
    background Frame("images/fx/btn_bg.png", 4, 4, 4, 4)
    hover_background Frame("images/fx/btn_hover.png", 4, 4, 4, 4)
    padding (30, 16, 30, 16)

style p_buton_text is button_text:
    color "#4466bb"
    hover_color "#99ccff"
    outlines [(absolute(3), "#0044cc60", absolute(0), absolute(0))]
    hover_outlines [(absolute(4), "#4488ffaa", absolute(0), absolute(0))]
    size 26

screen parlayan_menu():
    add "p_aura" at p_aura_pulse:
        xalign 0.5 yalign 0.5
    textbutton "YENİ OYUN":
        style "p_buton"
        text_style "p_buton_text"
        xalign 0.5 yalign 0.5
        action Start()kopyala

# ── kilic_efekti.rpy ── game/ klasörüne kaydet ─────────────

# Aura: Pillow ile üretilmiş yumuşak glow PNG
image buton_aura = "images/fx/aura_glow.png"

# 3 katmanlı kılıç: beyaz çizgi + cyan parlama + mavi iz
image kilic_cizgi = Transform(Solid("#ffffff"), xsize=3000, ysize=10, rotate=-42)
image kilic_parlama = Transform(Solid("#66ddff"), xsize=3000, ysize=60, rotate=-42)
image kilic_iz = Transform(Solid("#3399ff"), xsize=3000, ysize=120, rotate=-42)

image kilic_flas = Solid("#cceeff")
image kilic_karanlik = Solid("#000000")
image parca_ust = "images/fx/parca_ust.png"
image parca_alt = "images/fx/parca_alt.png"

# Titreşen aura
transform aura_pulse:
    alpha 0.25
    linear 0.7 alpha 0.75
    linear 0.7 alpha 0.25
    repeat

# Vuruş öncesi karartma
transform karanlik_beat:
    alpha 0.0
    linear 0.08 alpha 0.4
    linear 0.06 alpha 0.0

# Çekirdek çizgi — hızlı çapraz geçiş
transform kilic_cizgi_hamle:
    alpha 1.0
    xalign 0.5 yalign 0.5
    xoffset -700 yoffset -500
    linear 0.10 xoffset 700 yoffset 500
    linear 0.08 alpha 0.0

# Parlama katmanı — hafif gecikmeli
transform kilic_parlama_hamle:
    alpha 0.8
    xalign 0.5 yalign 0.5
    xoffset -700 yoffset -500
    pause 0.02
    linear 0.10 xoffset 700 yoffset 500
    linear 0.12 alpha 0.0

# Dış iz — en gecikmeli, en geniş
transform kilic_iz_hamle:
    alpha 0.35
    xalign 0.5 yalign 0.5
    xoffset -700 yoffset -500
    pause 0.04
    linear 0.10 xoffset 700 yoffset 500
    linear 0.18 alpha 0.0

# Ekran flaşı
transform flas_efekti:
    alpha 0.0
    pause 0.08
    linear 0.03 alpha 0.9
    linear 0.5 alpha 0.0

# Ekran sarsıntısı
transform ekran_sarsinma:
    xoffset 0 yoffset 0
    easein 0.03 xoffset 14 yoffset -10
    easein 0.03 xoffset -12 yoffset 8
    easein 0.03 xoffset 8 yoffset -6
    easein 0.03 xoffset -5 yoffset 3
    easein 0.03 xoffset 0 yoffset 0

# Parçalanma
transform parca_ust_hareket:
    yoffset 0 alpha 1.0
    pause 0.12
    parallel:
        easein 0.5 yoffset -500
    parallel:
        linear 0.35 alpha 0.0

transform parca_alt_hareket:
    yoffset 0 alpha 1.0
    pause 0.12
    parallel:
        easein 0.5 yoffset 500
    parallel:
        linear 0.35 alpha 0.0

# Stil (9-patch PNG ile border + text glow)
style k_buton is button:
    background Frame("images/fx/btn_bg.png", 4, 4, 4, 4)
    hover_background Frame("images/fx/btn_hover.png", 4, 4, 4, 4)
    padding (30, 16, 30, 16)

style k_buton_text is button_text:
    color "#445599"
    hover_color "#88bbff"
    outlines [(absolute(3), "#0044cc60", absolute(0), absolute(0))]
    hover_outlines [(absolute(4), "#4488ffaa", absolute(0), absolute(0))]
    size 26

screen menu_aktif():
    add "buton_aura" at aura_pulse:
        xalign 0.5 yalign 0.5
    textbutton "YENİ OYUN":
        style "k_buton"
        text_style "k_buton_text"
        xalign 0.5 yalign 0.5
        action Jump("kilic_efekti_oynat")

screen menu_kesilmis():
    add "parca_ust" at parca_ust_hareket:
        xalign 0.5 yalign 0.5
    add "parca_alt" at parca_alt_hareket:
        xalign 0.5 yalign 0.5

label kilic_efekti_oynat:
    hide screen menu_aktif
    show kilic_karanlik at karanlik_beat
    pause 0.06
    show kilic_iz at kilic_iz_hamle
    show kilic_parlama at kilic_parlama_hamle
    show kilic_cizgi at kilic_cizgi_hamle
    show kilic_flas at flas_efekti
    show screen menu_kesilmis
    show bg kafe gunduz at ekran_sarsinma
    pause 1.2
    hide screen menu_kesilmis
    hide kilic_cizgi
    hide kilic_parlama
    hide kilic_iz
    hide kilic_flas
    hide kilic_karanlik
    jump start   # ← kendi label'ınla değiştirkopyala

İki görseli birleştirirken piksel başına karışım modu. Neon ışık, dramatik karanlık, kontrast efektleri: tek satırla sahneye katman ekle.

# Kurulum: screen.rpy, overlay.rpy vb. game/libs/blend-modes/'a koy
# Kullanım: cc_[mod]("alttaki görsel", "üstteki doku"): ikisini birleştirir

    # Screen: ışık dokusu ekle, arka plan parlar (neon glow, projektör)
    show expression cc_screen("bg_sehir", "images/isik_doku.png") as sahne

    # Overlay: kontrast güçlendir, koyu koyu açık açık olur (dramatik sahne)
    show expression cc_overlay("bg_sehir", "images/renk_katman.png") as sahne

    # Soft Light: hafif ışık, yumuşak atmosfer (şafak, gün batımı)
    show expression cc_soft_light("bg_park", "images/sicak_doku.png") as sahne

    # Bitince kaldır:
    hide sahnekopyala

Sallanan, patlayan, gradyan, dalgalanan metin. Diyaloglara hayat ver.

# Siyah dış çizgi: en temel okunabilirlik çözümü
define gui.text_outlines = [(2, "#000000", 0, 0)]
define gui.name_text_outlines = [(2, "#000000", 0, 0)]
define gui.interface_text_outlines = [(1, "#000000", 0, 0)]

# Sağ-alt gölge: sinema stili
define gui.text_outlines = [(2, "#00000099", 2, 2)]

# Neon glow: birden fazla katman üst üste
define gui.text_outlines = [
    (4, "#0044ff44", 0, 0),   # Dışta: mavi parlama (hafif saydam)
    (2, "#0088ffaa", 0, 0),   # Ortada: yoğun mavi
    (1, "#ffffff",   0, 0),   # İçte: beyaz ince çizgi
]kopyala

💬

Kinetic Text Tags: Animasyonlu Metin GitHub ↗

En popüler metin efekt kütüphanesi. Diyalog tag'leri olarak çalışır, kod gerektirmez.

duygusal patlama anıçılgın/sarhoş karakterbağırma diyaloğusistem mesajıtüm sahnelerde kullanılabilir

▶

    d "{bt}Bu metin zıplıyor!{/bt}"              # bounce: zıplayan
    d "{sc=3}Titriyorum!{/sc}"                   # scare: titreyen, N = şiddet
    d "{fi}Yavaşça hatırladım...{/fi}"           # fade-in: beliren
    d "{rotat=5}Dönen metin{/rotat}"             # rotate: dönen, N = derece
    d "{chaos}Sistem çöküyor{/chaos}"            # chaos: kaotik hareket
    d "{omega}Patlayan harfler!{/omega}"         # omega: patlayan
    d "{move=100}Kayan metin{/move}"             # move: yatay kayma, N = piksel
    d "{swap=Eski metin}Yeni metin{/swap}"       # swap: iki metin arası geçişkopyala

⚙ Tüm Tag Listesi

{bt}…{/bt}bounce: zıplayan harfler

{sc=N}…{/sc}scare: titreyen harfler, N = şiddet (1-10)

{fi}…{/fi}fade-in: harfler yavaşça belirir

{rotat=N}…{/rotat}rotate: dönen harfler, N = derece

{chaos}…{/chaos}chaos: harfler rastgele savrulur

{omega}…{/omega}omega: her harf ayrı yönde patlayarak kaybolur

{move=N}…{/move}move: harfler yatayda N piksel kayar

{swap=metin1}metin2{/swap}swap: iki metin arasında geçiş yapar

{wave}…{/wave}wave: dalgalanan harfler (ayrı eklenti: WaveShader)

{glitch}…{/glitch}glitch: bozuk metin efekti (ayrı eklenti: glitch_tag.rpy)

{gradient=#hex1,#hex2}…{/gradient}gradient: renk geçişi (ayrı eklenti: gradient_tags.rpy)

İç içe geçirme{bt}{sc=2}Hem zıplar hem titrer{/sc}{/bt}: tag'ler birleştirilebilir

Ren'Py'nin varsayılan arayüzünü tamamen değiştiren hazır temalar.

DM sahneleri, SMS, grup sohbet, bildirimler: modern oyunlar için şart.

📱

Messenger Emulator: Telegram Tarzı Mesajlaşma GitHub ↗

Gerçekçi sohbet arayüzü: metin, resim, ses mesajı, typing animasyonu, grup sohbet, tam DM hissi.

S4 Demir DM sahnesiS8 gece mesajlarıgıyabi karakter konuşmasısosyal medya DM

▶

    # Mesajlaşma sahnesine geç
    call messenger_start

    # Mesaj gönder (karakter tarafından)
    $ send_message("Demir", "Stüdyoya gel, acil.")
    $ send_message("Sen", "Ne oldu?")
    $ send_message("Demir", "Kontrat hazır. İmzalaman lazım.")kopyala

    # Telefon bildirimi tarzı
    $ renpy.notify("Demir seni takip etti")
    $ renpy.notify("Yeni mesaj: 'Stüdyoda buluşalım'")

    # Birden fazla bildirim üst üste görünür
    $ renpy.notify("1000 dinlenme!")
    $ renpy.notify("Yeni takipçi: @hana_music")kopyala

Visual novel'inin içine entegre edebileceğin mini oyun motorları.

Başarım, ansiklopedi, galeri, müzik çalar, Discord: oyununu profesyonel yapan sistemler.

    # Başarımları tanımla (en üstte)
    define achievement_list = [
        Achievement("first_record", "İlk Kayıt", "Stüdyoda ilk şarkını kaydet"),
        Achievement("met_demir", "Patron", "Demir'le tanış"),
        Achievement("viral", "Viral!", "1 milyon dinlenmeyi geç"),
    ]

    # Başarım ver (hikaye içinde)
    $ achievement.grant("met_demir")   # Popup belirir!kopyala

    # Ansiklopedi girişleri tanımla
    define enc = Encyclopaedia()

    define enc_demir = EncEntry(
        parent=enc,
        name="Demir",
        text=["Plak şirketinin patronu. Soğukkanlı, hesapçı."],
        locked=True    # Başlangıçta kilitli
    )

    # Hikaye içinde kilidi aç
    $ enc_demir.locked = Falsekopyala

    # Galeri tanımla
    init python:
        gp = GalleryPlus()
        gp.button("cg_konser")
        gp.image("cg konser_sahnesi")
        gp.condition("persistent.konser_goruldu")kopyala

    # Parçaları tanımla (manualtracks.rpy)
    init python:
        manual_music_tracks = [
            MusicTrack("Gece Lambası", "audio/gece_lambasi.ogg",
                       artist="Neon Cross", locked=False),
            MusicTrack("Sokak Felsefesi", "audio/sokak.ogg",
                       artist="Neon Cross", locked=True),
        ]kopyala

🎮

Discord Rich Presence GitHub ↗

Discord profilinde "Neon Cross oynuyor" gösterir. Arkadaşları oyunu fark eder, kendiliğinden yayılır.

Discord presencesahne adı gösterimioyun süresiücretsiz tanıtım

▶

    # settings.rpy'de yapılandır
    define discord_appid = "YOUR_APP_ID"
    define discord_details = "Bölüm 1: Stüdyo"
    define discord_state = "Seçim yapıyor..."kopyala

Kod editörü, hata ayıklama, görselleştirme: üretim sürecini hızlandıran araçlar.

Öğrenme Kaynakları

• Feniks Development. En kapsamlı Ren'Py programlama dersleri
• Ren'Py Patreon. Yaratıcının 30+ ileri seviye makalesi
• Lemma Soft Forums. Topluluk forumu, soru-cevap, kaynak paylaşımı
• awesome-renpy. 290+ kaynak listesi (her şey burada)

Ücretsiz Varlıklar (Free Assets & Themes)

Oyunun için her görseli kendin çizmek zorunda değilsin. Topluluk binlerce ücretsiz karakter, arka plan, müzik ve arayüz teması paylaşıyor, çoğu ticari projelerde de kullanılabilir.

🔍 Nerede Bakmalısın?

🎨 GUI ve Tema Paketleri

Varsayılan Ren'Py görünümü yerine hazır bir tema kullanabilirsin, tüm ekran dosyaları ve animasyonlar dahil geliyor, üzerine yaz yeter.

🧑‍🎨 Karakter Sprite Paketleri

🌆 Arka Plan Paketleri

🎵 Müzik ve Ses Efekti

🛠️ Geliştirici Araçları ve Script'ler

Önerilen Eklentiler (Recommended Plugins)

Topluluğun yıllar içinde en fazla tavsiye ettiği araçlar. Hepsi ücretsiz, kopyala yapıştır kurulumu. Karta tıkla, ne yaptığını ve nasıl kurulduğunu gör.

# ActionEditor çıktısı bu formatta gelir, elle yazmana gerek yok:
show kai mutlu at Position(xpos=0.3, ypos=0.1, xanchor=0.5, yanchor=0.0)
show marcus ciddi at Position(xpos=0.7, ypos=0.05, xanchor=0.5, yanchor=0.0)kopyala

# gui.rpy: bunları değiştir, tüm arayüz güncellenir:
define gui.accent_color = "#7df9ff"        # Ana renk (buton, başlık, vurgular)
define gui.hover_color = "#b4fcff"       # Üzerine gelince renk
define gui.text_font = "fonts/Benim.ttf"  # Oyun fontu
define gui.text_size = 28                 # Normal metin boyutu
define gui.title_text_size = 60           # Ana menü başlık boyutukopyala

# Terminal: proje kök klasöründe çalıştır
renpy-graphviz game/ --output hikaye-haritasi.png

# SVG formatında (yakınlaştırılabilir, büyük projeler için):
renpy-graphviz game/ --output hikaye-haritasi.svg --format svgkopyala

# script.rpy: telefon sahnesinde kullan
label mesaj_sahnesi:
    call screen messenger_screen:
        message "kai" "Neredesin?" side="left"
        message "player" "Yoldayım." side="right"
        message "kai" "Çabuk gel." side="left"kopyala

# ÜST BÖLGE: başarımları tanımla
define a_ilk_secim = Achievement(
    name="İlk Adım",
    description="İlk seçimini yaptın."
)
define a_gizli_son = Achievement(
    name="Karanlık Yol",
    description="Gizli sonu buldun.",
    hidden=True
)

# ALT BÖLGE: oyuncu seçim yapınca kazandır
label ilk_karar:
    menu:
        "Kabul et":
            $ a_ilk_secim.grant()   # 🏆 popup çıkar!
            jump devamkopyala

# Tek bildirim, köşede belirip kaybolur
$ notify("Yeni mesaj geldi.")

# Aynı anda birden fazla bildirim
$ notify("🏆 Başarım: İlk Adım")
$ notify("📍 Bölüm 2: Park")

# Eşya bulma sahnesinde:
label esya_bul:
    $ notify("🔑 Anahtar bulundu!")
    "Yerde bir anahtar var. Cebime attım."kopyala

🏁 İlk Projeyi Nasıl Bitirirsin?

Ren'Py topluluğunda en çok duyulan şikayet şu: "Harika bir fikrim vardı, 3 ay uğraştım, yarıda bıraktım." Sebebi teknik değil, işi fazla büyütmek.

MVP Kuralı: Minimal Çalışan Proje

İlk oyunun için bu sınırları kendine koy:

Scope Kontrol Listesi

☕ Örnek Oyun: Kahve Molası

Rehberde anlatılan her şeyi kullanan minik bir oyunu birlikte yapıyoruz. Sonunda elinde çalışan, iki farklı sona giden bir oyun olacak.

Hiç Ren'Py açmamış birine göre yazıldı: hangi dosyayı nereye koyduğumuzu, neden o satırı yazdığımızı, hangi görseli hangi klasöre attığımızı tek tek söyleyeceğim.

Hikaye özeti: Sen kafede kitap okuyorsun. Lila adında biri yanına gelip oturuyor. Onunla konuşur musun, yoksa kitabını mı okumaya devam edersin? Akşam olduğunda Lila kalkıyor. Gece sokakta yalnız mısın, yoksa Lila ile birlikte mi yürüyorsun? Verdiğin her seçim ruh_hali değişkenini değiştiriyor; oyun sonu o değişkene göre belirleniyor.

1. Adım: Yeni Proje Aç

Ren'Py launcher'ı aç (İlk Projen bölümünde anlatıldı). Sol tarafta + Create New Project'e tıkla. Sırasıyla:

Açılan klasörde game/ içinde şu dosyaları göreceksin: script.rpy (asıl hikaye), options.rpy (oyun ayarları), screens.rpy (arayüz), gui.rpy (görünüm). Yapacağımız iş %90 oranında script.rpy'de geçecek.

2. Adım: Klasörleri Kontrol Et

game/ klasörünü aç. Ren'Py proje oluşturduğunda bu klasörleri ve dosyaları zaten yaratmış olur:

game/
├── images/    ← arka plan ve karakter çizimleri buraya
├── audio/     ← müzik ve ses dosyaları buraya
├── script.rpy
├── options.rpy
├── screens.rpy
└── gui.rpy

images/ ve audio/ hazır durumda. Dosya Yapısı bölümünde de anlatıldığı gibi, Ren'Py images/ klasöründeki görselleri otomatik tanır, dosya adından bir image tag üretir. Yani images/bg kafe gunduz.jpg dosyası varsa, scene bg kafe gunduz yazınca onu kullanır. Dosya adındaki boşluklar tag'e dönüşür.

3. Adım: Asset'leri İndir ve Yerleştir

ZIP'i açtığında içinden images/ ve audio/ klasörleri çıkacak. Bunları game/ klasörünün içine kopyala. Sonuç şöyle olmalı:

game/
├── images/
│   ├── bg kafe gunduz.jpg
│   ├── bg kafe aksam.jpg
│   ├── bg sokak gece.jpg
│   └── lila normal.png
├── audio/
│   └── kafe.ogg
├── script.rpy
└── ...

Dosya isimleri tam olarak yukarıdaki gibi olsun: küçük harf, boşluklu. Ren'Py boşlukları ayraç olarak kullanır.

4. Adım: script.rpy'yi Tamamen Sil ve Sıfırdan Yaz

Launcher'da script.rpy'ye tıkla, varsayılan editör (Atom/VS Code) açılır. İçindeki her şeyi sil. Korkma, yedeği zaten launcher'dan tek tıkla geri alınır. Aşağıdaki kodu parça parça yazacağız.

5. Adım: Karakterleri Tanımla

İlk olarak konuşacak kişileri tanımlıyoruz. Karakterler bölümünde detayı var.

# --- Karakterler ---
define ben = Character("Sen", color="#7df9ff")
define l   = Character("Lila", color="#ff9de2")
define n   = Character(None, what_color="#9aa3ad", what_italic=True)

Neden böyle? ben ana karakter (oyuncu): neon mavi rengi seçtim çünkü kafedeki yapay ışıkla uyuyor. l Lila: pembe, soft bir karakter olduğunu hissettiriyor. n ise narrator: ismi yok (None), italik yazılır, gri tonda, ortam anlatımı için.

6. Adım: Değişkeni Oluştur

Hikayenin sonunu belirleyecek tek bir sayı kullanacağız: ruh_hali. Lila ile yakınlaşırsan artar, yalnız kalırsan düşer.

# --- Değişkenler ---
default ruh_hali = 0

# --- Karakterler ---
define ben = Character("Sen", color="#7df9ff")
define l   = Character("Lila", color="#ff9de2")
define n   = Character(None, what_color="#9aa3ad", what_italic=True)

# --- Değişkenler ---
default ruh_hali = 0

# (label start buraya gelecek, bir sonraki adımda)

7. Adım: Açılış Sahnesi

Şimdi oyunun ilk anını yaz. label start: Ren'Py'nin nereden başlayacağını söylediği özel etiket, her oyunda olmak zorunda.

label start:

    scene bg kafe gunduz
    with fade

    play music "audio/kafe.ogg" fadein 2.0

    n "Pencere kenarındaki masada oturuyorsun. Önünde yarım kahve, kucağında kitap."
    n "Kafenin uğultusu kulak yormuyor, alıştığın bir ses."

    ben "Bugünlük başka kimseyi görmesem iyi olur."

Satır satır ne yaptık:

• scene bg kafe gunduz: bg kafe gunduz.jpg dosyasını arka plan yapar. Ekrandaki her şeyi siler, sadece bunu gösterir.
• with fade: siyahtan açılır. Geçişler bölümündeki fade efekti.
• play music "audio/kafe.ogg" fadein 2.0: Müzik 2 saniyede yumuşakça açılır. Müzik bölümü tam burayı anlatıyor.
• n "...": Narrator konuşuyor, italik gri.
• ben "...": Sen konuşuyorsun, neon mavi.

8. Adım: Lila Sahneye Girsin

Şimdi karakter sprite'ını ekrana getiriyoruz. Görseller ve Pozisyonlar bölümlerinin uygulaması:

    show lila normal at center
    with dissolve

    l "Buraya oturmamın bir sakıncası var mı?"
    n "Başını kaldırıyorsun. Tanımıyorsun ama gözleri tanıdık."

Dikkat edilen noktalar:

• show lila normal: lila normal.png dosyasını sahneye ekler. scene'in aksine arka planı silmez, üstüne ekler.
• at center: Ortaya konumlanır. at left veya at right da var.
• with dissolve: Sprite yumuşakça beliriyor. fade ekranı karartır, dissolve sadece değişen şeyi karşıtırır: karakter girişi için doğru olan budur.

    show lila normal at Position(xpos=0.4, ypos=0.05, xanchor=0.5, yanchor=0.0)
    with dissolve

9. Adım: İlk Seçim Menüsü

Burada oyuncu ilk kararı verecek. Menüler bölümündeki yapı:

    menu:
        "Otur, hoş geldin de.":
            $ ruh_hali += 1
            jump lila_konus
        "Kitabıma dön, görmezden gel.":
            $ ruh_hali -= 1
            jump kitap_oku

10. Adım: İki Dal: Konuşma vs Kitap

label lila_konus:
    l "Ben Lila."
    ben "Ben de...{w=0.5} pek konuşkan biri değilim aslında."
    l "{sc=2}Sorun değil{/sc}. Sessizce de oturulabilir burada."
    n "Gülümsüyor. Kitabını çantadan çıkarıp masaya koyuyor."
    jump aksam_oluyor

label kitap_oku:
    n "Başını kitabına gömüyorsun. Lila bir süre bekliyor, sonra çantasından kendi kitabını çıkarıyor."
    n "İkiniz de aynı masada, ama farklı dünyalardasınız."
    jump aksam_oluyor

11. Adım: Akşamı Getir (Gündüz → Akşam Geçişi)

label aksam_oluyor:
    n "Pencerenin dışındaki gökyüzü turuncuya dönüyor."

    scene bg kafe aksam
    show lila normal at center
    with Dissolve(4.0)

    l "Geç oldu. Ben kalkayım."

Buradaki sihir: with Dissolve(4.0) (büyük D ile ve parantezli). 4 saniyelik özel bir geçiş. Gündüz arka planı, yavaşça akşam arka planına dönüşüyor. Karakter sahneye yeniden konduğu için aynı yerde kalıyor ama ortam değişti. Geçişler bölümünün ikinci yarısında bu detayı verdim.

12. Adım: İkinci Seçim Menüsü

    menu:
        "'Birlikte yürüyelim mi?' diye sor.":
            $ ruh_hali += 1
            jump birlikte_yuru
        "'Kendine iyi bak' de, otur.":
            $ ruh_hali -= 1
            jump yalniz_kal

13. Adım: Sokağa Çıkış ve İki Son

label birlikte_yuru:
    hide lila
    scene bg sokak gece
    with fade

    show lila normal at center
    with dissolve

    n "Soğuk ama temiz bir hava. Yan yana yürüyorsunuz."
    l "Bu kafeye sık geliyor musun?"
    ben "Artık daha sık geleceğim galiba."

    jump son

label yalniz_kal:
    n "Lila kapıdan çıkıyor. Pencereden onu izliyorsun."
    n "Yarısı kalmış kahve, yarısı okunmuş kitap, ve bir tanıdık daha az."

    scene bg sokak gece
    with fade

    n "Eve dönüş yolundasın. {sc=3}Yalnız.{/sc}"
    jump son

14. Adım: Koşullu Final

label son:
    stop music fadeout 3.0

    if ruh_hali >= 2:
        n "Bazı tanışmalar planlanmaz; sadece olur."
        n "İyi bir gündü."
    elif ruh_hali == 0:
        n "Belki başka bir gün, başka bir kafede."
    else:
        n "Bir kapı kapandı. Belki açıktı, sen mi kapadın?"

    pause 2.0

    n ". Son. "

    return

Final kısmı 3 farklı son veriyor:

• stop music fadeout 3.0: Müzik 3 saniyede sönüyor.
• if / elif / else: Python koşulu (Değişkenler bölümündeki örneklerin uygulaması). Her iki seçimi de "Lila yönünde" yaptıysa ruh_hali 2 olur, mutlu son. Eşitse nötr son. Negatifse hüzünlü son.
• pause 2.0: 2 saniye boşluk, oyuncu nefes alsın.
• return: Ana menüye döner. Oyunu Bitirme bölümünde anlatıldı.

15. Adım: Metin Etiketleri ile Diyalogları Canlandır

Şimdi sade diyalogları daha dramatik yapalım. Metin Etiketleri bölümündeki {w}, {cps}, {color}, {nw}/{fast} ve {b} etiketlerini script'e serpiştiriyoruz:

# Açılış sahnesinde (label start):
    n "Pencere kenarındaki masada oturuyorsun.{w=0.8} Önünde yarım kahve, kucağında kitap."

# Lila girişinde:
    l "{cps=15}Buraya oturmamın...{/cps}{cps=*2} bir sakıncası var mı?{/cps}"

# Birlikte yürürken (label birlikte_yuru):
    ben "Artık daha sık geleceğim {color=#ff9de2}galiba{/color}."

# Yalnız kalırken (label yalniz_kal): metin birleştirme:
    n "Eve dönüş yolundasın.{nw}"
    n "Eve dönüş yolundasın.{fast} {b}Yalnız.{/b}"kopyala

16. Adım: Ses Efekti ve Gelişmiş Müzik

Müzik bölümünde öğrendiğimiz fadein, if_changed, volume ve ses efektlerini kullanalım:

# Açılış sahnesinde (label start): müzik yavaşça açılsın:
    play music "audio/kafe.ogg" fadein 2.0 volume 0.6

# Lila otururken: bardak sesi:
    play sound "audio/bardak.ogg"
    l "Buraya oturmamın bir sakıncası var mı?"

# Akşam sahnesinde: aynı müzik kesintisiz devam etsin:
    play music "audio/kafe.ogg" if_changed

# Sokak sahnesinde: farklı müzik geçişi:
    play music "audio/gece.ogg" fadeout 1.5 fadein 2.0kopyala

17. Adım: gui.rpy ile Görünümü Özelleştir

Özelleştirme ve Metin Efektleri bölümlerinin uygulaması. gui.rpy dosyasını aç ve şu satırları bul, değiştir:

Renk Teması

# Renk teması
define gui.accent_color = '#7df9ff'          # Neon mavi vurgu
define gui.text_color = '#ffffff'            # Beyaz diyalog metni
define gui.hover_color = '#ffffff'           # Buton hover

# Metin dış çizgisi: arka plan ne olursa olsun yazı okunur
define gui.text_outlines = [(2, "#000000", 0, 0)]
define gui.name_text_outlines = [(2, "#000000", 0, 0)]

# Pencere başlığı
define config.name = _("Kahve Molası")
define config.version = "1.0"
define gui.show_name = Truekopyala

Font Değiştir

Varsayılan font sıkıcı görünür. Ücretsiz bir font indir (Google Fonts'tan .ttf dosyası) ve game/ klasörüne at. Sonra gui.rpy'de şu satırı bul ve değiştir:

# Font dosyasını game/ klasörüne at, sonra burada adını yaz:
define gui.text_font = "NotoSansTR-Regular.ttf"
define gui.name_text_font = "NotoSansTR-Bold.ttf"kopyala

Diyalog Kutusu ve İsim Kutusu

Varsayılan diyalog kutusu düz siyah bir dikdörtgen. Kendi görselini koymak oyunun havasını tamamen değiştirir.

game/gui/
├── textbox.png     ← diyalog kutusu (1920×335 px)
├── namebox.png     ← karakter isim kutusu (413×57 px)
└── overlay/
    ├── main_menu.png   ← ana menü arka planı (1920×1080)
    └── game_menu.png   ← kayıt/yükleme menüsü arka planı

# Diyalog kutusu arka plan rengi (RGBA: son değer saydamlık)
define gui.textbox_height = 278
define gui.text_xpos = 268
define gui.text_ypos = 50

Menü Seçenek Butonları

Oyuncu seçim yaparken ("Otur, hoş geldin de" / "Kitabıma dön") butonların görünümü önemli. gui.rpy'de:

# Seçim butonları boyutu
define gui.choice_button_width = 1185
define gui.choice_button_height = None     # İçeriğe göre otomatik
define gui.choice_button_text_font = "NotoSansTR-Regular.ttf"
define gui.choice_button_text_size = 33
define gui.choice_button_text_idle_color = '#cccccc'
define gui.choice_button_text_hover_color = '#ffffff'kopyala

Daha ileri gitmek istersen gui/button/ klasöründeki görselleri de değiştirebilirsin:

game/gui/button/
├── choice_idle_background.png    ← normal hali
└── choice_hover_background.png   ← fare üstündeyken

Hazır GUI Template (opsiyonel)

Elle her şeyi ayarlamak yerine, topluluk tarafından yapılmış hazır GUI şablonları var. İndir, game/ klasörüne at, anında profesyonel görünüm:

18. Adım: Autofocus: Konuşmayana Otomatik Karartma

Kamera & Animasyon bölümündeki Autofocus eklentisi. İki karakter sahnedeyken, konuşmayan otomatik kararır, sıfır ek kod. Kurulum:

# autofocus.rpy dosyasını GitHub'dan indir,
# game/ klasörüne at. Sonra script.rpy'nin üstüne ekle:

define autofocus.dim = 0.5       # Konuşmayan %50 karartma
define autofocus.blur = 1.5      # Hafif bulanıklık
define autofocus.duration = 0.3  # Geçiş süresikopyala

Bu kadar. Artık sahnede birden fazla karakter varken, konuşan karaktere otomatik odaklanılır. Kahve Molası'nda tek karakter var ama ikinci bir karakter (mesela barista) eklersen farkı hemen görürsün.

19. Adım: Başarım (Achievement) Sistemi Ekle

Eklentiler bölümündeki Achievements eklentisini kur (achievements.rpy dosyasını game/ klasörüne at). Sonra başarımları tanımla:

define a_ilk_sohbet = Achievement(
    name="İlk Sohbet",
    description="Lila ile konuştun."
)
define a_gece_yuruyusu = Achievement(
    name="Gece Yürüyüşü",
    description="Lila ile birlikte yürüdün."
)kopyala

# label lila_konus'un başına ekle:
    $ a_ilk_sohbet.grant()

# label birlikte_yuru'nun başına ekle:
    $ a_gece_yuruyusu.grant()kopyala

Oyuncu başarımı açınca ekranın köşesinde popup çıkar. Detaylı kurulum ve gizli başarımlar için Eklentiler bölümüne bak.

20. Adım: Bildirim Popup'ları

Ren'Py'nin yerleşik bildirim fonksiyonu: ekranın köşesinde küçük bir mesaj belirir, birkaç saniye sonra kaybolur. Ek dosya gerektirmez:

# Lila girişinden sonra:
    $ renpy.notify("Yeni karakter tanındı: Lila")

# Birlikte yürürken:
    $ renpy.notify("Başarım: Gece Yürüyüşü 🌙")

# Final'de, mutlu sonda:
    $ renpy.notify("Tebrikler! İyi son.")kopyala

21. Adım: Karakter Giriş Animasyonu (offscreenleft)

Pozisyonlar bölümündeki offscreenleft ile karakter ekran dışından yürüyerek girsin:

# Lila sahneye girişini değiştir (label start):
    show lila normal at offscreenleft
    with None   # Sessizce ekran dışına koy

    show lila normal at center
    with move   # Soldan ortaya kayarak gelir

    play sound "audio/bardak.ogg"kopyala

22. Adım: Blend Mode ile Atmosfer Katmanı

Blend Mode bölümündeki teknikle kafe sahnesine sıcak ışık efekti ekle. Bunun için images/ klasörüne bir ışık doku görseli at:

# script.rpy: define bloğuna ekle:
image kafe_isik = im.MatrixColor("images/isik_doku.png",
    im.matrix.opacity(0.3))

# label start'ta sahne kurduktan sonra:
    scene bg kafe gunduz
    with fade
    show kafe_isik  # Sıcak ışık katmanı arka planın üstüne eklenirkopyala

Turuncu-sarı bir PNG (lens flare, bokeh veya gradient) koyarsan kafenin sıcak ışığı hissedilir. im.matrix.opacity(0.3) %30 saydamlık verir, çok baskın olmasın.

23. Adım: Test Et

Launcher'a dön. kahve-molasi seçili haldeyken sağ tarafta yeşil Launch Project (veya Play) butonuna bas. Oyun açılacak.

24. Adım: Dağıtım Build'i

Bittiyse paketleyelim. Launcher'da kahve-molasi seçili, sağ menüde Build Distributions'a tıkla. Açılan ekranda:

Tamamlanmış script.rpy: Kopyala-Yapıştır

Aşağıdaki blok, yukarıda parça parça yazdığımız her şeyin tek dosyaya birleştirilmiş halidir. Bonus bölümlerindeki özellikler dahil: metin etiketleri, ses efekti, bildirimler, offscreen giriş. script.rpy'yi aç, içini sil, bunu yapıştır:

# ═══════════════════════════════════════════
# Kahve Molası: örnek oyun (bonus dahil)
# ═══════════════════════════════════════════

# --- Karakterler ---
define ben = Character("Sen", color="#7df9ff")
define l   = Character("Lila", color="#ff9de2")
define n   = Character(None, what_color="#9aa3ad", what_italic=True)

# --- Autofocus ayarı (autofocus.rpy kuruluysa) ---
define autofocus.dim = 0.5
define autofocus.blur = 1.5
define autofocus.duration = 0.3

# --- Özel geçiş tanımları ---
define yavas_gecis = Dissolve(4.0)
define dramatik_fade = Fade(0.5, 1.0, 0.5)

# --- Değişkenler ---
default ruh_hali = 0

# --- Hikaye başlangıcı ---
label start:

    scene bg kafe gunduz
    with fade

    play music "audio/kafe.ogg" fadein 2.0 volume 0.6

    n "Pencere kenarındaki masada oturuyorsun.{w=0.8} Önünde yarım kahve, kucağında kitap."
    n "Kafenin uğultusu kulak yormuyor, alıştığın bir ses."

    ben "Bugünlük başka kimseyi görmesem iyi olur."

    # Lila ekran dışından yürüyerek girer
    show lila normal at offscreenleft
    with None
    show lila normal at center
    with move

    play sound "audio/bardak.ogg"

    l "{cps=15}Buraya oturmamın...{/cps}{cps=*2} bir sakıncası var mı?{/cps}"
    n "Başını kaldırıyorsun. Tanımıyorsun ama gözleri tanıdık."
    $ renpy.notify("Yeni karakter: Lila")

    menu:
        "Otur, hoş geldin de.":
            $ ruh_hali += 1
            jump lila_konus
        "Kitabıma dön, görmezden gel.":
            $ ruh_hali -= 1
            jump kitap_oku

label lila_konus:
    l "Ben Lila."
    ben "Ben de...{w=0.5} pek konuşkan biri değilim aslında."
    l "{sc=2}Sorun değil{/sc}. Sessizce de oturulabilir burada."
    n "{fi}Gülümsüyor. Kitabını çantadan çıkarıp masaya koyuyor.{/fi}"
    jump aksam_oluyor

label kitap_oku:
    n "Başını kitabına gömüyorsun.{w=1.0} Lila bir süre bekliyor, sonra çantasından kendi kitabını çıkarıyor."
    n "{i}İkiniz de aynı masada, ama farklı dünyalardasınız.{/i}"
    jump aksam_oluyor

label aksam_oluyor:
    n "Pencerenin dışındaki gökyüzü turuncuya dönüyor."

    play music "audio/kafe.ogg" if_changed

    scene bg kafe aksam
    show lila normal at center
    with yavas_gecis

    l "Geç oldu. Ben kalkayım."

    menu:
        "'Birlikte yürüyelim mi?' diye sor.":
            $ ruh_hali += 1
            jump birlikte_yuru
        "'Kendine iyi bak' de, otur.":
            $ ruh_hali -= 1
            jump yalniz_kal

label birlikte_yuru:
    hide lila
    scene bg sokak gece
    with fade

    play music "audio/gece.ogg" fadeout 1.5 fadein 2.0

    show lila normal at center
    with dissolve

    $ renpy.notify("Gece Yürüyüşü 🌙")

    n "Soğuk ama temiz bir hava. Yan yana yürüyorsunuz."
    l "Bu kafeye sık geliyor musun?"
    ben "Artık daha sık geleceğim {color=#ff9de2}galiba{/color}."

    jump son

label yalniz_kal:
    n "Lila kapıdan çıkıyor. Pencereden onu izliyorsun."
    n "Yarısı kalmış kahve, yarısı okunmuş kitap, ve bir tanıdık daha az."

    scene bg sokak gece
    with dramatik_fade

    play music "audio/gece.ogg" fadeout 1.5 fadein 2.0

    n "Eve dönüş yolundasın.{nw}"
    n "Eve dönüş yolundasın.{fast} {b}Yalnız.{/b}"
    jump son

label son:
    stop music fadeout 3.0

    if ruh_hali >= 2:
        $ renpy.notify("İyi Son ✨")
        n "{cps=10}Bazı tanışmalar planlanmaz...{/cps}{w=0.5} sadece olur."
        n "İyi bir gündü."
    elif ruh_hali == 0:
        n "Belki başka bir gün, başka bir kafede."
    else:
        n "Bir kapı kapandı.{w=0.8} Belki açıktı, sen mi kapadın?"

    pause 2.0

    n "{size=+6}~ Son ~{/size}"

    return

Son Söz

Bu oyunda artık sadece temel komutlar değil, bonus bölümlerindeki özelliklerin çoğunu da kullandık: