Tugas Besar 1 IF2010 Pemrograman Berorientasi Objek ~ Nimonspoli — CLI Monopoly Game

Nimonspoli adalah permainan papan simulasi perdagangan properti berbasis Command-Line Interface (CLI) yang ditulis dalam C++17. Proyek ini dikembangkan untuk mata kuliah IF2010 — Pemrograman Berorientasi Objek (Tubes 1) dengan fokus pada penerapan prinsip-prinsip OOP: Encapsulation, Inheritance, Polymorphism, dan Abstraction.

Fitur Utama

Gameplay Klasik Monopoly — pergerakan dadu, jual-beli properti, sewa, pajak, penjara, dan kondisi kemenangan.
Tiga Jenis Properti — Street (dengan rumah & hotel), Railroad (sewa progresif), dan Utility (sewa berdasarkan dadu).
Sistem Ekonomi Lengkap — gadai/tebus, lelang otomatis ketika pemain menolak membeli, monopoli warna untuk syarat membangun, dan likuidasi aset saat hampir bangkrut.
Tiga Jenis Kartu — Chance Card, Community Chest Card, dan Skill Card yang bisa disimpan & digunakan sebelum melempar dadu.
Penjara dengan Aturan Lengkap — masuk via petak Ke_Penjara/kartu/triple-double, keluar via dadu double, bayar denda, atau habisnya batas giliran.
Save / Load — simpan progres permainan ke data/<nama>.txt lalu muat kembali kapan saja.
Transaction Logger — semua aksi penting tercatat dan dapat ditampilkan dengan CETAK_LOG.
Multi-Player — mendukung 2–4 pemain dalam satu sesi.

Persyaratan Sistem

Komponen	Minimum
Compiler	GCC / G++ dengan dukungan C++17
Build Tool	`make` (Linux/macOS/WSL) atau `mingw32-make` (Win)
OS	Linux, macOS, atau Windows (native + WSL)
Terminal	Mendukung ANSI escape code (warna)

Catatan Windows: Disarankan menggunakan terminal yang mendukung warna ANSI (Windows Terminal, PowerShell 7, atau Git Bash) untuk pengalaman tampilan terbaik.

Instalasi & Build

1. Klona Repositori

git clone <repository-url>
cd tugas-besar-1-dj1

2. Build

Linux / macOS / WSL:

make

Windows (MinGW):

mingw32-make

Hasil kompilasi akan tersedia di bin/game (atau bin/game.exe di Windows). File objek perantara berada di build/.

3. Membersihkan Build

make clean        # Linux/macOS/WSL
mingw32-make clean # Windows

Menjalankan Permainan

./bin/game           # Linux/macOS/WSL
bin\game.exe         # Windows

Saat pertama kali dijalankan, program akan menanyakan:

Apakah ingin memuat permainan tersimpan? (y/n)
Jika baru: jumlah pemain (2–4) dan nama setiap pemain.
Permainan dimulai dengan papan yang ditampilkan dan giliran berputar.

Alur Permainan

┌──────────────┐
│  Mulai Turn  │ ── tarik 1 Skill Card otomatis
└──────┬───────┘
       │
       ▼
┌─────────────────────────┐
│  Sebelum lempar dadu:   │
│  • GUNAKAN_KEMAMPUAN    │
│  • GADAI / TEBUS        │
│  • BANGUN               │
│  • SIMPAN / CETAK_*     │
└──────┬──────────────────┘
       │
       ▼
┌──────────────────┐
│  LEMPAR_DADU     │ → bergerak → trigger startEvent petak tujuan
└──────┬───────────┘
       │
       ▼
┌──────────────────────────┐
│  Resolve Landing:        │
│  • Beli/Sewa properti    │
│  • Bayar pajak           │
│  • Tarik Chance/Dana Umum│
│  • Festival, Penjara, dll│
└──────┬───────────────────┘
       │
       ▼
   (Double? ulang LEMPAR_DADU; Triple double → Penjara)
       │
       ▼
