PHDS-03
Project Folder Structure Standard
Document Metadata
PURPOSE
Dokumen ini mendefinisikan struktur folder resmi PROJECT HUNTBLOX.
Seluruh dokumentasi, aset, dan source code proyek wajib mengikuti struktur yang ditetapkan pada dokumen ini.
ROOT STRUCTURE
- HUNTBLOX/
- ├── docs/ — situs dokumentasi statis (dibaca lewat browser)
- └── src/ — source code Roblox Studio, disinkronkan lewat Rojo
Dua kategori ini cukup untuk kebutuhan proyek saat ini: docs/ menampung seluruh dokumen desain/data/teknis, src/ menampung seluruh script game. Kategori baru (mis. folder audio/art mentah, terpisah dari referensi visual di docs/images/) baru ditambahkan saat benar-benar ada konten nyata untuk diisi — lihat RULES.
DOCS
Folder ini berisi seluruh dokumen desain, data, dan teknis, ditambah halaman/aset situsnya sendiri.
- cdr/ — Core Design Rules
- gdd/ — Game Design Documents
- dn/ — Design Notes
- mdd/ — Master Data Documents
- gds/ — Game Design Spreadsheet (data tabular)
- tdd/ — Technical Design Documents
- phds/ — Project HuntBlox Documentation Standard (dokumen ini)
- roadmap/ — Roadmap & Review Log
- images/ — aset visual referensi (concept art, mockup, ikon dokumentasi)
- game-flow.html, game-systems.html, index.html, daftar-isi.html, master-index.html, dsb. — halaman situs tingkat atas
- style.css, theme-toggle.js, nav-pagination.js, gallery.php — aset bersama situs
SRC
Folder ini berisi seluruh script Roblox, disusun 1:1 mengikuti Explorer structure di TDD-001 supaya sinkron Rojo antara VSCode dan Studio tidak butuh terjemahan mental.
- ServerScriptService/Services/ — satu ModuleScript per sistem server, plus Boot.server.lua
- ServerStorage/GameData/ — ModuleScript data hasil transkrip MDD
- ReplicatedStorage/Shared/ — konstanta & fungsi murni yang dibaca client dan server; folder Remotes/ dideklarasikan lewat
default.project.json, isinya (RemoteEvent) dibuat runtime oleh Boot.server.lua - StarterPlayer/StarterPlayerScripts/Controllers/ — satu Controller per sistem yang butuh logika client
- StarterGui/Screens/ — UI per layar
Detail lengkap per-sistem (nama Service, Controller, dependency) ada di TDD-001 Module Map — dokumen ini tidak menduplikasi daftarnya supaya tidak ada dua sumber kebenaran.
RULES
Folder tingkat atas (docs/, src/) tidak boleh diubah tanpa persetujuan Producer.
Dokumen dan script wajib ditempatkan pada kategori yang sesuai.
Tidak diperbolehkan membuat folder baru apabila kategori yang ada masih dapat digunakan.
REVISION NOTE
Versi 1.0.0 mendefinisikan struktur 8-kategori (00_CORE s.d. 07_RELEASE) yang tidak pernah benar-benar diimplementasikan di filesystem — proyek berjalan dengan struktur flat di root. Versi 2.0.0 menggantikannya dengan struktur docs/ + src/ yang benar-benar diterapkan (Juli 2026), selaras konvensi Rojo dan Explorer structure TDD-001, tanpa kategori kosong yang belum ada isinya.
APPROVAL
- Lead Game Designer
- ☑ Approved
- Producer
- ☑ Approved