
PROTOTAIP PERMAINAN WEB · V1.0Kampung Sahabat
Kenali Jiran, Bantu Komuniti, Hayati Rukun Negara.
Lima misi • Enam jiran • Satu kampung 3D
1. Apa yang dibina
Permainan daratan dengan model 3D sebenar yang dibina daripada geometri ringkas. Pemain berjalan, berbual, menghantar buku, menyediakan taman, menyepakati jadual dan meraikan Hari Sahabat. Tiada lautan, kapal, pertempuran atau jelajah negeri.
Kampung mengandungi enam rumah, balai raya, dataran, kedai runcit, taman, masjid, kuil Hindu, tokong dan gereja. Semua interaksi berlangsung di luar bangunan. Reka bentuk rumah ibadat dipermudah; bukan replika bangunan sebenar.
Identiti rasmi PGM digunakan. Logo dan lencana diambil daripada PGM_Brand_Kit_Complete dalam folder Penggerak Malaysia. Warna antara muka mengikut manual: Navy #1B1B5B, Gold #DDB832, Red #E01F25, Sky Blue #6591C6 dan White. Warna kampung menggunakan tona alam untuk keterbacaan dan suasana mesra.
2. Cara memasang di cPanel
- Cipta folder percubaan baharu, contohnya public_html/games/kampung-sahabat/.
- Muat naik Kampung_Sahabat_V1_cPanel.zip dan pilih Extract.
- Pastikan index.html, game.js, style.css dan folder assets berada terus di dalam folder tersebut.
- Jika document root games.mypenggerak.com ialah public_html/games, buka https://games.mypenggerak.com/kampung-sahabat/. Sesuaikan dengan document root sebenar.
- Uji dahulu sebelum menggantikan halaman utama. Fail V33 tidak diubah oleh pakej ini.
Untuk fail tunggal, muat naik Kampung_Sahabat_V1.html ke folder pilihan dan buka alamat fail itu. Semua skrip, gaya dan imej disertakan dalam fail tersebut. Jika mahu menjadikannya halaman utama folder baharu, namakan salinannya index.html.
Pakej telah disediakan; belum dimuat naik atau diterbitkan ke domain pengguna. Fail tunggal memerlukan pelayar dengan WebGL2. Paparan pratinjau dalam aplikasi mesej mungkin tidak menjalankannya.
3. Cara bermain
- Santai: sasaran jelas, bantuan arah dan dialog mudah.
- Cabaran: tanda sasaran dikurangkan; petunjuk diberi apabila diminta. Mekanik misi sama; bukan kempen baharu.
- Ketik tanah untuk berjalan. Ketik nama NPC atau lokasi untuk berjalan mendekati dan berinteraksi.
- Buka Peta jika lokasi tidak kelihatan. Pilih nama; watak mencari laluan.
- Komputer: WASD / anak panah. E untuk interaksi berhampiran.
- Menu menghentikan permainan. Pilihan kurang animasi dan bunyi boleh ditukar.
- Pergerakan berhenti apabila dialog dibuka. Tiada pemasa atau hukuman mata.
Satu penunjuk kemajuan: 0/5 hingga 5/5. Tamat lima misi untuk pengiktirafan dalam permainan “Sahabat Kampung”, bukan sijil profesional.
4. Susun atur kampung
Masjid
Kuil Hindu
Tokong
Gereja
Laluan belakang · akses ke rumah ibadat
Rumah Bunga
Aina
Rumah Basikal
Mei Lin
Rumah Raket
Kumar
Rumah Muzik
Joseph
Balai raya · laluan tengah · tempat berbincang
Rumah Buku
Lina
Kedai runcit
Taman Sahabat
Rumah Cerita
Sofia
Dataran · Hari Sahabat · pintu masuk kampung
Rajah ini ialah panduan hubungan lokasi; peta 3D dalam permainan menunjukkan kedudukan tepat. Kamera mengikut pemain dan boleh ditukar kepada pandangan seluruh kampung.
5. Enam jiran
| Watak fiksyen | Latar komuniti | Peranan, minat & keperluan |
|---|
| Aina · 34 | Melayu | Guru, gemar berkebun. Menggalakkan jiran saling membantu. Memerlukan hidangan halal. |
| Mei Lin · 32 | Cina | Juruteknik basikal yang suka melukis dan mengumpulkan buku. |
| Kumar · 40 | India | Jururawat dan peminat badminton. Perlu menyelaraskan masa sukan dengan aktiviti lain. |
| Lina · 25 | Kadazan-Dusun, Sabah | Pelukis ilustrasi, penjaga sudut bacaan. Mempunyai alahan kacang. |
| Joseph · 55 | Iban, Sarawak | Tukang kayu dan pemain gitar. Membantu kelas membaca. |
| Sofia · 62 | Serani Portugis, Melaka | Pencerita dan peminat fotografi yang menggunakan kerusi roda. Memerlukan laluan rata dan lapang. |
Peranan, keperluan dan personaliti ialah ciri individu fiksyen. Tiada padanan automatik antara kaum, agama atau pekerjaan. Watak-watak ini tidak mewakili keseluruhan kepelbagaian Malaysia.
6. Lima misi & R5
| Misi | Perbuatan pemain | R5 & hasil pembelajaran |
|---|
| 1 · Jom kenal jiran | Temui Aina, Mei Lin dan Kumar. Tanya keperluan/minat mereka. | KENAL jiran, FAHAM cerita, FIKIR apa yang penting, PILIH soalan dan AMAL mendengar. Lencana Sahabat Baharu. |
| 2 · Kiriman untuk jiran | Semak label buku, ambil bakul daripada Mei Lin dan hantar kepada Lina. | FAHAM penerima, FIKIR berdasarkan petunjuk, PILIH jiran yang betul, AMAL amanah. Buku kelihatan dibawa pemain. |
| 3 · Taman untuk semua | Ketik pelan untuk meletakkan bangku, tong dan akses masuk. | FAHAM akses Sofia, FIKIR akibat halangan, PILIH tempat, AMAL susunan mesra semua. Objek taman berubah. |
| 4 · Ruang kita bersama | Dengar dua pihak; pilih jadual; pasang persetujuan. | KENAL masalah, FAHAM dua keperluan, FIKIR masa, PILIH kompromi, AMAL persetujuan. Papan kenyataan berubah. |
| 5 · Hari Sahabat | Catat tiga keperluan; sediakan hidangan, akses dan kitar semula. | FAHAM keperluan sebenar, FIKIR pilihan, PILIH persediaan, AMAL kerjasama. Semua jiran berkumpul. |
Setiap misi memberi rumusan kaitan Rukun Negara. Panel rujukan memuatkan lima prinsip, lima cita-cita dan ikrar daripada bahan yang dibekalkan pengguna, bersama pautan rasmi. Contoh misi ialah tafsiran pendidikan PGM, bukan tafsiran perundangan.
Sasaran reka bentuk: 2–3 minit setiap misi dan 10–15 minit satu sesi. Tempoh ini belum disahkan dengan pemain sebenar; peserta berpengalaman boleh tamat lebih cepat.
7. Laporan ujian
Kaedah: Chromium tanpa paparan fizikal; ujian visual menggunakan WebGL sebenar melalui perender perisian. Ujian fungsi penuh menggunakan klik pada antara muka dan masa animasi dipercepat. Panggilan lukisan GPU dinyahaktifkan dalam ujian fungsi dipercepat untuk menjimatkan masa; semakan visual dibuat berasingan dengan perender aktif.
Semakan visual: desktop 1280 × 850; telefon 390 × 844 dan 360 × 640; mendatar 844 × 390. Tajuk terpotong pada skrin kecil telah dibaiki. Label yang bertindih disembunyikan mengikut keutamaan; semua lokasi kekal tersedia melalui Peta. Butang sentuhan, panel Bantuan dan kawalan bunyi turut diperiksa.
Keputusan: 14 pemeriksaan fungsi lulus; 0 ralat halaman JavaScript direkodkan.
- LULUS — Permainan baharu bermula dan enjin 3D tersedia.
- LULUS — Semua 23 sasaran lokasi/NPC mempunyai laluan dari titik mula.
- LULUS — Misi 1: tiga perbualan, satu ganjaran.
- LULUS — Muat semula mengekalkan kiriman, kemajuan dan kedudukan pemain.
- LULUS — Misi 2: penerima salah memberi petunjuk; kiriman kepada Lina berjaya.
- LULUS — Misi 3: pilihan salah boleh diulang; tiga perubahan taman melengkapkan satu misi.
- LULUS — Misi 4: kedua-dua pandangan diperlukan sebelum persetujuan jadual.
- LULUS — Misi 5: keperluan tetamu, tiga persediaan dan penamat 5/5.
- LULUS — Ganjaran tidak berganda; penamat kekal selepas muat semula.
- LULUS — Ulang misi menetapkan semula misi pilihan dan selepasnya sahaja.
- LULUS — Mod Cabaran, kurang animasi dan dialog menghentikan pergerakan.
- LULUS — Kawalan papan kekunci menggerakkan watak.
- LULUS — Panel rujukan dan pautan sumber rasmi tersedia.
- LULUS — Tiada ralat JavaScript halaman semasa ujian fungsi penuh.
Batas ujian: Ini bukan ujian Android fizikal atau kajian bersama manusia. Kelajuan bingkai, penggunaan bateri, masa sebenar sesi, kebolehbacaan bagi pengguna tertentu dan keserasian pelayar lama belum disahkan. Peranti tanpa WebGL2 menerima arahan untuk mencuba pelayar yang sesuai; tiada mod 2D gantian dalam V1.
8. Ujian lapangan yang dicadangkan
Mulakan dengan tiga peserta daripada setiap kumpulan: kanak-kanak 7–12 tahun dengan pendamping, remaja 13–17 tahun dan dewasa. Gunakan sekurang-kurangnya satu telefon Android sederhana serta satu komputer.
| Perhatikan | Catat |
|---|
| Mula tanpa penerangan panjang | Masa sehingga tindakan bermakna pertama; sasaran reka bentuk ≤30 saat. |
| Selesaikan satu misi | Bilangan bantuan, tersalah tekan dan tempat pemain berhenti. |
| Fahami makna tindakan | Minta pemain terangkan satu sebab tindakannya membantu jiran. |
| Keseronokan | Skala 1–5 dan soalan “Bahagian mana anda mahu main lagi?” |
| Sambung & tamat | Tutup/muat semula, sambung dan sahkan penamat 5/5. |
Bandingkan jawapan antara kumpulan. Ubah arahan, jarak kamera atau misi berdasarkan pemerhatian; jangan menganggap prototaip terbukti sesuai untuk semua umur sebelum ujian ini.
9. Simpanan, aset & penyelenggaraan
Kunci simpanan baharu: pgm-kampung-sahabat-v1. Simpanan V33 tidak disentuh. Tiada data pemain dihantar ke pelayan. Mengosongkan data pelayar atau bertukar domain/peranti boleh menyebabkan kemajuan terdahulu tidak tersedia. Jika localStorage disekat, permainan memaparkan notis dan boleh diteruskan sepanjang halaman terbuka.
Fail operasi: index.html, game.js, style.css, assets/logo.png, assets/badge.png. Kod sumber: source/game.js. Enjin Three.js r180 dibundel setempat; lesen MIT disertakan. Aset 3D berbentuk geometri asal, tanpa permintaan CDN. Tiada akaun, backend atau pangkalan data diperlukan.
10. Rujukan
Kampung Sahabat V1.0 · Penggerak Malaysia · Prototaip untuk penilaian dan penambahbaikan.