ABS Lintas Dunia — panduan pemasangan dan penggunaan v4

Paket ini berisi aplikasi web lima dunia belajar. Setelah dipasang pada hosting HTTPS milik Anda, siswa dapat membuka tautannya tanpa akun ChatGPT, memilih karakter, dan bermain sendiri di HP, laptop, atau IFP. Aplikasi dapat ditambahkan ke layar utama sebagai PWA. Paket ini bukan APK Android atau aplikasi Play Store.

1. Isi paket

Berkas index.html berada langsung di bagian paling atas ZIP. Seluruh kode, grafis 3D, ikon, font sistem, contoh soal, dan mesin Three.js tersedia di dalamnya. Tidak perlu Supabase, Firebase, API key, Node.js, biaya API, atau akun siswa untuk menjalankan versi ini. Simpan salinan ZIP sebagai cadangan.

2. Pasang pertama kali di Cloudflare Pages

1. Unduh ABS_Lintas_Dunia_V4_SIAP_PASANG.zip ke laptop.

2. Masuk ke akun Cloudflare milik Anda atau sekolah. Gunakan akun sekolah jika pemasangan diserahkan kepada sekolah.

3. Buka Workers & Pages. Pilih Create application, kemudian jalur Pages → Use direct upload / Upload assets. Pilih Pages untuk mengunggah aset statis.

4. Isi nama proyek, misalnya lintas-dunia-sekolah. Jika nama sudah terpakai, tambahkan nama sekolah.

5. Tarik ZIP ke area unggah. Cloudflare mendukung ZIP atau folder aset. Jika perlu mengekstrak ZIP, unggah seluruh isi folder yang langsung memuat index.html, bukan folder pembungkus di luarnya.

6. Klik Deploy site. Tunggu status berhasil, lalu buka alamat pages.dev yang diberikan Cloudflare. Tidak ada perintah build yang perlu dijalankan untuk paket siap pakai ini.

7. Pastikan menu menampilkan Edisi 4, pratinjau karakter, dan peta lima pulau. Coba Game 2 dan Game 3.

8. Bagikan alamat HTTPS tersebut kepada siswa atau masukkan sebagai tautan demo di katalog ABS EDU. Siswa tidak memakai alamat chatgpt.site.

Jika memilih Direct Upload, pembaruan berikutnya dilakukan dengan unggah paket baru pada proyek yang sama. Untuk beralih ke integrasi Git otomatis di kemudian hari, Cloudflare meminta pembuatan proyek Git baru. Jangan memakai proyek ABS EDU yang sudah ada untuk percobaan unggah ini karena isinya dapat terganti; buat proyek khusus game.

3. Memasang ikon aplikasi

Android: buka alamat game di Chrome. Gunakan tombol Pasang aplikasi jika tersedia, atau menu browser Instal aplikasi / Tambahkan ke layar utama. Setujui pemasangan, lalu buka lewat ikonnya.

iPhone/iPad: buka melalui Safari, pilih Bagikan → Tambahkan ke Layar Utama, lalu Tambah. Nama menu dapat sedikit berbeda menurut versi sistem.

Laptop/IFP: buka alamat game melalui Chrome atau Edge. Gunakan ikon pemasangan pada bilah alamat atau menu browser untuk memasang aplikasi jika didukung. Jika pemasangan tidak tersedia, tautan HTTPS tetap dapat dimainkan di browser.

PWA dapat dipasang dari hosting HTTPS; membuka file HTML langsung dari penyimpanan HP/laptop bukan cara menjalankan paket ini. Fitur layar penuh bergantung pada browser. Permainan tetap berjalan jika permintaan layar penuh ditolak.

4. Persiapan offline

Saat pertama kali membuka hosting sendiri, tetap nyalakan internet sampai bagian bawah menu menampilkan Aplikasi siap offline pada perangkat ini. Tunggu unduhan selesai, kemudian tutup dan buka ulang game. Uji dengan mematikan koneksi sebentar dan membuka kelima game sebelum dipakai di kelas tanpa internet.

Mode offline hanya tersedia setelah aset berhasil disimpan pada perangkat tersebut. Menghapus data browser, mode samaran, ruang penyimpanan yang dibersihkan sistem, atau pindah domain dapat menghilangkan aset dan progres lokal. Tombol instal dan persiapan offline tidak diaktifkan pada pratinjau internal/Sites yang memakai gerbang login. Tidak perlu mengunduh pustaka dari CDN saat bermain.

5. Karakter dan kontrol

Pada menu utama pilih Ubah karakter. Tersedia laki-laki/perempuan, empat model rambut, tiga model baju, dua model sepatu, tiga pilihan tas, lima aksesori, serta pilihan warna. Semua gaya rambut dan aksesori dapat dipakai kedua karakter. Pratinjau berubah langsung; gunakan Putar, Jalan, Lompat, atau Sapa untuk melihatnya. Klik Simpan karakter. Karakter yang sama digunakan di kelima dunia pada browser tersebut.

Laptop: WASD/panah untuk bergerak, Spasi untuk melompat, E untuk mengambil benda dekat pada Game 4–5. Game 1 tetap menggunakan E untuk berinteraksi. HP/IFP: gunakan tombol arah, pilihan jawaban, Lompat, dan Ambil. Tombol pilihan juga membantu mengarahkan karakter secara otomatis.

6. Cara bermain setiap dunia

