Design Notes

Document Information

Version

3.16.0

Status

Approved (Struktur)

Last Updated

August 2026

Summary

Companion adalah hewan karnivora milik pemain yang dikirim berpatroli untuk menangkap hewan secara otomatis, bahkan saat pemain sedang tidak bermain. Hasil patroli masuk ke inventory permanen, bukan ke Backpack sewaan sesi Map — dua tempat penyimpanan yang terpisah tegas (GDD-003).

Companion adalah bonus, bukan pengganti berburu aktif. Seluruh angkanya dikalibrasi agar hasil bersih per sesi patroli berada jauh di bawah hasil berburu aktif dalam waktu setara.

Companion vs Mount

Dua sistem berbeda yang sebelumnya tercampur. Pemisahnya adalah jenis hewan:

Keduanya memakai dua jalur perolehan yang sama: beli siap pakai, atau evolusi dari hewan tangkapan.

Acquisition

• Beli siap pakai — Companion eksklusif yang tidak ada di Map sama sekali, dijual di Market (Lobby). Level-nya tertera langsung pada produk. Ini jalur monetisasi utama Companion.
• Evolusi — dari Animal Record spesies karnivora yang sudah ditangkap pemain, ditambah Catalyst dan waktu proses. Resep mengikuti pola yang sama dengan evolusi Mount (DN-005).
• Starter gratis — setiap pemain baru menerima satu Companion di akhir tutorial. Lihat Starter Companion di bawah.

Eligible Species (Jalur Evolusi)

Kelayakan dibaca langsung dari kolom Type di MDD-001 — tidak ada klasifikasi baru yang perlu dibuat. Spesies bertanda Predator, Canine, atau tipe pemangsa lain masuk jalur Companion; sisanya masuk jalur Mount.

Daftar final: Skyron (MVP), lalu Vulpyra, Cavalier, Ursakor, Crovak, dan Jagoryx. Varadon dan Sabertooth dikecualikan karena Beast Signal Only, konsisten dengan pengecualian yang sama di jalur Mount.

Leorak tetap dikecualikan meski sudah kembali ke passive spawn (Agustus 2026) — tetapi alasannya berganti, dan itu perlu ditulis supaya tidak terbaca sebagai sisa aturan lama. Dulu ia dikecualikan karena Beast Signal Only; sekarang karena ECO-011. Patroli Companion adalah faucet non-berburu, dan Base Price Leorak 7.710 menjadikannya hewan passive paling berharga di game. Memasukkannya ke hasil patroli berarti pemain memanen hewan termahal tanpa berburu sama sekali — persis yang dijaga ECO-011 pada ±18% penghasilan berburu.

Size — Satu-satunya Angka Companion

Companion dijelaskan oleh dua angka saja: Size (apa yang bisa ditangkap dan berapa kapasitasnya) dan jumlah Chum (berapa biaya menjalankannya). Keduanya tidak saling menurunkan.

Companion tidak punya sistem EXP atau leveling sendiri. Kedua angka ditetapkan sekali saat diperoleh dan tidak pernah berubah.

Memakai Size Value spesies yang sudah ada menghindari sistem angka baru sepenuhnya — dan kesulitan mendapatkan Companion kuat tetap terkendali oleh kelangkaan spesies asalnya (Spawn Weight, MDD-004).

Aturan Penangkapan

• Companion hanya dapat menangkap hewan dengan Size Value < Size Companion — predator menangkap mangsa yang lebih kecil dari dirinya. Ini mengikuti logika dunia nyata yang sama seperti ide awal sistem ini: anjing memangsa ayam dan kelinci, jadi di game pun begitu.
• Hewan ber-Size sama atau lebih besar dari Companion tidak akan pernah muncul di hasil patroli.
• Hewan Beast Signal Only (Sabertooth, Varadon, Mammorak, Phoenyx) tidak akan pernah muncul di hasil patroli, apa pun Size Companion-nya — keempatnya eksklusif event dunia (DN-004).
• Leorak juga tidak pernah muncul di hasil patroli, meski ia spesies passive spawn biasa sejak Agustus 2026 — dikecualikan lewat ECO-011, bukan lewat DN-004. Ia satu-satunya pengecualian yang beralasan ekonomi, bukan alasan event.
• Hasil patroli mengikuti tabel spawn biome yang sudah ada (MDD-004), disaring oleh batas Size di atas. Tidak ada tabel drop terpisah untuk Companion.

Biome Spesialisasi

