Blok 2 projesi: terminalde metin tabanlı oyun

Blok 2'nin son dersine geldin. Bu derste şimdiye kadar öğrendiğin her şeyi tek bir projede birleştiriyorsun: terminalde oynanan, menüsü, savaşı, dükkânı ve kayıt dosyası olan küçük bir rol yapma oyunu (RPG). Kodu modüllere böleceksin, oyuncuyu bir sınıfla tutacaksın, kullanıcıdan girdi alacaksın, oyunu yanlış girdiye dayanıklı hâle getireceksin ve ilerlemeyi bir JSON dosyasına kaydedeceksin.

Ders uzun; tek oturumda bitirmek zorunda değilsin. Proje adım adım büyüyor ve her adımın sonunda oyun çalışır durumda. Ara verirsen kaldığın adımdan devam edersin.

#Proje planı

Kod yazmaya başlamadan önce neyi yapacağını bilmen gerek. Önce oyunun bitmiş hâline bak; dersin sonunda senin terminalinde de böyle çalışacak:

PS C:\kod\metin-rpg> node index.js=== Sihirdar Vadisi: Metin RPG ===Kahramanının adı ne? AhriHoş geldin, Ahri! 1) Savaş  2) Dükkân  3) Durum  4) Kaydet  5) ÇıkSeçimin: 1 Karşına bir Alacakarga çıktı! (Can 40, Güç 8)1) Saldır  2) İksir iç  3) KaçSeçimin: 1Alacakarga 15 hasar aldı. Kalan canı: 25Alacakarga sana 6 hasar verdi. Canın: 94/1001) Saldır  2) İksir iç  3) KaçSeçimin: 1Alacakarga 15 hasar aldı. Kalan canı: 10Alacakarga sana 5 hasar verdi. Canın: 89/1001) Saldır  2) İksir iç  3) KaçSeçimin: 1Alacakarga 12 hasar aldı. Kalan canı: 0Alacakarga yenildi! +20 altın, +25 XP 1) Savaş  2) Dükkân  3) Durum  4) Kaydet  5) ÇıkSeçimin: 3Ahri | Seviye 1 | XP 25/50Can 89/100 | Güç 12 | Altın 70 | İksir 1 1) Savaş  2) Dükkân  3) Durum  4) Kaydet  5) ÇıkSeçimin: 5Görüşürüz!

Düşmanlar ve hasarlar rastgele seçiliyor; sende başka sayılar çıkacak. Oyuncunun yazdıkları (Ahri, 1, 3, 5) soruların hemen yanında görünüyor.

#Özellik listesi

Bir projeyi planlamanın ilk adımı özellik listesi: program ne yapacak, madde madde. Listeyi yazınca ikiye ayır: ilk sürümde mutlaka olacaklar ve sonraya kalabilecekler. Bizim listemiz:

İlk sürüm:

• Açılışta kahramanın adını sorar; kayıt dosyası varsa oradan devam eder.
• Ana menü: Savaş, Dükkân, Durum, Kaydet, Çık.
• Savaş: rastgele bir düşman çıkar; her tur saldır, iksir iç ya da kaç. Kazanınca altın ve XP (tecrübe puanı) gelir, XP dolunca seviye atlanır. Yenilirsen altınının yarısını kaybedersin.
• Dükkân: iksir, kılıç ve kristal satar; altın yetmezse uyarır.
• Kaydet ve yükle: ilerleme kayit.json dosyasında durur.
• Yanlış girdide çökmez, yeniden sorar.

Sonraya: envanter, zorluk seviyesi, güçlü bir boss, kayda tarih yazmak. Bunlar dersin sonunda görev olarak seni bekliyor.

#Dosya yapısı

Bütün kodu tek dosyaya yazabilirdin, ama 300 satırlık bir dosyada aradığını bulmak zorlaşır. Ders 14'te kodu modüllere bölmeyi öğrendin. Burada asıl soru şu: hangi kod hangi dosyaya? Kural: her dosyanın tek bir işi olsun ve o işi adından anlayabilesin.

Dersin sonunda bunlara README.md ve .gitignore eklenecek; kayit.json ise oyunu kaydedince kendiliğinden oluşacak. Dosyalar kadar önemli bir şey daha var: hangisi hangisini kullanıyor?

Oklara dikkat et: hiçbiri index.js'e dönmüyor. index.js herkesi kullanıyor ama hiçbir dosya index.js'i kullanmıyor. En sağdaki girdi.js ve oyuncu.js başka hiçbir proje dosyasını bilmiyor. Bu düzen sayesinde bir dosyayı değiştirdiğinde etkisinin nereye kadar gideceğini okları tersinden izleyerek bulursun.

#Adım 1: klasör ve package.json

Projeye yeni bir klasör aç. VS Code'un terminalinde (PowerShell) şu komutları sırayla yaz:

cd C:\kodmkdir metin-rpgcd metin-rpggit initnpm init -ycode .

mkdir klasörü oluşturur, git init klasörde Git'i başlatır, npm init -y bir package.json yazar. code . içinde bulunduğun klasörü (nokta "bu klasör" demek) VS Code'un yeni bir penceresinde açar, tıpkı Ders 6'daki code takim-savasi gibi. Güven sorusu gelirse Yes, I trust the authors'a bas. Bundan sonra o yeni pencerede çalış: menüden Terminal → New Terminal ile terminali aç, istemde PS C:\kod\metin-rpg> görmelisin. Eski penceredeki terminalde git init ile npm init -y şunları yazmış olmalı:

PS C:\kod\metin-rpg> git initInitialized empty Git repository in C:/kod/metin-rpg/.git/PS C:\kod\metin-rpg> npm init -yWrote to C:\kod\metin-rpg\package.json: {  "name": "metin-rpg",  "version": "1.0.0",  "description": "",  "main": "index.js",  "scripts": {    "test": "echo \"Error: no test specified\" && exit 1"  },  "keywords": [],  "author": "",  "license": "ISC",  "type": "commonjs"}

Son satıra dikkat: npm'in yeni sürümleri "type": "commonjs" yazıyor. Bu, dosyaların eski CommonJS (require) düzeninde okunacağı demek. Biz import ve export kullanacağız. VS Code'da package.json'u aç ve şu hâle getir (değişen satırlar vurgulu):

1{2  "name": "metin-rpg",3  "version": "1.0.0",4  "description": "Terminalde oynanan küçük bir metin RPG'si",5  "main": "index.js",6  "scripts": {7    "start": "node index.js"8  },9  "keywords": [],10  "author": "",11  "license": "ISC",12  "type": "module"13}