Dunia	Cara bermain	Jika keliru
1 — Pulau Cerdas	Bantu kebun, pasar, dan jembatan; menjawab soal lalu melakukan aktivitas.	Baca petunjuk dan coba lagi.
2 — Gerbang Kebenaran	Dua pintu dalam satu lorong. Masuk BENAR/SALAH. Jawaban tepat membuat pintu hijau, terbuka, dan karakter berjalan ke pasangan pintu untuk soal berikutnya. Tiga soal per level.	Pintu merah, karakter jatuh, satu nyawa hilang. Kembali ke pertanyaan pertama level tersebut; level terdahulu tetap selesai.
3 — Arus Angka	Bidik salah satu batu dengan tombol jawaban atau kiri/kanan; tekan Lompat/Spasi. Batu benar menjadi pijakan. Soal berikutnya muncul langsung dan karakter tetap di pijakan terakhir.	Batu yang dipilih tenggelam bersama karakter. Satu nyawa hilang; kembali ke batu benar terakhir dan mengulang soal itu.
4 — Rimba Penemuan	Ambil semua benda yang sesuai petunjuk. Karakter membungkuk, membawa benda, dan meletakkannya pada meja pengumpulan.	Ledakan kartun; satu nyawa hilang. Koleksi pada tantangan itu dimulai ulang.
5 — Menara Bintang	Ambil jawaban sesuai urutan, bawa ke meja, dan susun pada tempat 1–4.	Ledakan kartun; satu nyawa hilang. Urutan pada tantangan itu dimulai ulang.

Game 2–5 memiliki tiga nyawa dan dua level. Nyawa pulih pada level berikutnya. Saat nyawa habis, gunakan Ulangi level ini. Lencana terbuka setelah game selesai; kumpulkan kelimanya untuk membuka akhir cerita. Peta dunia dapat dibuka saat karakter tidak sedang melakukan animasi aksi. Menutup aplikasi menyimpan tantangan selesai; koleksi sebagian pada tantangan aktif tidak disimpan.

7. Mengedit soal dan membagikannya

Menu utama → Ruang Guru → Edit Game 2, 3, 4, atau 5. Ubah pertanyaan, pilihan, kunci, dan penjelasan. Game 2 berisi enam pernyataan; Game 3 enam soal dengan tiga pilihan; Game 4 enam pencarian dengan lima pilihan dan beberapa jawaban benar; Game 5 empat susunan dengan empat jawaban.

Pada Game 5, masukkan jawaban dalam urutan benar. Game mengacak posisi benda. Saran keterbacaan: pertanyaan satu atau dua kalimat pendek; pilihan 2–8 kata. Pilihan panjang tetap tersedia lengkap pada panel jawaban yang bisa digulir.

Klik Simpan materi, lalu mulai ulang game terkait untuk menggunakan soal baru. Sesi yang dilanjutkan memakai salinan bank soal saat sesi dibuat. Game 1 mempunyai editor sembilan soal tersendiri di Ruang Guru pada halaman Game 1.

Materi yang Anda edit tidak otomatis dikirim ke perangkat siswa. Gunakan Ekspor materi, kirim JSON melalui saluran kelas, lalu buka Ruang Guru → Impor pada masing-masing perangkat. Tidak ada login guru, server kelas, nilai bersama, atau multiplayer dalam versi ini. Editor lokal tidak dikunci dengan kata sandi.

8. Memperbarui aplikasi

Cadangkan materi dan hasil dari Ruang Guru sebelum mengganti berkas. Unggah seluruh isi ZIP baru pada proyek Pages yang sama dengan Create new deployment. Jangan mengganti alamat domain jika ingin mempertahankan progres lokal. Setelah berhasil, sambungkan perangkat ke internet, buka aplikasi, lalu tutup semua jendela game dan buka kembali ketika pembaruan tersedia. Jangan menghapus data browser sebagai langkah pertama karena progres berada di sana.

Kode service worker membawa nomor versi cache. Untuk pengembang yang mengubah paket sendiri, ubah nilai CACHE di sw.js setiap kali memperbarui aset agar seluruh berkas dimuat sebagai satu versi. Cache versi lama dibuang setelah versi baru aktif; data soal/progres tidak dihapus oleh service worker.

9. Uji sebelum membagikan ke kelas

- Coba memilih karakter, menutup aplikasi, lalu membukanya kembali.

- Coba pintu benar dan salah; periksa hijau/merah, jatuh, dan nyawa.

- Pada sungai, jawab benar lalu salah; pastikan posisi kembali ke batu terakhir.

- Pada rimba dan menara, pastikan tulisan terbaca, benda dibawa, dan susunan masuk ke meja.

- Uji HP portrait/landscape, tombol sentuh, suara, dan layar penuh pada perangkat sasaran. WebGL memberikan tampilan utama; perangkat tanpa WebGL memakai grafis cadangan sederhana.

- Uji mode offline setelah indikator siap muncul. Jika kurang lancar, tutup tab lain dan gunakan browser yang mendukung WebGL.

Pengujian otomatis memeriksa data soal, logika jawaban, checkpoint, validasi penampilan, dan paket aset. Pengujian browser pengembangan menggunakan grafis cadangan. Instalasi PWA, offline, dan performa HP/IFP fisik perlu diverifikasi pada hosting serta perangkat sekolah.

10. Rujukan pemasangan

Petunjuk penyedia diverifikasi pada 4 November 2026:

- Cloudflare Pages Direct Upload: https://developers.cloudflare.com/pages/get-started/direct-upload/

- Pemasangan aplikasi web: https://developer.mozilla.org/en-US/docs/Web/Progressive_web_apps/Guides/Installing

- Offline dan service worker: https://developer.mozilla.org/en-US/docs/Web/Progressive_web_apps/Guides/Offline_and_background_operation

Mesin grafis Three.js disertakan dengan lisensi MIT dalam THREE-LICENSE.txt.