• Setiap Companion punya satu biome spesialisasi dan hanya dapat dikirim berpatroli ke biome tersebut.
• Biome spesialisasi Companion hasil evolusi mengikuti Habitat spesies asalnya (MDD-001) — Skyron berpatroli di Gunung Es, Jagoryx di Mistik.
• Ini menjadikan Companion collection driver: pemain butuh beberapa Companion berbeda untuk menjangkau semua biome, bukan satu Companion serba bisa.

Kapasitas

• Setiap Companion punya kapasitas slot hasil — jumlah maksimal kotak hasil dalam satu sesi patroli.
• Kapasitas Slot = Size × 3 (dikunci Fase F-5). Beagle Size 2 → 6 slot, persis angka yang dikunci pemilik proyek; Skyron Size 4 → 12; Jagoryx Size 6 → 18.
• Kapasitas mengikuti Size, bukan Level — sejalan dengan aturan penangkapan yang juga sudah dipindah ke Size. Predator yang lebih besar membawa lebih banyak; Level tetap mengurus hal yang berbeda, yaitu tier fuel.
• Starter Companion (Beagle, Size 2) memiliki 6 slot — angka acuan yang dikunci pemilik proyek.

Chum — Biaya Patroli

Patroli membutuhkan Chum, item sekali pakai seharga 50 Coin. Hanya ada satu jenis; yang berbeda adalah berapa banyak yang dihabiskan tiap Companion per patroli.

• 1 unit fuel = 1 sesi patroli dengan durasi tetap. Durasi tidak bertambah dengan menumpuk fuel — ini rate baseline permanen, bukan nilai tutorial.
• Jumlah Chum ditetapkan per Companion (1 sampai 9), bukan diturunkan dari angka lain. Durasi sesi juga melekat pada Companion, bukan pada Chum.
• Tidak ada tier, tidak ada syarat kelayakan — Companion mana pun memakai Chum yang sama, hanya berbeda jumlahnya.

Kebutuhan Chum per Companion

Harga adalah tuas global; jumlah adalah tuas lokal. Di bawah sistem tier, memperbaiki satu Companion yang rasionya meleset menuntut mengubah harga tier-nya — dan itu ikut menggeser setiap Companion lain di tier yang sama. Dengan jumlah, satu Companion dapat disetel sendirian. Untuk angka yang akan berkali-kali dikoreksi saat playtest, itulah bentuk tuas yang benar.

† Hasil kotor memakai tingkat isi ±73% — tidak semua slot matang tiap patroli (lihat Siklus Patroli). Jumlah Chum mengikuti aturan fuel ≈ 9,5% hasil kotor, lalu diperiksa terhadap ECO-013.

‡ Terhadap Varian Dasar rasionya ±53%, terhadap Varian Perintis ±19%, rata-rata ±35% — di dalam pita. Pemicu playtest: bila pemain bertahan lama di Varian Dasar, kebutuhan Chum keduanya dinaikkan dari 1 ke 3–4.

Level Companion dihapus. Sejak tier fuel tidak ada, Level tidak punya pekerjaan tersisa — ia dulu hanya penanda tier mana yang dipakai. Companion kini cukup dijelaskan dua angka: Size (apa yang bisa ditangkap, berapa kapasitasnya) dan jumlah Chum (berapa biayanya).

Catatan penamaan: "Chum" adalah istilah dunia berburu untuk umpan daging/darah pemancing predator — menggantikan sebutan sementara "Madu"/"Ramuan" dari diskusi awal. Nama ini juga menegaskan Companion adalah karnivora.

Siklus Patroli

1. Pilih Companion yang akan dipakai.
2. START — pemain membayar sejumlah Chum sesuai kebutuhan Companion tersebut. Sesi patroli dimulai dengan durasi tetap.
3. Server men-generate seluruh hasil sesi seketika saat Start ditekan (bukan bertahap real-time). Dari total slot kapasitas, sistem me-roll secara acak berapa banyak slot yang matang dalam sesi itu (tidak selalu penuh) dan isi tiap slot yang matang — diambil dari tabel spawn biome spesialisasi, disaring batas Rarity.
4. UI menampilkan status patroli dan timer berjalan.
5. STOP — dapat ditekan kapan saja sebelum sesi selesai:
   • Slot yang sudah matang (berdasarkan timestamp internal) otomatis terbuka dan isinya terlihat.
   • Slot yang belum matang hangus total — tidak disimpan, tidak bisa dilanjutkan. Keputusan sengaja untuk menyederhanakan backend.