• "type": "module": dosyalar ES modülü olarak okunur. import, export ve fonksiyon dışında await serbest olur.
• "start": "node index.js": npm start yazınca oyun başlar (Ders 14'teki npm betikleri). npm'in koyduğu "test" satırını sildik; test yazmayı Ders 53'te öğreneceksin.
• "description": projenin tek cümlelik tanımı.

#Kullanıcıdan girdi almak

Şimdiye kadar yazdığın programlar hep konuştu: console.log ile ekrana yazdılar. Bir oyunun dinlemesi de gerekiyor. Oyuncu bir seçim yazacak, program onu okuyup ona göre davranacak.

Klavyeden gelen metni satır satır okumak için Node'un içinde hazır bir modül var: node:readline/promises. Adı read line, yani "satır oku" demek; sondaki /promises da modülün Promise döndüren sürümünü seçer, böylece cevabı await ile bekleyebilirsin (Ders 15). node: ile başlayan modüller Node'la birlikte gelir; npm ile kurulmaz.

Önce oyunun dışında küçük bir deneme yapalım. Proje klasöründe deneme.js adında yeni bir dosya oluştur ve şunu yaz:

1import { createInterface } from "node:readline/promises"2import { stdin, stdout } from "node:process"3 4const rl = createInterface({ input: stdin, output: stdout })5 6const isim = await rl.question("Adın ne? ")7console.log(`Merhaba ${isim}!`)8 9rl.close()

PS C:\kod\metin-rpg> node deneme.jsAdın ne? AhriMerhaba Ahri!

Program Adın ne? yazdı ve durdu. Sen Ahri yazıp Enter'a basınca kaldığı yerden devam etti. Satır satır:

• import { stdin, stdout } from "node:process": standart girdi ve standart çıktı kanallarını alır. node:process modülü, Node'un o an çalışan programın kendisi hakkında verdiği bilgileri ve araçları tutar.
• createInterface({ input: stdin, output: stdout }): "girdiyi klavyeden oku, soruları ekrana yaz" diyen bir arayüz (interface) kurar. rl adı readline'ın kısaltması; çoğu kodda bu adı görürsün.
• await rl.question("Adın ne? "): soruyu yazar ve oyuncu Enter'a basana kadar bekler. question bir Promise döndürür; await ile içindeki cevabı alırsın (Ders 15).
• rl.close(): arayüzü kapatır. Bu satır olmazsa program bitmez.

await'i bir fonksiyonun içinde değil, dosyanın en üst düzeyinde kullandık. Ders 15'te gördüğün gibi buna yalnız ES modüllerinde izin var; bu projede package.json'daki "type": "module" satırı her .js dosyasını ES modülü yapıyor.

PS C:\kod\metin-rpg> node deneme.js(node:32380) Warning: Failed to load the ES module: C:\kod\metin-rpg\deneme.js. Make sure to set "type": "module" in the nearest package.json file or use the .mjs extension.(Use `node --trace-warnings ...` to show where the warning was created)C:\kod\metin-rpg\deneme.js:1import { createInterface } from "node:readline/promises"^^^^^^ SyntaxError: Cannot use import statement outside a module    at wrapSafe (node:internal/modules/cjs/loader:1861:18)    ... Node.js v24.20.0

#Cevap her zaman metindir

question ne yazarsan yaz bir metin döndürür. Oyuncu 7 yazsa bile elindeki "7"dir. Bunu unutursan Ders 1'deki "metin + sayı = metin" tuzağına düşersin. deneme.js'e ikinci bir soru ekle:

1import { createInterface } from "node:readline/promises"2import { stdin, stdout } from "node:process"3 4const rl = createInterface({ input: stdin, output: stdout })5 6const isim = await rl.question("Adın ne? ")7console.log(`Merhaba ${isim}!`)8const seviye = await rl.question("Kaçıncı seviyedesin? ")9console.log(`Bir sonraki seviyen: ${seviye + 1}`)10 11rl.close()

PS C:\kod\metin-rpg> node deneme.jsAdın ne? AhriMerhaba Ahri!Kaçıncı seviyedesin? 7Bir sonraki seviyen: 71

"7" + 1 toplama değil yapıştırma oldu. Sayıya ihtiyacın varsa cevabı Number ile çevir (Ders 9):

8const seviye = Number(await rl.question("Kaçıncı seviyedesin? "))9console.log(`Bir sonraki seviyen: ${seviye + 1}`)

PS C:\kod\metin-rpg> node deneme.jsAdın ne? AhriMerhaba Ahri!Kaçıncı seviyedesin? 7Bir sonraki seviyen: 8

Oyuncu sayı yerine abc yazarsa ne olacak? Number("abc") sonucu NaN. Bunu Adım 3'te ele alacağız. Önce readline'ın üç sık hatası:

1import { createInterface } from "node:readline/promises"2import { stdin, stdout } from "node:process"3 4const rl = createInterface({ input: stdin, output: stdout })5 6const isim = rl.question("Adın ne? ")7console.log(`Merhaba ${isim}!`)8 9rl.close()

Adın ne? Merhaba [object Promise]!

PS C:\kod\metin-rpg> node deneme.jsAdın ne? node:internal/readline/interface:1347            this[kQuestionReject]?.(new AbortError('Aborted with Ctrl+C'));                                    ^ AbortError: Aborted with Ctrl+C    at [_ttyWrite] (node:internal/readline/interface:1347:37)    ...    at Readable.push (node:internal/streams/readable:398:5) {  code: 'ABORT_ERR'} Node.js v24.20.0

1import { createInterface } from "node:readline/promises"2import { stdin, stdout } from "node:process"3 4const rl = createInterface({ input: stdin, output: stdout })5 6const isim = await rl.question("Adın ne? ")7rl.close()8const sehir = await rl.question("Nerelisin? ")9console.log(`${isim}, ${sehir}`)

PS C:\kod\metin-rpg> node deneme.jsAdın ne? Ahrinode:internal/readline/interface:450      throw new ERR_USE_AFTER_CLOSE('readline');            ^ Error [ERR_USE_AFTER_CLOSE]: readline was closed    at [kQuestion] (node:internal/readline/interface:450:13)    ...    at file:///C:/kod/metin-rpg/deneme.js:8:24    at process.processTicksAndRejections (node:internal/process/task_queues:104:5) {  code: 'ERR_USE_AFTER_CLOSE'} Node.js v24.20.0

#Adım 2: girdi.js ve ana menü

deneme.js'deki kodu oyunun her yerinde kullanacağız: menüde, savaşta, dükkânda. Her dosyada ayrı createInterface kurmak yerine girdiyle ilgili her şeyi tek bir modülde toplayalım. girdi.js adında yeni bir dosya oluştur:

1import { createInterface } from "node:readline/promises"2import { stdin, stdout } from "node:process"3 4const rl = createInterface({ input: stdin, output: stdout })5 6export async function sor(soru) {7    const cevap = await rl.question(soru)8    return cevap.trim()9}10 11export function girdiyiKapat() {12    rl.close()13}

• sor(soru) soruyu sorar, cevabın başındaki ve sonundaki boşlukları trim ile atıp döndürür (Ders 9). Oyuncu yanlışlıkla " 5 " yazarsa "5" olur.
• girdiyiKapat() arayüzü kapatır.
• rl dışa aktarılmıyor. Öteki dosyalar onu bilmiyor, yalnız bu iki fonksiyonu kullanıyor. Yarın girdiyi başka bir yoldan okumaya karar verirsen yalnız bu dosyayı değiştirirsin.

Bir modül kaç dosyada import edilirse edilsin yalnız bir kez çalışır. Yani girdi.js'i üç dosya kullansa da tek bir rl olur ve hepsi aynı klavyeyi paylaşır.

Şimdi oyunun giriş noktası olan index.js'i oluştur. Bu ilk sürümde menünün iskeletini kuruyoruz; dalların çoğu şimdilik "yakında" diyor:

1import { sor, girdiyiKapat } from "./girdi.js"2 3console.log("=== Sihirdar Vadisi: Metin RPG ===")4const isim = await sor("Kahramanının adı ne? ")5console.log(`Hoş geldin, ${isim}!`)6 7while (true) {8    console.log("\n1) Savaş  2) Dükkân  3) Durum  4) Kaydet  5) Çık")9    const secim = await sor("Seçimin: ")10    if (secim === "5") {11        break12    } else if (secim === "1") {13        console.log("Savaş yakında.")14    } else if (secim === "2") {15        console.log("Dükkân yakında.")16    } else if (secim === "3") {17        console.log("Durum yakında.")18    } else if (secim === "4") {19        console.log("Kayıt yakında.")20    }21}22 23console.log("Görüşürüz!")24girdiyiKapat()

PS C:\kod\metin-rpg> node index.js=== Sihirdar Vadisi: Metin RPG ===Kahramanının adı ne? AhriHoş geldin, Ahri! 1) Savaş  2) Dükkân  3) Durum  4) Kaydet  5) ÇıkSeçimin: 3Durum yakında. 1) Savaş  2) Dükkân  3) Durum  4) Kaydet  5) ÇıkSeçimin: 1Savaş yakında. 1) Savaş  2) Dükkân  3) Durum  4) Kaydet  5) ÇıkSeçimin: 5Görüşürüz!

• while (true) kendiliğinden hiç bitmeyen bir döngü kurar; içindeki break döngüden çıkmanın tek yolu (Ders 5).
• "\n" (ters eğik çizgi ve n) metnin içinde yeni satır demek; ekrana iki harf olarak değil, satır sonu olarak çıkar. Burada menüden önce boş bir satır bırakır, ekran okunaklı olur.
• sor metin döndürdüğü için seçimi "5" gibi bir metinle karşılaştırdık.

#Adım 3: yanlış girdiye dayanmak

Ara sürüm 1'i biraz zorla ve menüde olmayan şeyler yaz: bir sözcük (abc), menüde olmayan bir sayı (7) ve hiçbir şey yazmadan Enter. En sonda 5 ile çık.

PS C:\kod\metin-rpg> node index.js=== Sihirdar Vadisi: Metin RPG ===Kahramanının adı ne? AhriHoş geldin, Ahri! 1) Savaş  2) Dükkân  3) Durum  4) Kaydet  5) ÇıkSeçimin: abc 1) Savaş  2) Dükkân  3) Durum  4) Kaydet  5) ÇıkSeçimin: 7 1) Savaş  2) Dükkân  3) Durum  4) Kaydet  5) ÇıkSeçimin: 1) Savaş  2) Dükkân  3) Durum  4) Kaydet  5) ÇıkSeçimin: 5Görüşürüz!

abc, 7 ve boş Enter sessizce yutuldu; menü hiçbir şey demeden yeniden geldi. Oyuncu ne olduğunu anlamaz. Daha kötüsü, seçimleri sayıya çevirmeye başlayınca sessiz hatalar çıkar. Number'ın böyle girdilerle ne yaptığına bak; deneme.js'in içini sil ve şunu yaz:

1console.log(Number("3"))2console.log(Number(" 3 "))3console.log(Number("abc"))4console.log(Number(""))5console.log(Number("2.5"))6console.log(Number.isInteger(Number("2.5")))

33NaN02.5false