┌──────────────┐
│     END      │ → giliran pindah ke pemain berikutnya
└──────────────┘

Kondisi permainan selesai:

Single Survivor — hanya satu pemain yang belum bangkrut.
MAX TURN — total giliran melampaui batas dari config/misc.txt. Pemenang ditentukan dari total kekayaan (cash + nilai aset).

Daftar Perintah

Semua perintah tidak peka huruf besar/kecil dan menerima alias bahasa Inggris.

Tampilan & Info

Perintah	Alias	Deskripsi
`CETAK_PAPAN`	`PRINT_BOARD`	Tampilkan papan + posisi semua pemain
`CETAK_AKTA <KODE>`	`PRINT_DEED`	Tampilkan akta properti (mis. `CETAK_AKTA KSB`)
`CETAK_PROPERTI`	`PRINT_PROPERTY`	Daftar properti milik pemain aktif
`CETAK_LOG [N]`	—	Tampilkan N entri log terakhir (kosong = semua)
`HELP`	—	Daftar perintah

Giliran & Dadu

Perintah	Alias	Deskripsi
`LEMPAR_DADU`	`ROLL`	Lempar dadu acak dan bergerak
`ATUR_DADU <X> <Y>`	`SETDICE`, `SET_DICE`	Atur hasil dadu manual (X,Y ∈ [1..6])
`END`	—	Akhiri giliran (wajib sudah `ROLL`)

Properti

Perintah	Alias	Deskripsi
`GADAI`	`MORTGAGE`	Gadaikan properti (level 0) ke bank
`TEBUS`	`REDEEM`	Tebus properti yang sedang digadaikan
`BANGUN`	`BUILD`	Bangun rumah / upgrade hotel (syarat: monopoli warna penuh)

Kartu Kemampuan

Perintah	Alias	Deskripsi
`GUNAKAN_KEMAMPUAN [N]`	`USE_SKILL`	Aktifkan kartu ke-N (kosong = pilih interaktif)

Kartu kemampuan hanya dapat digunakan sebelum LEMPAR_DADU dan maksimal sekali per giliran.

Penjara

Perintah	Alias	Deskripsi
`BAYAR_DENDA`	`PAY_JAIL_FINE`, `PAY_FINE`, `PAYJAIL`	Bayar denda untuk keluar dari penjara

Save

Perintah	Alias	Deskripsi
`SIMPAN <NAMA_FILE>`	`SAVE`	Simpan state ke `data/<nama>.txt`

Perintah Otomatis (tidak perlu diketik)

BELI, BAYAR_SEWA, BAYAR_PAJAK, LELANG, FESTIVAL, BANGKRUT, MENANG, dan tarikan Kesempatan / Dana Umum dipicu oleh engine ketika kondisi terpenuhi.

Petak (Plot) di Papan

Hierarki kelas petak:

Plot (abstract)
├── PropertyPlot
│   ├── LandPlot      (Street — bisa rumah & hotel)
│   ├── StationPlot   (Railroad — sewa progresif)
│   └── UtilityPlot   (PLN/PAM — sewa = pengali × dadu)
├── ActionPlot
│   ├── CardPlot
│   │   ├── ChanceCardPlot         (KSP — Kesempatan)
│   │   └── CommunityChestCardPlot (DNU — Dana Umum)
│   ├── FestivalPlot
│   ├── TaxPlot
│   │   ├── IncomeTaxPlot   (PPH)
│   │   └── LuxuryTaxPlot   (PBM)
└── SpecialPlot
    ├── StartPlot     (GO)
    ├── PrisonPlot    (PEN)
    ├── GoPrisonPlot  (PPJ — kirim ke penjara)
    └── FreeParkPlot  (BBP)

Konfigurasi default papan: 40 petak, kombinasi 22 Street, 4 Railroad, 2 Utility, 2 Tax, 3 Chance, 3 Community Chest, 4 Special.

Sistem Kartu

