tetrigo

Tetrigo

teh·pohon·pergi

Implementasi Golang dari Tetris, mengikuti Pedoman Desain Tetris resmi tahun 2009.

Proyek ini terdiri dari tiga komponen utama, bergantung pada tujuan Anda:

• "Aku hanya ingin bermain Tetris"
  • TUI (Antarmuka Pengguna Teks) di cmd/tetrigo/ cocok untuk Anda. Lihat bagian instalasi.
• "Saya ingin membuat game/UI Tetris saya sendiri"
  • Paket-paket di pkg/tetris/modes/ ditujukan untuk Anda. Anda dapat menggunakan kembali mode permainan ini dengan UI Anda sendiri.
• "Saya ingin membuat mode permainan Tetris saya sendiri"
  • Paket di pkg/tetris/ ditujukan untuk Anda. Anda dapat membuat mode permainan Anda sendiri dengan serangkaian aturan dan persyaratan khusus.

Anda dapat menemukan informasi lebih lanjut tentang bagian ini di bagian pengembangan. Jika Anda memiliki saran, bug, atau permintaan fitur, silakan buka masalah GitHub.

Isi

• Instalasi
• Penggunaan
• Konfigurasi
• Data
• Perkembangan

Instalasi

Tetrigo dapat diinstal dengan mengunduh biner atau membangun dari sumber. Lihat petunjuk di bawah untuk metode pilihan Anda.

Biner

Anda dapat mengunduh biner yang sesuai dengan sistem operasi Anda dari halaman rilis di GitHub.

Setelah diunduh, Anda dapat menjalankan biner dari baris perintah:

 # Linux or macOS
./tetrigo

# Windows
tetrigo.exe

Secara opsional, Anda dapat memindahkan biner ke direktori di $PATH Anda untuk menjalankannya dari mana saja (contoh).

Bangun Dari Sumber

Pastikan Anda telah menginstal dan mengatur versi Go yang didukung dengan benar. Anda dapat menemukan versi minimum Go yang diperlukan di file go.mod.

Anda kemudian dapat menginstal rilis terbaru secara global dengan menjalankan:

go install github.com/Broderick-Westrope/tetrigo/cmd/tetrigo@latest

Atau Anda dapat menginstal ke direktori lain:

env GOBIN=/bin go install github.com/Broderick-Westrope/tetrigo/cmd/tetrigo@latest

Penggunaan

Untuk informasi umum tentang cara bermain Tetris, lihat panduan pemula ini.

Kontrol

Kontrol permainan default adalah sebagai berikut:

• Pindah ke Kiri : A
• Pindah ke Kanan : D
• Alihkan Soft Drop On/Off : S
• Jatuh Keras : W
• Putar Searah Jarum Jam : E
• Putar Berlawanan Arah Jarum Jam : Q
• Tahan opsi menu Tetrimino / Kirim : Space atau Enter
• Jeda Permainan / Keluar : Escape
• Keluar Paksa dari permainan : Ctrl+C
• Tampilkan Kontrol Bantuan : ?

Kontrol permainan dapat diubah di file konfigurasi.

Menu, papan peringkat, dll dapat dinavigasi menggunakan tombol panah (bergerak), escape (keluar), dan enter (kirim). Kontrol ini tidak dapat dikonfigurasi.

Konfigurasi

CLI

Memulai Tetrigo tanpa subperintah atau tanda akan memulai permainan di menu tempat Anda dapat mengonfigurasi pengaturan sederhana secara manual seperti nama pemain dan mode permainan:

./tetrigo

Anda juga dapat memulai permainan secara langsung dalam mode permainan (misalnya Marathon), melewati menu:

 # Start the game in Marathon mode with a level of 5 and the player name "Brodie"
./tetrigo play marathon --level=5 --name=Brodie 

Untuk melihat lebih banyak opsi untuk memulai permainan, Anda dapat menjalankan:

./tetrigo --help

TOML

Konfigurasi yang lebih kompleks dapat dilakukan dengan menggunakan file TOML. Jika tidak ada file konfigurasi yang ditemukan, default yang masuk akal akan digunakan.

Secara default, Tetrigo akan mencari file ./tetrigo/config.toml di dalam direktori konfigurasi XDG perangkat (atau yang setara). adrg/xdg mendefinisikan nilai XDG_CONFIG_HOME untuk berbagai sistem operasi (mis. pada macOS, direktori ~/Library/Application Support ada maka akan disimpan di sana, jika tidak di ~/Library/Preferences ). Anda dapat menentukan file lain menggunakan flag --config .

./tetrigo --config=/path/to/config.toml

Contoh file konfigurasi disediakan di example.config.toml .

Data

Data permainan disimpan dalam database SQLite. Secara default, database disimpan di ./tetrigo/tetrigo.db dalam direktori data perangkat XDG (atau yang setara). Adrg/xdg mendefinisikan XDG_DATA_HOME untuk berbagai sistem operasi (mis. di macOS jika direktori ~/Library/Application Support ada maka akan disimpan di sana, jika tidak di /Library/Application Support ). Anda dapat menentukan jalur file yang berbeda menggunakan flag --db .

./tetrigo --db=/path/to/data.db

Perkembangan

Proyek ini terdiri dari tiga komponen utama:

1. cmd/tetrigo/ : TUI (Antarmuka Pengguna Teks) yang memungkinkan Anda memainkannya secara langsung. Ini juga sebagai demonstrasi cara penggunaan paket dan cara membuat TUI menggunakan Bubble Tea.
2. pkg/tetris/modes/ : Fungsionalitas untuk mode permainan Tetris yang berbeda. Ini dapat digunakan untuk membuat game Tetris dengan mudah dengan UI Anda sendiri tetapi tanpa perlu mengetahui aturannya.
3. pkg/tetris/ : Logika inti Tetris, termasuk hal-hal seperti Tetrminimos, Matriks, dan penilaian. Ini dapat digunakan untuk membuat mode permainan dengan aturan dan persyaratan Anda sendiri.

Tugas adalah alat pembangunan yang digunakan dalam proyek ini. Konfigurasi Tugas ada di Taskfile.yaml. Setelah Task CLI diinstal, Anda dapat melihat semua tugas yang tersedia dengan menjalankan:

task -l

Anda dapat menjalankan TUI menggunakan tugas run :

task run

Bangunan

Anda dapat membangun proyek menggunakan tugas build :

task build

Ini akan membuat biner di direktori bin/ yang dapat dijalankan menggunakan instruksi di bagian Instalasi.

Pengujian

Pengujian dapat dijalankan menggunakan tugas test :

task test

Anda juga dapat menggunakan tugas cover untuk membuat dan membuka laporan cakupan:

task cover

Urutan prioritas pengujian adalah:

1. pkg/tetris/
2. pkg/tetris/modes/
3. cmd/tetrigo/

TODO

• Tambahkan lebih banyak tes
  • Tambahkan tes untuk mencetak endOnMaxLevel.
  • Kunjungi kembali tes penilaian.
• Tambahkan opsi Lock Down yang tersisa.
• Periksa Lock Down 0,5 detik setelah mendarat di permukaan
  • Juga di Soft Drop, tetapi tidak di Hard Drop.
  • Ini direset setelah setiap gerakan & rotasi, dengan total 15 gerakan/rotasi.
  • Lihat "Penguncian Penempatan Diperpanjang" dalam pedoman desain.
• Skor poin dari T-Spins
• SSH Multiplayer (mirip dengan Gambit)