Boş metin 0 oluyor! Dükkânda 0 "çık" demek olacak; oyuncu yanlışlıkla Enter'a basınca dükkândan atılırdı. Son satırdaki Number.isInteger(x)'i ilk kez görüyorsun: "x bir tam sayı mı?" diye sorar, NaN ve 2.5 için false döndürür.

Çözüm Ders 13'teki girdi doğrulama: girdiyi kullanmadan önce denetle, uymuyorsa açık bir mesajla hata fırlat. girdi.js'e iki fonksiyon ekle:

1import { createInterface } from "node:readline/promises"2import { stdin, stdout } from "node:process"3 4const rl = createInterface({ input: stdin, output: stdout })5 6export async function sor(soru) {7    const cevap = await rl.question(soru)8    return cevap.trim()9}10 11export function secimeCevir(metin, enAz, enCok) {12    const sayi = Number(metin)13    if (metin === "" || !Number.isInteger(sayi)) {14        throw new Error(`"${metin}" bir tam sayı değil`)15    }16    if (sayi < enAz || sayi > enCok) {17        throw new Error(`${enAz} ile ${enCok} arasında bir sayı yaz`)18    }19    return sayi20}21 22export async function secimIste(soru, enAz, enCok) {23    while (true) {24        const cevap = await sor(soru)25        try {26            return secimeCevir(cevap, enAz, enCok)27        } catch (hata) {28            console.log(`Geçersiz seçim: ${hata.message}.`)29        }30    }31}32 33export function girdiyiKapat() {34    rl.close()35}

• secimeCevir tek bir iş yapar: metni sayıya çevirir ya da açıklamalı bir hata fırlatır. Klavyeyle ilgisi yok; bu yüzden tek başına denenebilir.
• secimIste doğru bir seçim gelene kadar sorar. try içindeki return başarılı olursa fonksiyondan hemen çıkılır. Hata olursa catch mesajı yazar ve döngü aynı soruyu yeniden sorar.
• Hata mesajı oyuncu için yazıldı: neyin yanlış olduğunu ve ne yapması gerektiğini söylüyor.

secimeCevir'i oyuna bağlamadan önce sınır değerleriyle dene (Ders 2): 1 ve 5 kabul edilmeli, 0 ve 6 reddedilmeli. deneme.js'in içini sil ve şunu yaz:

1import { secimeCevir, girdiyiKapat } from "./girdi.js"2 3const denemeler = ["3", "abc", "", "0", "1", "5", "6", "2.5"]4for (const metin of denemeler) {5    try {6        console.log(`"${metin}" -> ${secimeCevir(metin, 1, 5)}`)7    } catch (hata) {8        console.log(`"${metin}" -> hata: ${hata.message}`)9    }10}11 12girdiyiKapat()

PS C:\kod\metin-rpg> node deneme.js"3" -> 3"abc" -> hata: "abc" bir tam sayı değil"" -> hata: "" bir tam sayı değil"0" -> hata: 1 ile 5 arasında bir sayı yaz"1" -> 1"5" -> 5"6" -> hata: 1 ile 5 arasında bir sayı yaz"2.5" -> hata: "2.5" bir tam sayı değil

Sondaki girdiyiKapat() satırına dikkat. girdi.js'i import edince arayüz kuruldu; kapatmasaydık program hiç soru sormadığı hâlde girdi beklemeye devam ederdi.

Şimdi index.js'i sayılarla çalışacak hâle getir. Değişen satırlar vurgulu:

1import { sor, secimIste, girdiyiKapat } from "./girdi.js"2 3console.log("=== Sihirdar Vadisi: Metin RPG ===")4const isim = await sor("Kahramanının adı ne? ")5console.log(`Hoş geldin, ${isim || "İsimsiz"}!`)6 7while (true) {8    console.log("\n1) Savaş  2) Dükkân  3) Durum  4) Kaydet  5) Çık")9    const secim = await secimIste("Seçimin: ", 1, 5)10    if (secim === 5) {11        break12    } else if (secim === 1) {13        console.log("Savaş yakında.")14    } else if (secim === 2) {15        console.log("Dükkân yakında.")16    } else if (secim === 3) {17        console.log("Durum yakında.")18    } else if (secim === 4) {19        console.log("Kayıt yakında.")20    }21}22 23console.log("Görüşürüz!")24girdiyiKapat()

isim || "İsimsiz": oyuncu adını boş bırakırsa boş metin yanlış sayılır (Ders 12) ve yerine "İsimsiz" kullanılır. Yanlış girdileri yeniden dene; bu kez 2.5 gibi küsuratlı bir sayı da yaz:

PS C:\kod\metin-rpg> node index.js=== Sihirdar Vadisi: Metin RPG ===Kahramanının adı ne? AhriHoş geldin, Ahri! 1) Savaş  2) Dükkân  3) Durum  4) Kaydet  5) ÇıkSeçimin: abcGeçersiz seçim: "abc" bir tam sayı değil.Seçimin:Geçersiz seçim: "" bir tam sayı değil.Seçimin: 9Geçersiz seçim: 1 ile 5 arasında bir sayı yaz.Seçimin: 2.5Geçersiz seçim: "2.5" bir tam sayı değil.Seçimin: 3Durum yakında. 1) Savaş  2) Dükkân  3) Durum  4) Kaydet  5) ÇıkSeçimin: 5Görüşürüz!

Artık her yanlış girdi açıklanıyor ve aynı soru yeniden geliyor. Ara sürüm 2 hazır.

#Adım 4: Oyuncu sınıfı

Oyuncunun adı, canı, altını ve seviyesi hep birlikte değişiyor ve uyması gereken kurallar var: can sıfırın altına inmez, iksir canı en yüksek değerin üstüne çıkaramaz. Veriyi ve kurallarını bir arada tutmanın yolunu Ders 16'da gördün: sınıf. oyuncu.js adında yeni bir dosya oluştur:

1export class Oyuncu {2    constructor(isim) {3        this.isim = isim4        this.seviye = 15        this.xp = 06        this.maxHp = 1007        this.hp = 1008        this.guc = 129        this.gold = 5010        this.iksir = 111    }12 13    get canliMi() {14        return this.hp > 015    }16 17    get gerekenXp() {18        return this.seviye * 5019    }20 21    hasarAl(miktar) {22        this.hp = Math.max(0, this.hp - miktar)23    }24 25    iksirIc() {26        if (this.iksir === 0) {27            return false28        }29        this.iksir--30        this.hp = Math.min(this.maxHp, this.hp + 40)31        return true32    }33 34    xpKazan(miktar) {35        this.xp = this.xp + miktar36        let atlanan = 037        while (this.xp >= this.gerekenXp) {38            this.xp = this.xp - this.gerekenXp39            this.seviye++40            this.maxHp = this.maxHp + 2041            this.guc = this.guc + 342            this.hp = this.maxHp43            atlanan++44        }45        return atlanan46    }47 48    durum() {49        const satir1 = `${this.isim} | Seviye ${this.seviye} | XP ${this.xp}/${this.gerekenXp}`50        const satir2 = `Can ${this.hp}/${this.maxHp} | Güç ${this.guc} | Altın ${this.gold} | İksir ${this.iksir}`51        return satir1 + "\n" + satir252    }53}

• canliMi ve gerekenXp birer getter: parantezsiz okunur (oyuncu.canliMi) ama her okunuşta yeniden hesaplanır. Seviye 2'de gereken XP kendiliğinden 100 olur.
• hasarAl, canı Math.max(0, …) ile sıfırda durdurur (Ders 9); can hiç eksiye düşmez. iksirIc de Math.min ile canın en yüksek değeri aşmasını engeller.
• iksirIc iksir yoksa false döndürür. Savaş kodu bu cevaba bakıp "İksirin kalmadı!" diyecek.
• xpKazan bir while ile çalışır: tek seferde çok XP gelirse birden fazla seviye atlanabilir. Kaç seviye atlandığını döndürür.
• durum ekrana bir şey yazmaz, metin döndürür. Yazdırmak çağıranın işi; böylece metni denemek ve başka yerde kullanmak kolaylaşır.

Sınıfı oyuna bağlamadan önce tek başına dene. oyuncu.js'in en altına, bir boş satırdan sonra şunları geçici olarak ekle ve node oyuncu.js ile çalıştır:

55const ahri = new Oyuncu("Ahri")56console.log(ahri.durum())57ahri.hasarAl(130)58console.log(ahri.hp, ahri.canliMi)59console.log(ahri.iksirIc(), ahri.hp)60console.log(ahri.iksirIc(), ahri.hp)61console.log(ahri.xpKazan(120))62console.log(ahri.durum())63console.log(ahri.xpKazan(30), ahri.seviye, ahri.xp)

Ahri | Seviye 1 | XP 0/50Can 100/100 | Güç 12 | Altın 50 | İksir 10 falsetrue 40false 401Ahri | Seviye 2 | XP 70/100Can 120/120 | Güç 15 | Altın 50 | İksir 01 3 0