6. COLLECT — hasil masuk ke inventory permanen pemain.
7. Hasil patroli menambah progres Collection Book (dikunci Juli 2026) — count per spesies bertambah sama seperti tangkapan pemain sendiri, sehingga progres Statue Miniatur ikut maju (MDD-007). Tetapi Companion tidak dapat menyelesaikan koleksi. Ia hanya menangkap mangsa ber-Size lebih kecil dari dirinya, di satu biome spesialisasi, dan tidak pernah menyentuh spesies Beast Signal — sehingga sebagian besar Collection Book tetap hanya bisa diisi dengan berburu sendiri.

Karena 1 fuel = 1 sesi berdurasi tetap (bukan durasi terbuka yang bisa ditumpuk berjam-jam), tidak diperlukan cap durasi terpisah — durasi sudah otomatis terbatas oleh desain fuel itu sendiri.

Keamanan Data (Prioritas Teknis Tinggi)

• Data mentah tidak boleh dikirim ke client sebelum waktunya. Server hanya mengirim informasi slot yang sudah matang setiap kali dicek atau di-STOP. Sisanya tetap di server.
• Random generator di-seed dengan baik (kombinasi Player ID + waktu Start) agar hasil tidak predictable dan tidak bertabrakan antar pemain.
• Remote Collect tidak boleh menerima payload isi hasil dari client. Server hanya membaca hasil yang ia generate sendiri dan sudah melewati timestamp matang — client hanya boleh mengirim niat ("collect"), bukan data.
• Penulisan ke inventory permanen lewat fungsi server yang sama dengan jalur ekstraksi Map (GDD-003 Session Boundary), supaya validasi dan logging tidak berbeda antar jalur.

Starter Companion & First Patrol

Pemain baru menerima Companion gratis di akhir tutorial (momen "graduation"), supaya merasakan offline progress sejak hari pertama.

• Companion default — BEAGLE, jenis Anjing (karnivora), Size 2, 6 slot kapasitas.
• Dua Chum diberikan gratis sebagai bagian reward pemain baru — sehingga First Patrol pure profit, tanpa pengurangan biaya sama sekali, dan patroli kedua tetap mungkin di hari pertama.
• Kenapa dua, bukan satu (baru Agustus 2026). Dengan satu Chum, Companion berhenti tepat saat pemain baru saja membelanjakan seluruh Coin-nya untuk Tawaran Pemula: ia memegang ±60 Coin dan Chum berharga 50. Patroli kedua secara teknis mungkin, tetapi dengan margin 10 Coin — dan bila ia memilih paket 2.000 atau 2.500, marginnya hilang sama sekali. Chum kedua mengubah patroli kedua dari nyaris-mustahil menjadi pasti, lalu Chum ketiga-lah yang menjadi pembelian Market pertamanya — keputusan belanja yang diambil setelah ia melihat sendiri apa yang dikembalikan patroli, bukan sebelum.
• First Patrol memberi 1 Crystal di luar hasil buruannya (baru Juli 2026). Ini Crystal ketiga dari tiga yang diterima pemain baru — dua lainnya dari bekal awal dan Caravan tutorial. Ketiganya menjadi syarat Tawaran Pemula (GDD-002).
• Hasil First Patrol tidak memakai RNG normal, melainkan hasil fixed/hardcode yang sama untuk semua pemain baru: dari 6 slot, 1 slot sengaja dikosongkan, 5 slot terisi campuran Renggo (Ayam) dan Rapyra (Kelinci).
• Durasi First Patrol sama dengan rate normal Tier 1 (15 menit) — hanya hasilnya yang merupakan pengecualian, bukan waktunya.
• Mulai fuel kedua dan seterusnya (dibeli sendiri), berlaku algoritma RNG normal.

First Patrol Bonus tidak boleh dipakai sebagai basis kalkulasi neraca ekonomi Companion — rasio profitnya lebih tinggi dari rate normal.

Isinya dikunci: 3 Renggo + 2 Rapyra, dengan 1 slot dari 6 sengaja dibiarkan kosong. Perbandingannya sengaja mencerminkan tangkapan pemain sendiri di Arena Pembuka (2 Renggo + 1 Rapyra, GDD-002) — Renggo lebih banyak daripada Rapyra, dengan pola yang sama. Hasilnya terbaca sebagai "Beagle berburu hal yang sama seperti saya", bukan sebagai angka acak yang kebetulan muncul.

Tidak sama dengan tangkapan Arena Pembuka (2 Renggo + 1 Rapyra, ditangkap pemain sendiri). Yang dibahas di sini adalah hasil patroli Beagle, kejadian terpisah yang terjadi setelahnya.

Pratinjau Sebelum Patroli Dimulai

Layar konfirmasi START menampilkan apa yang akan didapat sebelum pemain menekannya — mengikuti pola yang sama dengan konfirmasi pengiriman Caravan (DN-011):

