KAMPUNG SAHABAT V1.0 — PENGGERAK MALAYSIA

CARA PASANG DI CPANEL
1. Untuk percubaan, cipta folder baharu: public_html/games/kampung-sahabat/
2. Muat naik ZIP dan Extract di dalam folder itu.
3. Pastikan index.html, game.js, style.css dan folder assets berada pada aras yang sama.
4. Buka https://games.mypenggerak.com/kampung-sahabat/ jika subdomain games menggunakan public_html/games sebagai document root. Semak document root sebenar dalam cPanel jika berbeza.
5. Cuba lima misi. Fail V33 asal tidak perlu ditukar.

FAIL YANG DIPERLUKAN UNTUK BERMAIN
index.html, game.js, style.css, assets/logo.png, assets/badge.png.
Semua aset permainan dibekalkan setempat. Tiada CDN, akaun atau pangkalan data diperlukan.
Pautan rujukan rasmi di panel Rukun Negara memerlukan internet.

KAWALAN
Telefon: ketik tanah untuk berjalan; ketik nama jiran untuk mendekati dan berbual.
Butang Peta: pilih nama jiran atau lokasi untuk berjalan ke sana.
Komputer: WASD/anak panah; E untuk berinteraksi. Escape menutup panel biasa.
Santai: sasaran ditandakan dan butang Tunjuk arah.
Cabaran: petunjuk dibuka apabila diminta.

SIMPANAN
Kemajuan disimpan dengan localStorage pada pelayar/peranti yang sama.
Alamat atau pelayar lain mempunyai simpanan berasingan. Membersihkan data pelayar boleh memadamkannya.
Tidak memindahkan atau mengubah simpanan V33.
Menu > Ulang misi meminta pengesahan dan memulakan semula misi pilihan serta misi selepasnya.

KEPERLUAN
Pelayar dengan WebGL2. Cuba Chrome atau Edge jika aplikasi mesej tidak dapat memaparkan permainan.
Bukan APK; ini permainan web. Ujian peranti Android fizikal dan ujian bersama pemain sebenar masih diperlukan.

MAKLUMAT LANJUT
Buka docs/Panduan_Kampung_Sahabat.html untuk reka bentuk, NPC, misi dan laporan ujian.
Kod yang boleh disunting: source/game.js dan style.css.
Untuk membina semula: buka folder source, jalankan npm install, kemudian npm run build.
Three.js r180 dibundel di dalam game.js; lesen MIT disertakan dalam vendor/THREE-LICENSE.txt.
Logo dan lencana: aset rasmi dalam PGM_Brand_Kit_Complete, tidak dilukis semula.
Model 3D: geometri asal yang dijana oleh kod; seni bina dipermudah dan bukan replika rumah ibadat sebenar.