Sınır değerlerine bak. Can 100 iken gelen 130 hasar canı 0'a indirdi, eksiye değil. İkinci iksir yokken false geldi ve can değişmedi.

120 XP bir seviye atlattı, 70 XP arttı. Ardından gelen 30 XP sayacı tam 100'e çıkardı ve tam sınırda seviye atlandı.

Şimdi index.js'te oyuncuyu oluştur ve Durum seçeneğini bağla. Yeni ve değişen satırlar vurgulu; geri kalanı aynı:

1import { Oyuncu } from "./oyuncu.js"2import { sor, secimIste, girdiyiKapat } from "./girdi.js"3 4console.log("=== Sihirdar Vadisi: Metin RPG ===")5const isim = await sor("Kahramanının adı ne? ")6const oyuncu = new Oyuncu(isim || "İsimsiz")7console.log(`Hoş geldin, ${oyuncu.isim}!`)8 9while (true) {10    console.log("\n1) Savaş  2) Dükkân  3) Durum  4) Kaydet  5) Çık")11    const secim = await secimIste("Seçimin: ", 1, 5)12    if (secim === 5) {13        break14    } else if (secim === 1) {15        console.log("Savaş yakında.")16    } else if (secim === 2) {17        console.log("Dükkân yakında.")18    } else if (secim === 3) {19        console.log(oyuncu.durum())20    } else if (secim === 4) {21        console.log("Kayıt yakında.")22    }23}24 25console.log("Görüşürüz!")26girdiyiKapat()

PS C:\kod\metin-rpg> node index.js=== Sihirdar Vadisi: Metin RPG ===Kahramanının adı ne? AhriHoş geldin, Ahri! 1) Savaş  2) Dükkân  3) Durum  4) Kaydet  5) ÇıkSeçimin: 3Ahri | Seviye 1 | XP 0/50Can 100/100 | Güç 12 | Altın 50 | İksir 1 1) Savaş  2) Dükkân  3) Durum  4) Kaydet  5) ÇıkSeçimin: 5Görüşürüz!

Ara sürüm 3 hazır: Durum seçeneği oyuncunun gerçek bilgilerini gösteriyor. İlk kez kendi yazdığın bir dosyadan sınıf import ettin. Bu adımda iki hata çok sık çıkar:

PS C:\kod\metin-rpg> node index.jsnode:internal/modules/run_main:107    triggerUncaughtException(    ^ Error [ERR_MODULE_NOT_FOUND]: Cannot find module 'C:\kod\metin-rpg\oyuncu' imported from C:\kod\metin-rpg\index.jsDid you mean to import "./oyuncu.js"?    at finalizeResolution (node:internal/modules/esm/resolve:272:11)    ... Node.js v24.20.0

PS C:\kod\metin-rpg> node index.jsfile:///C:/kod/metin-rpg/index.js:1import { Oyuncu } from "./oyuncu.js"         ^^^^^^SyntaxError: The requested module './oyuncu.js' does not provide an export named 'Oyuncu'    at #asyncInstantiate (node:internal/modules/esm/module_job:455:21)    ... Node.js v24.20.0

#Adım 5: savaş

savas.js adında yeni bir dosya oluştur. Oyunun en uzun dosyası bu; önce baştan sona yaz, sonra parça parça bakalım:

1import { secimIste } from "./girdi.js"2 3const DUSMANLAR = [4    { isim: "Minyon", hp: 30, guc: 6, gold: 15, xp: 20 },5    { isim: "Alacakarga", hp: 40, guc: 8, gold: 20, xp: 25 },6    { isim: "Kurt", hp: 55, guc: 10, gold: 30, xp: 35 },7    { isim: "Gromp", hp: 70, guc: 12, gold: 40, xp: 45 }8]9 10function zar(enAz, enCok) {11    return enAz + Math.floor(Math.random() * (enCok - enAz + 1))12}13 14export async function savas(oyuncu) {15    const sablon = DUSMANLAR[zar(0, DUSMANLAR.length - 1)]16    const dusman = { ...sablon }17    console.log(`\nKarşına bir ${dusman.isim} çıktı! (Can ${dusman.hp}, Güç ${dusman.guc})`)18 19    while (oyuncu.canliMi && dusman.hp > 0) {20        const secim = await secimIste("1) Saldır  2) İksir iç  3) Kaç\nSeçimin: ", 1, 3)21        if (secim === 1) {22            const hasar = zar(oyuncu.guc - 4, oyuncu.guc + 4)23            dusman.hp = Math.max(0, dusman.hp - hasar)24            console.log(`${dusman.isim} ${hasar} hasar aldı. Kalan canı: ${dusman.hp}`)25        } else if (secim === 2) {26            if (!oyuncu.iksirIc()) {27                console.log("İksirin kalmadı!")28                continue29            }30            console.log(`İksir içtin. Canın: ${oyuncu.hp}/${oyuncu.maxHp}`)31        } else {32            if (Math.random() < 0.5) {33                console.log("Kaçmayı başardın.")34                return35            }36            console.log("Kaçamadın!")37        }38 39        if (dusman.hp > 0) {40            const hasar = zar(dusman.guc - 3, dusman.guc + 3)41            oyuncu.hasarAl(hasar)42            console.log(`${dusman.isim} sana ${hasar} hasar verdi. Canın: ${oyuncu.hp}/${oyuncu.maxHp}`)43        }44    }45 46    if (oyuncu.canliMi) {47        oyuncu.gold = oyuncu.gold + dusman.gold48        console.log(`${dusman.isim} yenildi! +${dusman.gold} altın, +${dusman.xp} XP`)49        const atlanan = oyuncu.xpKazan(dusman.xp)50        if (atlanan > 0) {51            console.log(`Seviye atladın! Artık ${oyuncu.seviye}. seviyedesin, canın doldu.`)52        }53    } else {54        const kayip = Math.floor(oyuncu.gold / 2)55        oyuncu.gold = oyuncu.gold - kayip56        oyuncu.hp = oyuncu.maxHp57        console.log(`Yenildin... ${kayip} altın düşürdün. Üste yeniden doğdun.`)58    }59}

• DUSMANLAR her düşman türünün şablonunu tutar. Hiç değişmeyecek ayar listelerinin adını büyük harfle yazmak yaygın bir alışkanlık; okuyan "bu bir ayar" diye anlar. Dizi dışa aktarılmıyor: düşmanları yalnız savas.js bilir.
• zar(enAz, enCok) iki sınır dahil rastgele bir tam sayı verir (Ders 6'daki Math.random ve Math.floor). zar(0, DUSMANLAR.length - 1) rastgele bir sıra numarası seçer.
• const dusman = { ...sablon } şablonun kopyasını alır (Ders 12). Neden şart olduğunu aşağıdaki hata kartında göreceksin.
• while (oyuncu.canliMi && dusman.hp > 0): ikisi de ayaktayken tur döner. Senin hasarın gücünün 4 altı ile 4 üstü arasında, düşmanınki 3 altı ile 3 üstü arasında.
• İksir yoksa continue turu baştan başlatır (Ders 5); düşman bu yüzden bedava vuruş kazanmaz.
• Kaçma şansı yüzde 50: Math.random() < 0.5. Kaçarsan return savaşı hemen bitirir.
• Döngüden sonra kim ayakta kaldıysa ona göre ödül ya da ceza gelir.

Savaşın bütün hasarları zar'dan geliyor; ona güvenmeden önce dene. Rastgele bir fonksiyonu bir kez çalıştırmak bir şey kanıtlamaz. Ders 6'daki gibi çok kez atıp en küçük ve en büyük sonuca bakarsın; bu kez ikisini döngüyle aramak yerine diziyi Math.min ile Math.max'a yayıyoruz (Ders 12). deneme.js'in içini sil ve şunu yaz:

1function zar(enAz, enCok) {2    return enAz + Math.floor(Math.random() * (enCok - enAz + 1))3}4 5console.log(zar(8, 16), zar(8, 16), zar(8, 16))6 7const atislar = []8for (let i = 0; i < 1000; i++) {9    atislar.push(zar(8, 16))10}11console.log("En küçük:", Math.min(...atislar), "En büyük:", Math.max(...atislar))

12 13 8En küçük: 8 En büyük: 16

zar(8, 16), gücü 12 olan Ahri'nin vuruşu: en az 8, en çok 16 hasar. İlk satır her çalıştırmada değişir, ikinci satır hep aynıdır; 1000 atışta 8'in ya da 16'nın hiç gelmemesi pratikte imkânsız. Formüldeki + 1'i unutursan ikinci satır En küçük: 8 En büyük: 15 olur ve 16 hiç gelmez. Hata mesajı vermeyen bu yanlışı ancak böyle bir sınır denemesiyle yakalarsın.

# ... önceki savaşlarda bir Gromp ve bir Minyon yenildi1) Savaş  2) Dükkân  3) Durum  4) Kaydet  5) ÇıkSeçimin: 1 Karşına bir Gromp çıktı! (Can 0, Güç 12)Gromp yenildi! +40 altın, +45 XP

1const DUSMANLAR = [{ isim: "Kurt", hp: 55 }]2 3const birinci = DUSMANLAR[0]4birinci.hp = 05console.log("Birinci kurt yenildi.")6 7const ikinci = DUSMANLAR[0]8console.log("İkinci kurdun canı:", ikinci.hp)

Birinci kurt yenildi.İkinci kurdun canı: 0

Savaşın yenilgi dalını denemek için oyunu dakikalarca oynaman gerekmez. Bir parçayı ayrı denemek (Ders 6) burada da işe yarar. savas-deneme.js adında yeni bir dosya oluştur; canı az bir Teemo'yu savaşa sok:

1import { Oyuncu } from "./oyuncu.js"2import { savas } from "./savas.js"3import { girdiyiKapat } from "./girdi.js"4 5const teemo = new Oyuncu("Teemo")6teemo.hp = 157await savas(teemo)8console.log(teemo.durum())9girdiyiKapat()

PS C:\kod\metin-rpg> node savas-deneme.js Karşına bir Kurt çıktı! (Can 55, Güç 10)1) Saldır  2) İksir iç  3) KaçSeçimin: 1Kurt 16 hasar aldı. Kalan canı: 39Kurt sana 8 hasar verdi. Canın: 7/1001) Saldır  2) İksir iç  3) KaçSeçimin: 1Kurt 10 hasar aldı. Kalan canı: 29Kurt sana 11 hasar verdi. Canın: 0/100Yenildin... 25 altın düşürdün. Üste yeniden doğdun.Teemo | Seviye 1 | XP 0/50Can 100/100 | Güç 12 | Altın 25 | İksir 1