Skill Card (kartu kemampuan spesial)

Diambil otomatis 1 buah di awal setiap giliran. Maksimum 3 kartu di tangan; kelebihan harus dibuang.

Kartu	Efek
`MoveCard`	Maju N petak (N acak 1–12, ditetapkan saat kartu didapat)
`TeleportCard`	Pilih petak tujuan secara bebas
`ShieldCard`	Lindungi dari satu efek negatif (sewa, pajak, kartu)
`DiscountCard`	Diskon harga properti / pembangunan
`LassoCard`	Klaim properti yang belum dimiliki dengan harga lelang
`DemolitionCard`	Hancurkan satu bangunan milik lawan

Chance Card (Kesempatan — KSP)

Kartu	Efek
`BackwardMoveCard`	Mundur 3 petak (memicu startEvent petak tujuan)
`StationCard`	Pindah ke stasiun terdekat (memicu startEvent)
`PrisonCard`	Langsung dipenjara 3 giliran

Community Chest Card (Dana Umum — DNU)

Kartu	Efek
`BirthdayCard`	Terima M100 dari setiap pemain lain
`CampaignCard`	Bayar M200 ke setiap pemain lain
`DoctorCard`	Bayar M700 ke bank

Kartu pergerakan (MoveCard, TeleportCard, BackwardMoveCard, StationCard) secara otomatis memicu startEvent pada petak tujuan — sehingga jika mendarat di properti orang lain, sewa langsung dibayarkan.

Mekanika Khusus

Dadu & Double

Dua dadu sisi enam.
Double (kedua dadu sama) → giliran tambahan setelah resolve landing.
Triple double berturut-turut → langsung masuk penjara.

Penjara

Maksimum 3 giliran di penjara.
Cara keluar: lempar double, bayar denda (default M50), atau habis batas giliran (otomatis bayar denda — bangkrut bila tidak mampu).

Monopoli & Pembangunan

Syarat BANGUN: pemain menguasai seluruh Street dalam satu color group dan tidak ada yang digadaikan.
Pembangunan harus merata — petak baru bisa di-upgrade hanya bila levelnya = level minimum di group.
Level: 1–4 = rumah, 5 = hotel.

Sewa

Street: dasar / 2× dasar (monopoli tanpa bangunan) / sesuai level rumah-hotel.
Railroad: pengali × jumlah railroad yang dimiliki owner (config/railroad.txt).
Utility: pengali × hasil dadu pemain yang mendarat (config/utility.txt).

Lelang

Dipicu otomatis saat pemain menolak membeli properti yang belum bertuan.
Semua pemain non-bangkrut ikut bidding hingga harga mentok.

Festival

Petak Festival (jika ada di papan) memberi efek bonus/penalti khusus pada properti milik pemain di group warna tertentu.

Bangkrut & Likuidasi

Pemain pertama dibantu liquidate aset (gadai otomatis) bila masih bisa diselamatkan.
Bila tetap kurang → BANGKRUT. Asetnya:
- Diserahkan ke kreditor (bila ada),
- Atau dilelang ke pemain tersisa (bila kreditor = bank/null).

Format File Konfigurasi

Semua konfigurasi berada di folder config/. Format umum: satu record per baris, whitespace-separated.

`config/aksi.txt` — Petak aksi & spesial

<index> <kode> <nama> <kategori> <subtype>

Contoh:

0  GO   Start             SPESIAL DEFAULT
4  PPH  Pajak_Penghasilan PAJAK   DEFAULT
7  KSP  Kesempatan_1      KARTU   DEFAULT
10 PEN  Penjara           SPESIAL DEFAULT
30 PPJ  Ke_Penjara        SPESIAL DEFAULT
38 PBM  Pajak_Barang_Mewah PAJAK  DEFAULT

`config/property.txt` — Petak properti

Setiap properti memiliki dua baris: header & detail.

Street (header lalu detail level 0–5):