• Durasi patroli
• Jumlah Chum yang akan dihabiskan
• Bonus Crystal, bila ada — pada First Patrol, "+1 Crystal"

Ini mengubah menunggu menjadi menanti. Pemain yang tahu 1 Crystal sedang berjalan menuju dirinya punya alasan untuk kembali; pemain yang tidak diberi tahu hanya menerima kejutan yang tidak pernah ia antisipasi. Perbedaannya kecil di kode, besar di rasa.

Nyaris tanpa ongkos UI. Patroli sudah wajib menampilkan penghitung waktu — pemain harus tahu kapan kembali. Ikon Crystal cukup ditempelkan pada penghitung yang sudah ada, sehingga hadiahnya terlihat sedang berjalan selama 15 menit itu, bukan muncul tiba-tiba di akhir.

Teks Companion yang menjelaskan "berburu walau pemain offline" adalah tempat yang tepat untuk menyebutkan bonus ini, bukan panel terpisah.

Jumlah Companion & Batas Patroli

• Default 1 Companion per pemain di awal.
• Tidak ada batasan slot jumlah Companion yang dapat dijalankan bersamaan — ini bukan sistem "beli slot tambahan".
• Satu Companion hanya boleh menjalankan SATU patroli aktif pada satu waktu. Patroli berikutnya baru bisa dimulai setelah yang berjalan selesai atau di-STOP.
• Pengendali jumlah murni biaya dan waktu untuk mendapatkan Companion baru (evolusi butuh Animal Record + Catalyst + waktu proses, atau beli di Market).
• Target pacing: mendapatkan Companion kedua membutuhkan lebih dari satu hari bermain aktif.

Throughput maksimum per Companion terkunci di ±1.900 Coin/jam, karena satu Companion hanya boleh menjalankan satu patroli aktif.

Spesies Karnivora yang Layak Jadi Companion

Disetujui (Juli 2026): Vulpyra, Cavalier, Ursakor, dan Crovak menyusul Skyron dan Jagoryx sebagai spesies yang dapat dievolusikan menjadi Companion. Tetapi menghitungnya memunculkan cacat struktural yang perlu diputuskan lebih dulu.

Angka pada tabel di bawah sudah tidak berlaku (ia merekam keadaan saat tier fuel masih ada). Angka yang berlaku ada di Kebutuhan Chum per Companion; yang tetap berlaku dari tabel ini hanya daftar spesies dan alasan strukturalnya.

Tier Fuel Ditetapkan, Bukan Diturunkan dari Rarity

Akarnya: Rarity menaikkan biaya, Size menaikkan pemasukan. Selama keduanya searah, aturannya bekerja. Begitu berjauhan — Rarity tinggi dengan Size kecil — hasilnya runtuh. Ini bukan kasus khusus Vulpyra; ia berlaku untuk setiap spesies dengan bentuk yang sama.

Perbaikannya: tier fuel menjadi data yang ditetapkan per Companion, bukan hasil rumus. Acuan awalnya Size — karena Size-lah yang menentukan kapasitas, dan kapasitas yang menentukan hasil — lalu diperiksa terhadap ECO-013 dan boleh digeser satu tingkat untuk biome yang mangsanya luar biasa kaya atau miskin.

Vulpyra kini masuk akal sebagai pilihan, bukan jebakan. Dengan Tier 1 ia menghasilkan bersih 470 — praktis setara Beagle. Dan gunanya jelas: ia satu-satunya cara memiliki Companion Brightmeadow kedua, karena Beagle hanya diberikan sekali di akhir tutorial. Pemain yang mengevolusikannya mendapat patroli Brightmeadow paralel, dan itu keputusan strategi yang sah — bukan pilihan yang mustahil dibenarkan.

Resep Evolusi Companion

Dikunci (Juli 2026) — memakai resep yang sama persis dengan evolusi Mount (DN-005), tanpa aturan baru:

10 Animal Record + 10 Bonding Potion + ceil(Rarity ÷ 3) Crystal

"Total Coin" menghitung Animal Record sebagai Coin yang direlakan — sepuluh ekor yang tidak jadi dijual — ditambah harga Bonding Potion (2.500 × 10). Crystal dihitung terpisah karena tidak punya kurs Coin.

Satu resep menghasilkan biaya yang berbeda-beda, dan itu memang tujuannya. Tidak ada aturan tambahan yang membedakan Companion mahal dari yang murah — perbedaannya muncul sendiri karena karnivora ber-Rarity tinggi memang lebih berharga dan lebih langka. Crovak menuntut 91.100 Coin sementara Skyron cukup 32.800, tanpa satu pun angka yang ditetapkan khusus. Ini penerapan DN-008 yang paling bersih: aturannya satu, hasilnya bertingkat sendiri.

