Dunia Pokomen — Website & Server

Website peta pixel-art yang warganya lahir otomatis dari komentar Instagram.

• Peta interaktif: geser, zoom, klik hewan untuk melihat kartu warganya.
• Buku Warga, Usulan Fasilitas, Kabar Desa.
• Server: menerima komentar Instagram (webhook), mengubahnya jadi warga, menjalankan aturan evolusi.
• Ruang Admin (/admin.html): sinkron komentar, antrean komentar yang tidak terbaca, ubah tingkat (termasuk Legenda), sembunyikan/hapus warga, tambah warga manual (misalnya dari TikTok), atur status usulan fasilitas.

Tanpa dependensi npm. Database: Upstash Redis (gratis, langsung dari Vercel Marketplace).

---

Struktur

api/        fungsi server Vercel
  dunia.js     data publik untuk website
  webhook.js   penerima komentar dari Instagram
  admin.js     aksi admin (butuh password)
  cron.js      tugas harian: perbarui token + sinkron komentar
lib/
  rules.js     ATURAN DUNIA (tingkat & evolusi) ← ubah di sini
  parse.js     pembaca isi komentar
  ig.js        pemanggil Instagram API
  db.js        klien Upstash Redis
public/     website (index.html, admin.html, privasi.html, aset)
test/       uji otomatis (npm test)
dev-server.mjs  pratinjau lokal dengan data contoh

---

Langkah setup

1. Taruh kode di Vercel

1. Buat repository baru di GitHub dan unggah isi folder ini.
2. Di vercel.com → Add New → Project → pilih repository tadi → Deploy. Framework: biarkan Other. Tidak perlu build command.

2. Sambungkan database

1. Di project Vercel → tab Storage (atau Marketplace) → pilih Upstash → Redis → buat database (paket gratis cukup).
2. Hubungkan ke project ini. Variabel UPSTASH_REDIS_REST_URL dan UPSTASH_REDIS_REST_TOKEN (atau KV_REST_API_URL / KV_REST_API_TOKEN) akan terisi otomatis.

3. Buat aplikasi Meta untuk Instagram

1. Buka developers.facebook.com → My Apps → Create App.
2. Pilih use case untuk Instagram API (mengelola konten/pesan Instagram), lalu pilih jalur API setup with Instagram login (Instagram API with Instagram Login).
3. Di bagian Generate access tokens, tambahkan akun Instagram profesional @duniapokomen dan login. Pastikan izin instagram_business_basic dan instagram_business_manage_comments aktif.
4. Salin access token (token jangka panjang, berlaku ±60 hari; server memperbaruinya otomatis).
5. Salin Instagram app secret dari halaman pengaturan API tadi.

4. Isi Environment Variables di Vercel

Project → Settings → Environment Variables:

Nama	Isi
ADMIN_PASSWORD	password untuk Ruang Admin (buat yang panjang)
IG_ACCESS_TOKEN	token dari langkah 3
IG_APP_SECRET	Instagram app secret dari langkah 3
IG_WEBHOOK_VERIFY_TOKEN	kata bebas buatanmu, misalnya pokomen-rahasia-123
CRON_SECRET	string acak panjang (dipakai Vercel untuk menjalankan tugas harian)
POKOMEN_HARI_PERTAMA	opsional, tanggal Hari ke-1, contoh 2026-10-24
IG_USERNAME	opsional, duniapokomen (agar komentar balasanmu sendiri diabaikan)

Lalu Deployments → Redeploy supaya variabel terbaca.

5. Aktifkan webhook (komentar masuk real-time)

1. Di aplikasi Meta → bagian Configure webhooks:
   • Callback URL: https://DOMAIN-KAMU.vercel.app/api/webhook
   • Verify token: sama persis dengan IG_WEBHOOK_VERIFY_TOKEN
   • Klik Verify and save, lalu langganan (subscribe) field comments.
2. Buka https://DOMAIN-KAMU.vercel.app/admin.html, masuk, klik Aktifkan webhook.
3. Jika Meta meminta aplikasi dalam mode Live agar webhook terkirim, isi URL kebijakan privasi dengan https://DOMAIN-KAMU.vercel.app/privasi.html lalu ubah ke Live.

Selama webhook belum jalan, tombol Sinkron komentar sekarang di Ruang Admin dan tugas harian otomatis (setiap 05.00 WIB) tetap menarik komentar dari 5 postingan terbaru.

6. Uji

Tulis komentar di postingan terbaru:

Nama: Bolu | Hewan: Kucing + Naga | Cerita: suka menghangatkan air mandi warga

Dalam beberapa detik (webhook) atau setelah klik Sinkron, Bolu muncul di peta.

---

Format komentar yang diumumkan di video

Tujuan	Contoh komentar
Daftar jadi warga	Nama: Bolu | Hewan: Kucing + Naga | Cerita: suka menghangatkan air mandi warga
Evolusi	Cerita: hari ini Bolu belajar berenang di danau barat
Usul fasilitas	Usul: Kolam Minum

Komentar bebas seperti "Namaku Bolu, kucing + naga, dia suka tidur di atap Balai Warga" juga dicoba dibaca. Yang gagal terbaca masuk Antrean komentar di Ruang Admin untuk kamu lengkapi.

Aturan evolusi (bisa diubah di lib/rules.js)

Tier	Nama	Benefit	Cara naik
1	Regular	-	lahir
2	Pseudo-evo	tumbuh besar	cerita di postingan baru
3	Mega Evolution	elemen bangkit (aura, warna elemen)	cerita di postingan baru
4	Mythical Evolution	armor dasar	cerita di postingan baru
5	Legendary Evolution	outfit custom	Admin
6	God Mode	ganti wujud dasar (Mecha, Mecha Beast, Cyborg, Kristal, Roh Cahaya, Kaiju)	Admin

• Satu postingan hanya memberi satu kenaikan tier per warga (anti spam).
• Saat mencapai Mega/Legendary/God Mode tanpa data elemen/outfit/wujud, server membalas komentar pemiliknya untuk bertanya. Pemilik menjawab dengan Elemen: ..., Outfit: ..., atau Wujud Dewa: ... (boleh ditulis lebih awal).
• Elemen, outfit, dan wujud bisa juga diisi/diubah Admin di tabel Warga.
• Usulan fasilitas diurutkan dari like terbanyak. Tandai Dibangun + nomor episode di Ruang Admin.
• Data lama (skema 4 tingkat) otomatis dipindahkan: Legenda lama menjadi Legendary Evolution.

Dukungan Trakteer (opsional)

Tombol Traktir Admin dan Papan Terima Kasih di website. Traktiran tidak memberi keuntungan apa pun di dalam game: tidak ada evolusi atau status khusus.

This is the beginning of the README. Read the rest at the original. Read the full README ↗