CDR-007
Technical Philosophy
Document Information
Purpose
Dokumen ini mendefinisikan filosofi teknis PROJECT HUNTBLOX agar implementasi game tetap sederhana, stabil, mudah dikembangkan, dan selaras dengan kebutuhan desain.
Tujuan utama filosofi teknis adalah memastikan sistem gameplay dapat dibangun secara bertahap tanpa menciptakan kompleksitas yang tidak perlu sejak awal.
Technical Pillars
- Simple First — solusi teknis awal harus sederhana dan jelas sebelum ditingkatkan menjadi lebih kompleks.
- Performance First — setiap sistem harus mempertimbangkan batas performa Roblox, terutama server, AI, spawn, dan data persistence.
- Data-Driven Design — perbedaan hewan, senjata, biome, dan balancing sebisa mungkin diatur melalui data, bukan logika baru yang terpisah.
- Modular Systems — setiap sistem utama harus memiliki tanggung jawab yang jelas dan tidak saling bercampur.
- Safe Persistence — progres pemain harus disimpan dengan aman dan tidak mudah hilang karena disconnect atau error.
- Expandable Foundation — struktur teknis harus mendukung ekspansi tanpa memaksa rewrite besar di masa depan.
System Boundaries
Setiap sistem harus memiliki batas tanggung jawab yang jelas agar mudah dipahami dan diuji.
- World System mengatur zona, biome, spawn point, dan struktur dunia.
- Animal System mendefinisikan data hewan, rarity, habitat, dan nilai dasar.
- Animal AI System mengatur state, movement, fear response, dan behavior runtime.
- Inventory System mengatur item yang dibawa, kapasitas, dan penyimpanan aktif.
- Economy System mengatur Coin, jual-beli, harga, dan reward.
- Persistence System mengatur penyimpanan dan pemulihan data pemain.
- UI System menyampaikan informasi dan feedback kepada pemain.
Data-Driven Implementation
HUNTBLOX harus memprioritaskan sistem yang dapat dikonfigurasi melalui data.
- Hewan berbeda karena parameter: speed, fear radius, habitat, rarity, base value, dan behavior profile.
- Senjata berbeda karena parameter: range, damage, cooldown, ammo type, dan handling.
- Biome berbeda karena data spawn, visual theme, rarity distribution, dan navigation rules.
- Harga dan reward berbeda karena data ekonomi, bukan kode khusus untuk setiap kasus.
Pendekatan ini membuat balancing lebih cepat dan mengurangi kebutuhan membuat sistem baru untuk setiap variasi konten.
Server and Client Responsibility
- Server Authority — data penting seperti Coin, Inventory, loot, dan progres harus divalidasi di server.
- Client Feedback — client bertanggung jawab menyampaikan animasi, UI, sound, dan feedback visual yang responsif.
- Anti-Exploit Awareness — aksi penting tidak boleh dipercaya hanya dari client.
- Network Efficiency — komunikasi client-server harus cukup untuk gameplay, tetapi tidak berlebihan.
Persistence Philosophy
Persistence adalah fondasi kepercayaan pemain. Pemain harus merasa progres mereka aman.
- Data utama seperti Coin, Inventory, Equipment, dan koleksi harus disimpan secara konsisten.
- Auto-save harus dipertimbangkan untuk mencegah kehilangan progres akibat disconnect.
- Data harus memiliki struktur yang dapat berkembang tanpa merusak data lama.
- Kesalahan penyimpanan harus ditangani dengan aman dan tidak diam-diam menghapus progres pemain.
AI Technical Philosophy
- AI hewan harus ringan, sederhana, dan dapat diprediksi.
- State machine dasar lebih disukai daripada behavior yang terlalu kompleks untuk MVP.
- Variasi perilaku sebaiknya berasal dari parameter, bukan banyak skrip terpisah.
- AI harus mempertimbangkan jumlah hewan aktif dan beban server.
MVP Technical Scope
- Sistem Inventory sederhana dengan Backpack dan Storage dasar.
- Sistem Economy sederhana dengan Coin, Market, dan harga dasar.
- Sistem Animal dan Animal AI berbasis state sederhana.
- Sistem World dan spawn hewan berbasis biome.
- Sistem Persistence untuk progres inti pemain.
- UI dasar untuk Coin, Inventory, ammo, loot, dan feedback transaksi.
Technical Risks
- AI terlalu banyak atau terlalu kompleks dapat membebani server.
- Data persistence yang buruk dapat merusak kepercayaan pemain.
- UI yang tidak jelas dapat membuat sistem sederhana terasa membingungkan.
- Ekonomi dan Inventory yang terlalu banyak aturan dapat memperlambat implementasi MVP.
- Menambahkan fitur tanpa batas sistem yang jelas dapat menyebabkan sistem saling bergantung terlalu kuat.
Dependencies
- CDR-001 — Game Vision.
- CDR-002 — Gameplay Philosophy.
- CDR-003 — Player Experience.
- CDR-004 — Progression Philosophy.
- CDR-005 — Economy Philosophy.
- CDR-006 — World Philosophy.
- GDD-003 — Inventory System.
- GDD-004 — Equipment System.
- GDD-005 — Animal System.
- GDD-006 — Economy System.
- GDD-007 — Animal AI System.
- GDD-008 — World System.
- game-systems.html — Game Systems Overview.