Efek sampingnya juga tepat: evolusi Companion otomatis lebih mahal daripada evolusi Mount dengan resep yang identik, karena spesies herbivora sumber Mount lebih umum dan lebih murah. Companion menghasilkan Coin, Mount murni kosmetik — wajar yang menghasilkan lebih mahal, dan itu terjadi tanpa perlu diatur.

‡ Vulpyra balik modal lambat karena hasil patrolinya kecil (470/patroli, Size 2), tetapi durasinya juga tersingkat (15 menit) — 78 patroli setara ±20 hari pada laju bermain normal. Nilainya bukan ekonomi, melainkan menjadi Companion Brightmeadow kedua, karena Beagle hanya diberikan sekali.

Kontrol Ekonomi

• Aturan utama: hasil bersih Companion per sesi wajib berada di kisaran 30–40% dari hasil berburu aktif pemain dalam waktu setara. Companion adalah bonus, bukan pengganti.
• Dikalibrasi ulang Juli 2026 setelah kurva harga baru. Chum diturunkan dari ±300 ke 50 Coin. Alasannya: Beagle hanya menjangkau Renggo dan Rapyra — dua hewan yang harganya justru turun di kurva baru (150→100 dan 210→140) — sementara hewan yang diburu pemain secara aktif naik tajam. Pada harga lama rasionya anjlok ke 14%. Pada 50 Coin, rasionya kembali 34%, di dalam target.
• Untuk setiap fuel tier yang lebih tinggi, rasio yang sama wajib divalidasi ulang saat tier tersebut dikembangkan.
• Companion menambah faucet baru ke ekonomi global — wajib masuk perhitungan neraca faucet-sink menyeluruh di Fase F.

Monetisasi

• Companion eksklusif di Market — jalur monetisasi utama. Tidak tersedia di Map dengan cara apa pun.
• "Instant Collect" dengan Robux ditunda, tidak untuk MVP. Akan didiskusikan ulang setelah algoritma dasar dan neraca ekonomi terbukti seimbang.
• Fuel dibeli dengan Coin, bukan Robux — menjaga loop harian Companion tetap sepenuhnya F2P.

Halaman Companion (Lobby)

Halaman terpisah dari Stable (kelola Mount dan evolusi Mount) — pemisahan ini disengaja untuk mengakhiri percampuran istilah pada versi sebelumnya. Lihat GDD-014 Lobby System.

• Daftar Companion yang dimiliki, beserta Level, biome spesialisasi, dan kapasitas masing-masing.
• Pemilihan Companion yang dipajang — satu Companion berdiri di samping karakter di scene Lobby, berdampingan dengan satu Mount (GDD-014). Companion yang sedang berpatroli tidak terlihat, karena ia memang sedang di luar — sekaligus pengingat visual gratis bahwa patroli berjalan.
• Status patroli tiap Companion: idle / sedang patroli (dengan timer) / siap di-collect.
• Notifikasi & badge saat patroli selesai — notifikasi muncul di Lobby, disertai badge persisten pada ikon halaman Companion yang tidak hilang sampai hasilnya diklaim. Tanpa badge, hasil patroli mudah terlupakan dan seluruh nilai offline progress ikut hilang. Bila pemain punya banyak Companion, badge menampilkan jumlah yang siap diklaim (lihat GDD-011).
• Tombol START (memilih fuel), STOP, dan COLLECT.
• Panel evolusi: spesies karnivora eligible, status requirement, dan tombol evolusi.
• Pembelian fuel dengan Coin.

Open Item

• Companion beli untuk Pantai, Gua, dan Mistik — tidak untuk MVP (Juli 2026). Dua Companion beli yang ada (Lynx — Hutan, Ospra — Sungai) sudah cukup, dan ketiga biome itu sendiri berstatus Post-MVP.

Dependencies

• DN-005 — Mount System (sistem sejajar, jalur evolusi Mount).
• DN-004 — Beast Signal (pengecualian spesies).
• GDD-003 — Inventory System (inventory permanen vs Backpack sesi).
• GDD-006 — Economy System (Companion sebagai faucet baru).
• GDD-012 — Persistence System (state patroli).
• GDD-014 — Lobby System (halaman Companion & Stable).
• MDD-001 — Animal List (Type, Rarity, Habitat).
• MDD-003 — Item Master Data (fuel, Catalyst, katalog Companion).
• MDD-004 — Biome & Spawn Data (tabel spawn hasil patroli).
• MDD-007 — Loot & Collection Data.