<index> <kode> <nama> STREET <warna> <buyPrice> <mortgage> <upHouse> <upHotel>
<index> <kode> <nama> STREET <rentLv0> <rentLv1> <rentLv2> <rentLv3> <rentLv4> <rentLv5>

Railroad (satu baris):

<index> <kode> <nama> RAILROAD DEFAULT <buyPrice> <mortgage>

Utility (satu baris):

<index> <kode> <nama> UTILITY DEFAULT <buyPrice> <mortgage>

`config/railroad.txt` — Multiplier sewa railroad

<jumlahDimiliki> <multiplier>

`config/utility.txt` — Multiplier sewa utility

<jumlahDimiliki> <multiplier>   # multiplier × hasil dadu

`config/tax.txt` — Pajak

<flatPPH> <persenPPH> <flatPBM>

`config/special.txt` — Gaji & denda

<gajiGO> <dendaPenjara>

`config/misc.txt` — Aturan umum

<maxTurn> <startingCash>

Save & Load

Simpan: SIMPAN <nama>.txt (hanya sebelum LEMPAR_DADU).
File tersimpan di folder data/ sebagai teks ASCII, berisi snapshot lengkap (papan, pemain, kartu di tangan, deck, dll).
Load: dipilih saat program start (Apakah anda ingin memuat permainan tersimpan? y).
Bila file timpa: program akan meminta konfirmasi.

Struktur Proyek

tugas-besar-1-dj1/
├── bin/                         # Executable hasil build
├── build/                       # File objek (.o)
├── config/                      # Konfigurasi default papan & ekonomi
│   ├── aksi.txt
│   ├── property.txt
│   ├── railroad.txt
│   ├── utility.txt
│   ├── tax.txt
│   ├── special.txt
│   └── misc.txt
├── data/                        # File save permainan
├── docs/                        # Dokumentasi tambahan
├── include/                     # Header files (.hpp)
│   ├── core/                    # Engine, GameState, Command, Services
│   │   └── services/            # AuctionService, BankruptcyService, EffectResolver, CommandHandler
│   ├── models/
│   │   ├── Board/               # Board, Dice, CardDeck
│   │   ├── Player/              # Player, PlayerStatus
│   │   ├── Plot/                # Plot hierarchy
│   │   │   ├── ActionPlot/      # Card / Festival / Tax plots
│   │   │   ├── PropertyPlot/    # Land / Station / Utility
│   │   │   └── SpecialPlot/     # Start / Prison / GoPrison / FreePark
│   │   └── Card/
│   │       ├── ChanceCard/
│   │       ├── CommunityChestCard/
│   │       └── SkillCard/
│   ├── utils/                   # Logger, ConfigLoader/Saver, SaveLoader
│   └── views/                   # GameRenderer, Formatter
├── src/                         # Implementation files (.cpp), mirror struktur include/
├── makefile
└── README.md

Arsitektur & Desain

Lapisan utama

Lapisan	Tanggung Jawab
Core / Engine	`GameEngine`, `GameState`, `TurnManager`, `Command` — orkestrasi turn, parsing perintah, lifecycle.
Services	`EffectResolver`, `AuctionService`, `BankruptcyService`, `CommandHandler` — logika game cross-cutting.
Models	`Player`, `Board`, `Dice`, `Plot` & turunannya, `Card` & turunannya — representasi data domain.
Views	`GameRenderer`, `Formatter` — semua I/O layar (warna, layout, prompt).
Utils	`Logger`, `ConfigLoader`, `ConfigSaver`, `SaveLoader` — persistensi & utilitas.

Pola yang digunakan

Command Pattern — setiap input pemain dimapping ke subclass Command (RollDiceCommand, BuildCommand, UseSkillCardCommand, dll). CommandHandler melakukan parsing string → Command, lalu Command::execute(state, effectResolver, turnManager) dijalankan.
Strategy / Polymorphism — Plot::startEvent(PlotContext&) adalah pure virtual; setiap petak mengimplementasikan reaksinya sendiri ketika pemain mendarat.
Context Objects — PlotContext & SkillContext membungkus referensi ke pemain, papan, logger, dan service yang dibutuhkan kartu/petak — menghindari ketergantungan langsung ke GameState.
Inheritance Tree — Plot, Card, dan turunannya membentuk hierarki yang stabil dengan ekstensibilitas tinggi (tambah jenis kartu/petak baru tanpa mengubah engine).