15 canla başlayan Teemo iki turda yenildi, 50 altının yarısını kaybetti ve canı doldu: yenilgi dalı çalışıyor. Rastgele olduğu için sende başka bir düşman ve başka sayılar çıkacak. Teemo bu kez kazandıysa programı yeniden çalıştır ya da teemo.hp'yi 1 yap; o zaman düşmanın ilk vuruşu yeter.

Şimdi savaşı menüye bağla. index.js'in en üstündeki iki import satırının altına import { savas } from "./savas.js" satırını ekle ve 1'in dalındaki console.log("Savaş yakında.") satırını await savas(oyuncu) yap. await'i unutma: savas bir async fonksiyon. await olmazsa menü savaşı beklemez; menü ile savaş aynı anda soru sormaya kalkar, ekran karışır ve oyun kilitlenir.

PS C:\kod\metin-rpg> node index.js=== Sihirdar Vadisi: Metin RPG ===Kahramanının adı ne? AhriHoş geldin, Ahri! 1) Savaş  2) Dükkân  3) Durum  4) Kaydet  5) ÇıkSeçimin: 1 Karşına bir Minyon çıktı! (Can 30, Güç 6)1) Saldır  2) İksir iç  3) KaçSeçimin: 1Minyon 9 hasar aldı. Kalan canı: 21Minyon sana 5 hasar verdi. Canın: 95/1001) Saldır  2) İksir iç  3) KaçSeçimin: 1Minyon 8 hasar aldı. Kalan canı: 13Minyon sana 8 hasar verdi. Canın: 87/1001) Saldır  2) İksir iç  3) KaçSeçimin: 1Minyon 14 hasar aldı. Kalan canı: 0Minyon yenildi! +15 altın, +20 XP 1) Savaş  2) Dükkân  3) Durum  4) Kaydet  5) ÇıkSeçimin: 1 Karşına bir Kurt çıktı! (Can 55, Güç 10)1) Saldır  2) İksir iç  3) KaçSeçimin: 1Kurt 9 hasar aldı. Kalan canı: 46Kurt sana 11 hasar verdi. Canın: 76/1001) Saldır  2) İksir iç  3) KaçSeçimin: 1Kurt 15 hasar aldı. Kalan canı: 31Kurt sana 12 hasar verdi. Canın: 64/1001) Saldır  2) İksir iç  3) KaçSeçimin: 1Kurt 10 hasar aldı. Kalan canı: 21Kurt sana 9 hasar verdi. Canın: 55/1001) Saldır  2) İksir iç  3) KaçSeçimin: 1Kurt 10 hasar aldı. Kalan canı: 11Kurt sana 10 hasar verdi. Canın: 45/1001) Saldır  2) İksir iç  3) KaçSeçimin: 1Kurt 11 hasar aldı. Kalan canı: 0Kurt yenildi! +30 altın, +35 XPSeviye atladın! Artık 2. seviyedesin, canın doldu. 1) Savaş  2) Dükkân  3) Durum  4) Kaydet  5) ÇıkSeçimin: 3Ahri | Seviye 2 | XP 5/100Can 120/120 | Güç 15 | Altın 95 | İksir 1 1) Savaş  2) Dükkân  3) Durum  4) Kaydet  5) ÇıkSeçimin: 5Görüşürüz!

İki savaşta toplam 55 XP geldi: 50'si seviye atlamaya gitti, 5'i yeni sayaca kaldı. Ara sürüm 4 hazır.

#Adım 6: dükkân

Dükkânın işi küçük ama içinde güzel bir fikir var: her ürün, satın alınınca ne olacağını kendi taşıyor. dukkan.js adında yeni bir dosya oluştur:

1import { secimIste } from "./girdi.js"2 3const URUNLER = [4    {5        isim: "Can İksiri",6        fiyat: 30,7        aciklama: "+1 iksir",8        etki: (oyuncu) => { oyuncu.iksir++ }9    },10    {11        isim: "Uzun Kılıç",12        fiyat: 90,13        aciklama: "+4 güç",14        etki: (oyuncu) => { oyuncu.guc = oyuncu.guc + 4 }15    },16    {17        isim: "Yakut Kristali",18        fiyat: 120,19        aciklama: "+25 en yüksek can",20        etki: (oyuncu) => {21            oyuncu.maxHp = oyuncu.maxHp + 2522            oyuncu.hp = oyuncu.hp + 2523        }24    }25]26 27export async function dukkan(oyuncu) {28    while (true) {29        console.log(`\n--- Dükkân (altının: ${oyuncu.gold}) ---`)30        URUNLER.forEach((urun, i) => {31            console.log(`${i + 1}) ${urun.isim}: ${urun.fiyat} altın (${urun.aciklama})`)32        })33        console.log("0) Dükkândan çık")34 35        const secim = await secimIste("Ne alacaksın? ", 0, URUNLER.length)36        if (secim === 0) {37            return38        }39        const urun = URUNLER[secim - 1]40        if (oyuncu.gold < urun.fiyat) {41            console.log(`Altının yetmiyor: ${urun.fiyat - oyuncu.gold} altın eksik.`)42        } else {43            oyuncu.gold = oyuncu.gold - urun.fiyat44            urun.etki(oyuncu)45            console.log(`${urun.isim} aldın. Kalan altın: ${oyuncu.gold}`)46        }47    }48}

• etki alanında bir fonksiyon duruyor (Ders 10: fonksiyon da bir değerdir). Dükkân hangi ürünün ne yaptığını bilmek zorunda değil; urun.etki(oyuncu) demesi yeter. Yeni bir ürün eklemek için yalnız diziye bir obje eklersin.
• forEach((urun, i) => …) ikinci parametrede sıra numarasını da verir (Ders 11). Ekranda 1'den başlamak için i + 1 yazdık; seçimi diziye geri çevirirken de secim - 1.
• secimIste("Ne alacaksın? ", 0, URUNLER.length): sınırlar dizinin uzunluğundan geliyor. Dördüncü bir ürün eklersen menü kendiliğinden 0–4 olur.
• Dükkân da kendi küçük döngüsüne sahip: oyuncu 0 diyene kadar alışveriş sürer.

index.js'te savas import'unun altına import { dukkan } from "./dukkan.js" satırını ekle ve 2'nin dalındaki console.log("Dükkân yakında.") satırını await dukkan(oyuncu) yap. Sonra dükkânı dene; parası yetmeyen bir eşya da seç:

