Go Board Indo

Mesin logika (headless library) sederhana untuk permainan papan Go (Baduk/Weiqi) yang ditulis dalam JavaScript. Library ini menyediakan aturan inti permainan dan manajemen state, memungkinkan Anda untuk membangun aplikasi Go di atasnya.

Proyek ini dibuat sebagai bagian dari sesi interaktif dengan AI Gemini.

Fitur Utama

• Validasi langkah dasar (di dalam papan, di titik kosong).
• Mekanisme penangkapan grup batu.
• Aturan Bunuh Diri (ilegal dan legal karena menangkap).
• Aturan Ko untuk mencegah perulangan permainan.
• Penghitungan Skor di akhir permainan berdasarkan teritori dan tawanan.
• Dibangun dengan pendekatan Test-Driven Development (TDD) menggunakan Jest.

Instalasi

(Setelah dipublikasikan ke NPM)

npm install go-board-indo

Penggunaan Dasar

Berikut adalah contoh dasar cara menggunakan library ini:

const GoGame = require('go-board-indo'); // Sesuaikan path jika digunakan secara lokal

// Membuat game baru dengan papan 9x9
const game = new GoGame(9);

// Pemain Hitam (1) melangkah
game.makeMove(3, 3);

// Pemain Putih (2) melangkah
game.makeMove(4, 4);

// Melihat kondisi papan saat ini
const boardState = game.getBoard();
console.log(boardState);

// Jika permainan selesai, hitung skor
// const finalScore = game.calculateScore();
// console.log(finalScore);

API Metode yang Tersedia

• new GoGame(size): Membuat instance game baru. size bisa 9, 13, atau 19 (default).
• makeMove(x, y): Melakukan langkah untuk pemain yang sedang giliran. Mengembalikan true jika sah, false jika tidak.
  • x: Koordinat horizontal (kolom). Dimulai dari 0 di sisi paling kiri.
  • y: Koordinat vertikal (baris). Dimulai dari 0 di sisi paling atas.
  • Contoh: makeMove(0, 0) akan meletakkan batu di pojok kiri atas papan.
• getBoard(): Mengembalikan kondisi papan saat ini dalam bentuk Array 2D.
• calculateScore(komi): Menghitung skor di akhir permainan. komi adalah opsional (default 6.5).

Penting: Mengenai Batu Mati (Dead Stones)

Fungsi calculateScore() dirancang untuk menghitung skor pada kondisi papan akhir yang sudah "bersih". Ini berarti fungsi ini tidak secara otomatis mendeteksi "batu mati" (grup batu yang terperangkap di dalam wilayah lawan tetapi belum ditangkap secara teknis).

Penentuan batu mati adalah fase kompleks yang biasanya terjadi setelah kedua pemain pass. Dalam aplikasi nyata, mekanisme ini umumnya diatur oleh logika aplikasi server, bukan di dalam library aturan inti:

1. Fase Penandaan: Pemain menandai grup mana yang mereka anggap mati.
2. Persetujuan: Kedua pemain harus setuju dengan status batu mati tersebut.
3. Eksekusi: Setelah disetujui, server akan menghapus batu-batu mati dari papan dan menambahkannya ke hitungan tawanan.
4. Kalkulasi Akhir: Barulah fungsi calculateScore() dipanggil pada papan yang sudah bersih ini untuk mendapatkan hasil final.

Pemisahan ini menjaga agar library tetap fokus pada aturan murni, sementara logika interaktif (seperti persetujuan pemain) ditangani di level aplikasi.

Logika Detail

1. Pembentukan Papan (Constructor Logic)

Saat Anda membuat instance baru dengan new GoGame(size), constructor akan berjalan untuk menyiapkan permainan:

• Papan direpresentasikan sebagai Array 2D (array di dalam array).
• Setiap titik di papan diinisialisasi dengan nilai 0 yang berarti kosong.
• Batu Hitam direpresentasikan dengan nilai 1.
• Batu Putih direpresentasikan dengan nilai 2.

Contoh Internal: new GoGame(3) akan membuat properti this.board berisi:

[
  [0, 0, 0],
  [0, 0, 0],
  [0, 0, 0]
]

2. Logika Langkah (makeMove)

Fungsi makeMove(x, y) adalah inti dari mesin ini. Ia bekerja seperti wasit yang menjalankan serangkaian validasi secara berurutan sesuai flowchart yang telah dirancang:

1. Validasi Awal:
   • Apakah langkah di luar papan? Jika ya, gagal.
   • Apakah titik sudah terisi batu lain? Jika ya, gagal.
2. Langkah Sementara: Batu diletakkan di papan untuk dianalisis konsekuensinya.
3. Logika Penangkapan:
   • Memeriksa semua grup batu lawan yang bersebelahan.
   • Jika ada grup lawan yang libertinya (jalan napas) menjadi 0 setelah langkah ini, grup tersebut ditangkap dan dihapus dari papan.
4. Logika Bunuh Diri:
   • Setelah proses penangkapan, fungsi akan memeriksa grup dari batu yang baru saja diletakkan.
   • Jika tidak ada batu yang ditangkap DAN grup batu baru tersebut tidak memiliki liberti, maka langkah itu dianggap bunuh diri ilegal dan gagal.
5. Logika Aturan Ko:
   • Memeriksa apakah kondisi papan yang baru terbentuk ini sama persis dengan kondisi papan di giliran sebelumnya.
   • Jika ya, langkah ini melanggar aturan Ko dan gagal.
6. Finalisasi:
   • Jika semua validasi lolos, langkah dinyatakan sah.
   • Giliran dialihkan ke pemain berikutnya.
   • Fungsi mengembalikan true dan koordinat batu jika ada batu yang ditangkap.

// Contoh ringkas alur di dalam makeMove
function makeMove(x, y) {
    // 1. Validasi Awal (batas & titik terisi)
    // ...

    // 2. Letakkan batu sementara
    // ...

    // 3. Cek & lakukan penangkapan
    // ...

    // 4. Cek aturan bunuh diri
    // ...

    // 5. Cek aturan Ko
    // ...

    // 6. Finalisasi & ganti giliran
    return {
            isValid: true,
            capturedStones: capturedStoneCoords
        };
}

Menjalankan Tes

Untuk menjalankan semua tes yang ada, gunakan perintah:

npm test

Lisensi

Proyek ini dilisensikan di bawah MIT License.