Technical Design Documents

Document Information

Version

1.1.0

Status

Approved

Priority

★★★★★ (Critical)

Last Updated

Agustus 2026

Purpose

Dokumen ini menetapkan peristiwa apa yang dicatat, bentuk datanya, ke mana ia ditulis, dan angka apa yang diturunkan darinya.

Kenapa ia kritis, bukan pelengkap. Sejumlah keputusan besar sengaja ditunda ke playtest — terutama Skala Dunia (S), yang menyentuh Fear Radius, jangkauan senjata, Jarak Baca, dan seluruh kecepatan sekaligus (GDD-007). Playtest tanpa instrumentasi pulang membawa kesan, dan kesan tidak dapat menyelesaikan perdebatan skala. RBB-002 mengunci konsekuensinya: telemetri ditulis bersamaan dengan sistemnya, tidak pernah ditempel belakangan.

Sumber turunan: Rencana Bangun Bertahap Fase 0 · GDD-007 Skala Dunia · TDD-001 arsitektur modul.

Ke Mana Data Ditulis

Syarat teknis: Allow HTTP Requests wajib aktif di pengaturan game, dan HttpService hanya berjalan di tempat yang sudah dipublikasikan — bukan di Studio tanpa izin. Ini perlu disiapkan sebelum playtest, bukan pada hari playtest.

Jalur pindahnya sudah aman. Bentuk peristiwa di bawah tidak mengandaikan penerimanya apa pun. Mengganti Spreadsheet dengan basis data sungguhan kelak berarti mengubah satu URL, bukan menulis ulang instrumentasinya.

Batching

• Peristiwa disangga per pemain di server, tidak pernah dikirim satu per satu — HewanTerlihat saja bisa menyala puluhan kali per sesi.
• Disiram (flush) saat sesi berakhir, tiap 60 detik, atau saat sangga mencapai 50 peristiwa — mana yang lebih dulu. Siraman berkala mencegah satu crash menghapus seluruh sesi.
• Kegagalan pengiriman tidak pernah mengganggu permainan. Bungkus dalam pcall; bila gagal, buang sangganya dan lanjut. Telemetri yang bisa menjatuhkan sesi lebih merugikan daripada telemetri yang hilang.
• Seluruhnya berjalan di server. Client tidak pernah mengirim telemetri — ia dapat dipalsukan, dan angka palsu lebih buruk daripada tidak ada angka (CDR-007).

Amplop — Field yang Selalu Ada

Field S adalah yang paling mudah dilupakan dan paling mahal bila hilang. Seluruh tujuan playtest ini adalah mencoba beberapa nilai S. Tanpa mencatatnya di tiap peristiwa, data sebelum dan sesudah perubahan tercampur menjadi satu kolam — dan pertanyaan yang ingin dijawab justru menjadi tidak terjawab oleh datanya sendiri.

Privasi. UserId mentah tidak pernah dikirim keluar. playerHash memberi kesinambungan antar sesi tanpa memindahkan identitas Roblox ke layanan luar. Isi Chat Clan, nama clan, dan seluruh teks buatan pemain tidak pernah masuk telemetri — tidak ada peristiwa yang membawa teks bebas.

Empat Peristiwa Fase 0

Inilah yang dibangun bersamaan dengan sistem berburu pertama, dan yang menjawab pertanyaan Skala Dunia.

HewanTerlihat

Definisi “terlihat” harus dikunci, dan ini bukan soal remeh. Bila peristiwa ini menyala tiap kali hewan masuk bidang pandang kamera, seorang pemain yang berputar di tempat akan mencatat puluhan penglihatan dan median waktu pendekatan menjadi omong kosong. Aturannya:

• Menyala sekali per animalId per sesi — penglihatan berikutnya atas hewan yang sama diabaikan.
• Syaratnya garis pandang tidak terhalang dan jarak di dalam Jarak Baca Varian yang disewa (15 tanpa teropong, MDD-003).
• Diperiksa di server dengan laju rendah (mis. 4× per detik), bukan tiap frame.

TembakanDilepas

HewanKabur

SesiSelesai

Dikirim pada PlayerRemoving dan BindToClose. Tanpa keduanya, sesi yang berakhir karena server ditutup akan hilang seluruhnya — dan sesi terpanjang justru yang paling sering berakhir begitu.

Angka yang Diturunkan

Peristiwa mentah tidak berguna sampai diketahui apa yang dihitung darinya. Kelimanya dihitung dari empat peristiwa di atas, tanpa tambahan.

Hanya penglihatan yang berpasangan yang masuk median. Hewan yang dilihat lalu tidak pernah ditembak tidak punya waktu pendekatan — memasukkannya sebagai nol atau sebagai durasi sesi sama-sama merusak angkanya. Ia dihitung terpisah, sebagai baris kedua di tabel ini.

Tidak ada sampling. Pada skala playtest tertutup (puluhan pemain), seluruh peristiwa dicatat. Sampling baru menjadi pertimbangan bila jumlah pemain harian menembus ribuan — dan bila hari itu tiba, yang disampel adalah HewanTerlihat, satu-satunya yang volumenya tumbuh cepat.

Peristiwa Fase Berikutnya

Sengaja belum dibuatkan skema. Bentuknya ditetapkan saat sistemnya dibangun, mengikuti RBB-002 — menulis skema untuk sistem yang belum ada berarti menebak field yang akan berubah sebelum dipakai.

TutorialLangkah adalah yang paling menentukan di antara semuanya. Seluruh rancangan FTUE menit 0–30 berdiri di atas asumsi bahwa pemain menyelesaikan tiap langkah. Satu peristiwa per langkah mengubah asumsi itu menjadi corong yang dapat dilihat — dan titik bocornya biasanya bukan di tempat yang diduga.

Aturan

Dependencies

• Rencana Bangun Bertahap — Fase 0, dan aturan RBB-002.
• GDD-007 — Skala Dunia, Aturan Penumpukan Deteksi.
• MDD-002 — Peluang Tangkap, jangkauan dan Handling senjata.
• TDD-001 — penempatan modul (ServerScriptService/Services/TelemetryService).
• CDR-007 — otoritas server.