Prinsip OOP yang ditekankan

Encapsulation — semua atribut data privat, akses via getter/setter.
Inheritance — hierarki Plot, Card, PropertyPlot, dll.
Polymorphism — startEvent, activate, getName di-override; engine bekerja melalui pointer ke base class.
Abstraction — Plot & Card adalah abstract base; engine hanya bergantung pada antarmuka.

Troubleshooting

Masalah	Solusi
`make: command not found`	Install build-essentials (Linux) / MSYS2 + MinGW (Windows).
Link error `cannot open output file bin/game.exe`	Tutup instance game yang masih jalan, lalu rebuild.
Warna ANSI muncul sebagai escape sequence aneh	Gunakan terminal yang mendukung warna (Windows Terminal, Git Bash, iTerm).
`Gagal memuat file save`	Pastikan file ada di folder `data/` dan formatnya tidak rusak.
Prompt input dadu/kartu menolak input	Input harus berupa angka tanpa karakter lain. Tekan `0` untuk batal pilihan.

Kredit

Dibuat untuk pemenuhan Tugas Besar 1 — IF2010 Pemrograman Berorientasi Objek, Institut Teknologi Bandung.

Deadliners J-1

Anggota Kelompok

No	Nama	NIM
1	Muhammad Ashkar	13524007
2	Tengku Naufal Saqib	13524012
3	Rhenaldy Cahyadi Putra	13524039
4	Fayyaz Akmal Lauda	13524076
5	Muhammad Faiz Alfada Dharma	13524097

Lihat docs/ untuk dokumentasi rancangan & spesifikasi resmi.

Name		Name	Last commit message	Last commit date
config		config
data		data
docs		docs
include		include
src		src
.gitignore		.gitignore
README.md		README.md
makefile		makefile

Uh oh!

Latest commit

History

Folders and files

Repository files navigation

Tugas Besar 1 IF2010 Pemrograman Berorientasi Objek ~ Nimonspoli — CLI Monopoly Game

Daftar Isi

Fitur Utama

Persyaratan Sistem

Instalasi & Build

1. Klona Repositori

2. Build

3. Membersihkan Build

Menjalankan Permainan

Alur Permainan

Daftar Perintah

Tampilan & Info

Giliran & Dadu

Properti

Kartu Kemampuan

Penjara

Save

Perintah Otomatis (tidak perlu diketik)

Petak (Plot) di Papan

Sistem Kartu

Skill Card (kartu kemampuan spesial)

Chance Card (Kesempatan — KSP)

Community Chest Card (Dana Umum — DNU)

Mekanika Khusus

Dadu & Double

Penjara

Monopoli & Pembangunan

Sewa

Lelang

Festival

Bangkrut & Likuidasi

Format File Konfigurasi

config/aksi.txt — Petak aksi & spesial

config/property.txt — Petak properti

config/railroad.txt — Multiplier sewa railroad

config/utility.txt — Multiplier sewa utility

config/tax.txt — Pajak

config/special.txt — Gaji & denda

config/misc.txt — Aturan umum

Save & Load

Struktur Proyek

Arsitektur & Desain

Lapisan utama

Pola yang digunakan

Prinsip OOP yang ditekankan

Troubleshooting

Kredit

Deadliners J-1

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

`config/aksi.txt` — Petak aksi & spesial

`config/property.txt` — Petak properti

`config/railroad.txt` — Multiplier sewa railroad

`config/utility.txt` — Multiplier sewa utility

`config/tax.txt` — Pajak

`config/special.txt` — Gaji & denda

`config/misc.txt` — Aturan umum