PS C:\kod\metin-rpg> node index.js=== Sihirdar Vadisi: Metin RPG ===Kahramanının adı ne? AhriHoş geldin, Ahri! 1) Savaş  2) Dükkân  3) Durum  4) Kaydet  5) ÇıkSeçimin: 2 --- Dükkân (altının: 50) ---1) Can İksiri: 30 altın (+1 iksir)2) Uzun Kılıç: 90 altın (+4 güç)3) Yakut Kristali: 120 altın (+25 en yüksek can)0) Dükkândan çıkNe alacaksın? 1Can İksiri aldın. Kalan altın: 20 --- Dükkân (altının: 20) ---1) Can İksiri: 30 altın (+1 iksir)2) Uzun Kılıç: 90 altın (+4 güç)3) Yakut Kristali: 120 altın (+25 en yüksek can)0) Dükkândan çıkNe alacaksın? 2Altının yetmiyor: 70 altın eksik. --- Dükkân (altının: 20) ---1) Can İksiri: 30 altın (+1 iksir)2) Uzun Kılıç: 90 altın (+4 güç)3) Yakut Kristali: 120 altın (+25 en yüksek can)0) Dükkândan çıkNe alacaksın? 0 1) Savaş  2) Dükkân  3) Durum  4) Kaydet  5) ÇıkSeçimin: 3Ahri | Seviye 1 | XP 0/50Can 100/100 | Güç 12 | Altın 20 | İksir 2 1) Savaş  2) Dükkân  3) Durum  4) Kaydet  5) ÇıkSeçimin: 5Görüşürüz!

Ara sürüm 5 hazır: savaş, dükkân ve durum çalışıyor. Eksik tek şey kayıt.

#Adım 7: kaydetmek ve yüklemek

Oyunu kapatınca bütün değişkenler silinir; oyuncu her açılışta 1. seviyeden başlar. Bir bilgiyi programdan uzun yaşatmanın en sade yolu onu bir dosyaya yazmak.

#Neyi kaydediyoruz?

Ders 12'deki JSON.stringify bir objeyi metne çevirir. Bir sınıftan new ile üretilmiş objeyi (Ders 16'daki adıyla bir örneği) çevirince ne olduğuna bak:

1class Oyuncu {2    constructor(isim) {3        this.isim = isim4        this.hp = 1005    }6 7    get canliMi() {8        return this.hp > 09    }10 11    durum() {12        return `${this.isim}: ${this.hp} can`13    }14}15 16const ahri = new Oyuncu("Ahri")17console.log(JSON.stringify(ahri))18console.log(JSON.stringify(ahri, null, 2))

{"isim":"Ahri","hp":100}{  "isim": "Ahri",  "hp": 100}

Metne yalnız objenin kendi alanları girdi: isim ve hp. canliMi getter'ı ve durum metodu sınıfta durur, objenin içinde değil; dosyaya da girmez. Zaten girmeleri gerekmez: dosyada veri durur, davranış kodda. Üçüncü argüman 2, metni her düzeyde 2 boşluk içeri alarak okunaklı yazar.

#Dosyaya yazmak ve okumak

Dosya işleri için Node'un node:fs/promises modülü var (fs: file system, dosya sistemi). Bize iki fonksiyonu yetiyor:

• writeFile(dosya, metin, "utf8"): metni dosyaya yazar. Dosya yoksa oluşturur, varsa üzerine yazar.
• readFile(dosya, "utf8"): dosyanın içini metin olarak okur.

İkisi de Promise döndürür, await ile beklenir. "utf8" metnin kodlaması, yani harflerin dosyaya hangi kuralla yazılacağı; Türkçe harfler de bu kuralla bozulmadan yazılıp okunur. readFile'a kodlamayı vermezsen metin yerine ham baytlar alırsın. Dosya sistemini Ders 29'da ayrıntılı göreceksin. kayit.js adında yeni bir dosya oluştur:

1import { readFile, writeFile } from "node:fs/promises"2import { Oyuncu } from "./oyuncu.js"3 4const DOSYA = "kayit.json"5 6export async function kaydet(oyuncu) {7    try {8        const metin = JSON.stringify(oyuncu, null, 2)9        await writeFile(DOSYA, metin, "utf8")10        console.log(`Oyun kaydedildi: ${DOSYA}`)11    } catch (hata) {12        console.log(`Kaydedilemedi: ${hata.message}`)13    }14}15 16export async function yukle() {17    let metin18    try {19        metin = await readFile(DOSYA, "utf8")20    } catch (hata) {21        if (hata.code === "ENOENT") {22            return null23        }24        throw hata25    }26 27    try {28        const veri = JSON.parse(metin)29        if (!veri.isim) {30            throw new Error("kayıtta isim yok")31        }32        return new Oyuncu(veri.isim, veri)33    } catch (hata) {34        console.log(`Kayıt dosyası bozuk (${hata.message}). Yeni oyun başlıyor.`)35        return null36    }37}

• kaydet yazma hatasını yakalar (disk dolu, dosyaya erişim izni yok gibi). Kayıt başarısız olsa bile oyun çökmez, mesaj yazar ve oyuncu oynamaya devam eder.
• yukle iki ayrı try kullanıyor, çünkü iki ayrı şey ters gidebilir: dosya hiç olmayabilir, ya da var olup bozuk olabilir.
• Dosya yoksa Node'un hatasının code alanında "ENOENT" yazar. Bu bizim için hata değil, "kayıt yok, yeni oyun" demek; null döndürüyoruz. Başka bir hatayı ise ne yapacağımızı bilmediğimiz için yeniden fırlatıyoruz (Ders 13: yalnız elinden bir şey geleni yakala).
• JSON.parse metin bozuksa SyntaxError fırlatır. İçinde isim olmayan bir kayıt da işe yaramaz; onu kendi hatamızla (throw new Error) aynı yola sokuyoruz.
• Sondaki new Oyuncu(veri.isim, veri) şimdilik yarım iş görür: Oyuncu'nun yapıcısı ikinci bir argüman beklemiyor. Kayıttan yalnız adı alır, öteki değerleri görmezden gelir ve 1. seviyeden yeni bir oyuncu kurar. Nedenini ve çözümünü hemen görüyoruz.

#Düz obje sınıf değildir

JSON.parse sana bir obje verir, ama bu bir Oyuncu değil: verisi tamam, metotları yok.

1const metin = '{ "isim": "Ahri", "hp": 86 }'2const veri = JSON.parse(metin)3console.log(veri.isim)4console.log(veri.durum())

Ahrifile:///C:/kod/metin-rpg/deneme.js:4console.log(veri.durum())                 ^ TypeError: veri.durum is not a function    at file:///C:/kod/metin-rpg/deneme.js:4:18    ... Node.js v24.20.0

oyuncu.js'te yalnız yapıcıyı (constructor) değiştir; sınıfın geri kalanı aynı:

1export class Oyuncu {2    constructor(isim, kayit = {}) {3        this.isim = isim4        this.seviye = kayit.seviye ?? 15        this.xp = kayit.xp ?? 06        this.maxHp = kayit.maxHp ?? 1007        this.hp = kayit.hp ?? this.maxHp8        this.guc = kayit.guc ?? 129        this.gold = kayit.gold ?? 5010        this.iksir = kayit.iksir ?? 111    }

• kayit = {} varsayılan parametre (Ders 10): yeni oyunda new Oyuncu("Ahri") yazınca kayit boş bir obje olur.
• kayit.seviye ?? 1 (Ders 12): kayıtta seviye varsa onu, yoksa (undefined) 1'i kullanır. || değil ?? kullandık, çünkü 0 geçerli bir değer: xp ya da gold sıfır olabilir ve sıfır yanlış sayılıp varsayılana dönmemeli.
• this.hp = kayit.hp ?? this.maxHp: canı yazılmamış bir kayıt, en yüksek canla başlar. Bu satır bu yüzden maxHp satırının altında: this.maxHp önce dolmalı ki burada okunabilsin.

Bu yapının güzel bir yanı daha var: ileride oyuncuya yeni bir alan eklediğinde eski kayıt dosyaları bozulmaz; eksik alan varsayılan değeri alır.

Son olarak index.js: açılışta kaydı yüklemeyi dene, kayıt yoksa adı sor; menüde 4 kaydetsin. Bu, index.js'in son hâline çok yakın:

1import { Oyuncu } from "./oyuncu.js"2import { sor, secimIste, girdiyiKapat } from "./girdi.js"3import { savas } from "./savas.js"4import { dukkan } from "./dukkan.js"5import { kaydet, yukle } from "./kayit.js"6 7console.log("=== Sihirdar Vadisi: Metin RPG ===")8 9let oyuncu = await yukle()10if (oyuncu === null) {11    const isim = await sor("Kahramanının adı ne? ")12    oyuncu = new Oyuncu(isim || "İsimsiz")13    console.log(`Hoş geldin, ${oyuncu.isim}!`)14} else {15    console.log(`Kayıt bulundu. Tekrar hoş geldin, ${oyuncu.isim}!`)16}17 18while (true) {19    console.log("\n1) Savaş  2) Dükkân  3) Durum  4) Kaydet  5) Çık")20    const secim = await secimIste("Seçimin: ", 1, 5)21    if (secim === 5) {22        break23    } else if (secim === 1) {24        await savas(oyuncu)25    } else if (secim === 2) {26        await dukkan(oyuncu)27    } else if (secim === 3) {28        console.log(oyuncu.durum())29    } else if (secim === 4) {30        await kaydet(oyuncu)31    }32}33 34console.log("Görüşürüz!")35girdiyiKapat()

oyuncu artık let: ya kayıttan ya da yeni oluşturularak dolacak. Bir savaş yapıp kaydet ve çık:

PS C:\kod\metin-rpg> node index.js=== Sihirdar Vadisi: Metin RPG ===Kahramanının adı ne? AhriHoş geldin, Ahri! 1) Savaş  2) Dükkân  3) Durum  4) Kaydet  5) ÇıkSeçimin: 1 Karşına bir Minyon çıktı! (Can 30, Güç 6)1) Saldır  2) İksir iç  3) KaçSeçimin: 1Minyon 10 hasar aldı. Kalan canı: 20Minyon sana 5 hasar verdi. Canın: 95/1001) Saldır  2) İksir iç  3) KaçSeçimin: 1Minyon 15 hasar aldı. Kalan canı: 5Minyon sana 9 hasar verdi. Canın: 86/1001) Saldır  2) İksir iç  3) KaçSeçimin: 1Minyon 12 hasar aldı. Kalan canı: 0Minyon yenildi! +15 altın, +20 XP 1) Savaş  2) Dükkân  3) Durum  4) Kaydet  5) ÇıkSeçimin: 4Oyun kaydedildi: kayit.json 1) Savaş  2) Dükkân  3) Durum  4) Kaydet  5) ÇıkSeçimin: 5Görüşürüz!

VS Code'un dosya listesinde kayit.json belirdi. Aç ve içine bak:

1{2  "isim": "Ahri",3  "seviye": 1,4  "xp": 20,5  "maxHp": 100,6  "hp": 86,7  "guc": 12,8  "gold": 65,9  "iksir": 110}

Oyunu yeniden başlat. Bu kez ad sorulmaz; Ahri kaldığı yerden devam eder:

PS C:\kod\metin-rpg> node index.js=== Sihirdar Vadisi: Metin RPG ===Kayıt bulundu. Tekrar hoş geldin, Ahri! 1) Savaş  2) Dükkân  3) Durum  4) Kaydet  5) ÇıkSeçimin: 3Ahri | Seviye 1 | XP 20/50Can 86/100 | Güç 12 | Altın 65 | İksir 1 1) Savaş  2) Dükkân  3) Durum  4) Kaydet  5) ÇıkSeçimin: 5Görüşürüz!

Ara sürüm 6 hazır: oyun kaydediyor ve yüklüyor.

#Kayıt yoksa, kayıt bozuksa

yukle'deki try/catch'ler neden gerekli? Onlarsız ne olduğunu gör. Önce dosya yokken okumaya çalışan çıplak bir kod:

1import { readFile } from "node:fs/promises"2 3const metin = await readFile("kayit.json", "utf8")4console.log(metin)

PS C:\kod\metin-rpg> node deneme.jsnode:internal/fs/promises:1345  return new FileHandle(await PromisePrototypeThen(                        ^ Error: ENOENT: no such file or directory, open 'C:\kod\metin-rpg\kayit.json'    at async open (node:internal/fs/promises:1345:25)    at async readFile (node:internal/fs/promises:1996:14)    at async file:///C:/kod/metin-rpg/deneme.js:3:15 {  errno: -4058,  code: 'ENOENT',  syscall: 'open',  path: 'C:\\kod\\metin-rpg\\kayit.json'} Node.js v24.20.0

Dosya var ama bozuksa ne olur? Kayıt yarıda kesilmiş olabilir ya da biri onu elle bozmuş olabilir:

1const metin = '{ "isim": "Ahri", "seviye": 3,'2const veri = JSON.parse(metin)3console.log(veri)

<anonymous_script>:1{ "isim": "Ahri", "seviye": 3, SyntaxError: Expected double-quoted property name in JSON at position 30 (line 1 column 31)    at JSON.parse (<anonymous>)    ... Node.js v24.20.0

PS C:\kod\metin-rpg> node index.js=== Sihirdar Vadisi: Metin RPG ===Kayıt dosyası bozuk (Expected ',' or '}' after property value in JSON at position 76 (line 7 column 3)). Yeni oyun başlıyor.Kahramanının adı ne? LuxHoş geldin, Lux! 1) Savaş  2) Dükkân  3) Durum  4) Kaydet  5) ÇıkSeçimin: 5Görüşürüz!

#Adım 8: oyunu otomatik denemek

Her değişiklikten sonra oyunu baştan elle oynamak yorucu. Girdileri önceden hazırlayıp programa toplu verirsen saniyeler içinde dener, çıktıyı okursun. Bunun yolu boru.

PowerShell'de virgülle ayrılmış metinler bir liste olur; | bu listedeki her metni bir satır olarak node'a yollar. Ad olarak Ahri, sonra 3 (Durum), sonra 5 (Çık) verelim.

Bu deneme yeni bir oyunla başlamalı, yani proje klasöründe kayit.json olmamalı. Bozuk kaydı Adım 7'de sildin; sonradan yeniden kaydettiysen Remove-Item kayit.json ile sil. Kayıt dursaydı oyun ad sormadan ondan başlardı ve bütün girdiler bir soru kayardı. Şimdi dene:

PS C:\kod\metin-rpg> "Ahri", "3", "5" | node index.js=== Sihirdar Vadisi: Metin RPG ===Kahramanının adı ne? Ahri35Hoş geldin, Ahri! 1) Savaş  2) Dükkân  3) Durum  4) Kaydet  5) ÇıkSeçimin: Warning: Detected unsettled top-level await at file:///C:/kod/metin-rpg/index.js:20    const secim = await secimIste("Seçimin: ", 1, 5)                  ^

Bu beklediğimiz şey değil. Üç satırın üçü de en başta ekrana basıldı (readline okuduğu her şeyi ekrana da yazar), Durum hiç yazılmadı ve program bir uyarıyla kapandı. Neden?

Klavyeden oynarken her satırı Enter'la tek tek gönderirsin ve question o sırada hep bekliyordur. Borudan ise üç satır aynı anda gelir. question yalnız beklediği satırı (Ahri) alır.

Arkasından gelen 3 ve 5'i bekleyen kimse yoktur; readline onları bir kenara atar. Program ikinci soruda cevap beklemeye başlar, ama girdi çoktan bitmiştir. Node bekleyecek başka bir şey kalmadığını görünce programı kapatır ve uyarı verir.

PS C:\kod\metin-rpg> $LASTEXITCODE13

Çözüm, gelen satırları bir sıraya koymak ve her soruda sıradaki satırı almak. readline bunu hazır veriyor. girdi.js'in üst kısmını ve sor fonksiyonunu değiştir; secimeCevir aynı kalıyor, secimIste'ye üç satır ekleniyor:

1import { createInterface } from "node:readline/promises"2import { stdin, stdout } from "node:process"3 4const rl = createInterface({ input: stdin })5const satirlar = rl[Symbol.asyncIterator]()6 7export async function sor(soru) {8    stdout.write(soru)9    const sonuc = await satirlar.next()10    if (sonuc.done) {11        console.log()12        return null13    }14    if (!stdin.isTTY) {15        console.log(sonuc.value)16    }17    return sonuc.value.trim()18}19 20export function secimeCevir(metin, enAz, enCok) {21    const sayi = Number(metin)22    if (metin === "" || !Number.isInteger(sayi)) {23        throw new Error(`"${metin}" bir tam sayı değil`)24    }25    if (sayi < enAz || sayi > enCok) {26        throw new Error(`${enAz} ile ${enCok} arasında bir sayı yaz`)27    }28    return sayi29}30 31export async function secimIste(soru, enAz, enCok) {32    while (true) {33        const cevap = await sor(soru)34        if (cevap === null) {35            return null36        }37        try {38            return secimeCevir(cevap, enAz, enCok)39        } catch (hata) {40            console.log(`Geçersiz seçim: ${hata.message}.`)41        }42    }43}44 45export function girdiyiKapat() {46    rl.close()47}

• createInterface({ input: stdin }): bu kez output vermedik. readline artık ekrana hiçbir şey yazmıyor; soruyu biz yazıyoruz. Klavyeden yazdıklarını terminal yine kendisi gösterir.
• rl[Symbol.asyncIterator](): gelen satırları sırayla, hiçbirini kaybetmeden veren bir satır sırası kurar. Köşeli parantezli bu yazım, JavaScript'in "sırayla ve bekleyerek değer veren şeyler" için kullandığı özel bir anahtar. Zamanla parça parça gelen veriyi sırayla bekleme fikri Ders 27'de yeniden karşına çıkacak; şimdilik kalıp olarak yaz.
• stdout.write(soru): console.log gibi yazar ama sonuna yeni satır koymaz; cevap sorunun yanına gelsin diye.
• await satirlar.next(): sıradaki satırı bekler, satır hazırsa hemen verir. Sonuç bir obje: { value: "3", done: false }. Girdi bittiyse done true olur; o zaman boş bir console.log() ile sorunun satırını bitirip null döndürüyoruz.
• stdin.isTTY: girdi klavyeden, yani bir terminalden geliyorsa true (TTY, eski dilde terminal demek), borudan geliyorsa undefined. Klavyede yazdığını terminal zaten gösterir. Borudan gelen satır ise ekrana düşmez; onu biz yazdırıyoruz ki çıktı elle oynanmış gibi okunsun.
• secimIste de null görünce null döndürüyor: "cevap gelmeyecek".

null yeni bir anlaşma: artık secimIste "cevap yok" diyebiliyor. Onu kullanan üç yer de bunu dinlemeli. Dinlemezse menü null ile dönmeye devam eder ve saniyede binlerce kez ekrana basılır; Ctrl+C ile durdurman gerekir. Üç küçük değişiklik:

20    const secim = await secimIste("Seçimin: ", 1, 5)21    if (secim === null || secim === 5) {22        break

20        const secim = await secimIste("1) Saldır  2) İksir iç  3) Kaç\nSeçimin: ", 1, 3)21        if (secim === null) {22            return23        }

35        const secim = await secimIste("Ne alacaksın? ", 0, URUNLER.length)36        if (secim === null || secim === 0) {37            return

savas.js'teki üç satır yeni; index.js ve dukkan.js'te yalnız koşul uzadı. Aynı denemeyi tekrarla:

PS C:\kod\metin-rpg> "Ahri", "3", "5" | node index.js=== Sihirdar Vadisi: Metin RPG ===Kahramanının adı ne? AhriHoş geldin, Ahri! 1) Savaş  2) Dükkân  3) Durum  4) Kaydet  5) ÇıkSeçimin: 3Ahri | Seviye 1 | XP 0/50Can 100/100 | Güç 12 | Altın 50 | İksir 1 1) Savaş  2) Dükkân  3) Durum  4) Kaydet  5) ÇıkSeçimin: 5Görüşürüz!

Her girdi doğru soruya gitti ve çıktı, elle oynanmış bir oyun gibi okunuyor. Girdiler erken biterse de program artık takılmıyor:

PS C:\kod\metin-rpg> "Ahri", "3" | node index.js=== Sihirdar Vadisi: Metin RPG ===Kahramanının adı ne? AhriHoş geldin, Ahri! 1) Savaş  2) Dükkân  3) Durum  4) Kaydet  5) ÇıkSeçimin: 3Ahri | Seviye 1 | XP 0/50Can 100/100 | Güç 12 | Altın 50 | İksir 1 1) Savaş  2) Dükkân  3) Durum  4) Kaydet  5) ÇıkSeçimin:Görüşürüz!

Bir değişiklik daha oldu: klavyeyle oynarken Ctrl+C artık AbortError yazmıyor, oyunu anında ve sessizce kapatıyor. Kaydetmediğin ilerleme gider; düzgün çıkış yine 5. Ara sürüm 7, yani oyunun son hâli hazır.

#Modüllere bölmek: geriye bakış

Adım 8'de girdi okumanın yolunu baştan değiştirdik. Değişiklik neredeyse tamamen girdi.js'in içinde kaldı; öteki dosyalarda yalnız null denetimi eklendi. Oyuncu sınıfına, kayıt koduna, düşmanlara ve ürünlere hiç dokunmadık. Kodu modüllere bölmenin karşılığını tam burada alırsın.

Bu projeden yanına alacağın kurallar:

• Bir dosya, bir iş. Dosyanın adı işini söylesin. "Bu kod nereye gider?" sorusunun cevabı tek olsun.
• Oklar tek yönlü. index.js herkesi kullanır, onu kimse kullanmaz; bir modül de kendisini kullanan modülü geri import etmez. İki dosyanın birbirini import etmesi (döngüsel import) kafa karıştırır, kaçın.
• Yalnız gerekeni dışa aktar. DUSMANLAR, zar ve URUNLER kendi dosyalarının içinde kaldı. Kimsenin bilmediği bir şeyi değiştirmek kolaydır.
• Ekrana yazmak ile hesaplamak ayrı olsun. durum() metin döndürüyor, secimeCevir sayı ya da hata döndürüyor; ikisi de bu yüzden tek başına denenebildi.

Projenin son hâli, VS Code'da:

1import { Oyuncu } from "./oyuncu.js"2import { sor, secimIste, girdiyiKapat } from "./girdi.js"3import { savas } from "./savas.js"4import { dukkan } from "./dukkan.js"5import { kaydet, yukle } from "./kayit.js"6 7console.log("=== Sihirdar Vadisi: Metin RPG ===")8 9let oyuncu = await yukle()10if (oyuncu === null) {11    const isim = await sor("Kahramanının adı ne? ")12    oyuncu = new Oyuncu(isim || "İsimsiz")13    console.log(`Hoş geldin, ${oyuncu.isim}!`)14} else {15    console.log(`Kayıt bulundu. Tekrar hoş geldin, ${oyuncu.isim}!`)16}17 18while (true) {19    console.log("\n1) Savaş  2) Dükkân  3) Durum  4) Kaydet  5) Çık")20    const secim = await secimIste("Seçimin: ", 1, 5)21    if (secim === null || secim === 5) {22        break23    } else if (secim === 1) {24        await savas(oyuncu)25    } else if (secim === 2) {26        await dukkan(oyuncu)27    } else if (secim === 3) {28        console.log(oyuncu.durum())29    } else if (secim === 4) {30        await kaydet(oyuncu)31    }32}33 34console.log("Görüşürüz!")35girdiyiKapat()

PS C:\kod\metin-rpg> npm start > metin-rpg@1.0.0 start> node index.js === Sihirdar Vadisi: Metin RPG ===Kahramanının adı ne? AhriHoş geldin, Ahri! 1) Savaş  2) Dükkân  3) Durum  4) Kaydet  5) ÇıkSeçimin: 4Oyun kaydedildi: kayit.json 1) Savaş  2) Dükkân  3) Durum  4) Kaydet  5) ÇıkSeçimin: 5Görüşürüz!

#README, .gitignore ve GitHub

Oyun bitti; şimdi onu başkalarına gösterilecek hâle getir. Önce deneme dosyalarını (deneme.js, savas-deneme.js) sil: VS Code'da dosyaya sağ tıkla, Delete. Proje deposunda yalnız oyunun kendisi kalsın.

#README.md

GitHub bir deponun ana sayfasında README.md dosyasını gösterir (Ders 7). Bir işverenin ya da arkadaşının projeni anlamak için ilk okuyacağı şey o. Proje klasöründe README.md adında yeni bir dosya oluştur:

1# Metin RPG2 3Terminalde oynanan küçük bir rol yapma oyunu. Sihirdar Vadisi'nde canavarlarla savaş, altın topla, dükkândan eşya al, seviye atla ve ilerlemeni kaydet.4 5## Özellikler6 7- Menülü oyun döngüsü: savaş, dükkân, durum, kaydet, çık8- Rastgele düşmanlar ve tur tur savaş (saldır, iksir iç, kaç)9- Altın, tecrübe puanı (XP) ve seviye atlama10- Kaydetme ve yükleme (`kayit.json`)11- Yanlış girdiye dayanıklı menüler12 13## Nasıl çalıştırılır?14 15Gerekenler: [Node.js](https://nodejs.org) 24 ya da daha yeni bir sürüm.16 17```18git clone https://github.com/denizyilmaz/metin-rpg.git19cd metin-rpg20npm start21```22 23Proje hiçbir paket kullanmıyor; `npm install` gerekmez. Oyun ilerlemeni `kayit.json` dosyasına yazar; bu dosya Git'e eklenmez.24 25## Ekran çıktısı26 27```28=== Sihirdar Vadisi: Metin RPG ===29Kahramanının adı ne? Ahri30Hoş geldin, Ahri!31 321) Savaş  2) Dükkân  3) Durum  4) Kaydet  5) Çık33Seçimin: 134 35Karşına bir Minyon çıktı! (Can 30, Güç 6)361) Saldır  2) İksir iç  3) Kaç37Seçimin: 138Minyon 11 hasar aldı. Kalan canı: 1939```40 41## Dosyalar42 43| Dosya | Görevi |44|---|---|45| `index.js` | Açılış ve ana menü döngüsü |46| `girdi.js` | Klavyeden satır okuma, seçim doğrulama |47| `oyuncu.js` | `Oyuncu` sınıfı: can, altın, seviye, iksir |48| `savas.js` | Rastgele düşman ve savaş |49| `dukkan.js` | Eşya listesi ve satın alma |50| `kayit.js` | `kayit.json` dosyasına yazma ve okuma |51 52## Neler öğrendim?53 54Node.js'te kullanıcıdan girdi almak (`node:readline/promises`), kodu modüllere bölmek, sınıf kullanmak, dosyaya JSON kaydetmek ve hatalı girdiyi yakalamak.