Langsung ke konten

Mengenal PixiJS 3D: Panduan Pemula Membuat Game 3D di Browser, Plus 2 Game Gratis untuk Dimainkan

abe ·

PixiJS 3D menambahkan engine 3D lengkap ke PixiJS, gratis dengan lisensi MIT. Ini isi sebuah adegan 3D, cara membuat yang pertama, dan dua game browser gratis yang dibuat dengannya.

Sampul VENO: adegan pulau 3D yang dirender PixiJS 3D dengan judul PixiJS 3D, 3D di web

PixiJS 3D adalah engine 3D baru dan gratis dari tim PixiJS yang berjalan di stage yang sama dengan sprite 2D kamu. Engine ini masuk tahap open beta pada 12 November 2026, mengutamakan WebGPU dengan cadangan WebGL2, dan berlisensi MIT. Kalau kamu bisa sedikit JavaScript, hari ini juga kamu bisa menaruh adegan 3D lengkap dengan cahaya dan bayangan di halaman web. Kalau cuma ingin bermain, dua game gratis yang dibuat dengannya sudah bisa dimainkan di browser.

Panduan ini menjelaskan beberapa ide dasar yang membentuk setiap adegan 3D, menunjukkan kode minimal untuk membuat adegan pertamamu, dan mengarahkan kamu ke game serta contoh yang layak dicoba.

PixiJS 3D secara singkat

Apa itu Ekstensi 3D untuk PixiJS, dirilis di npm sebagai @pixi/3d
Dibuat oleh Tim PixiJS
Status Open beta sejak 12 November 2026; API masih bisa berubah sebelum 1.0
Harga dan lisensi Gratis, lisensi MIT
Rendering Mengutamakan WebGPU, kode yang sama berjalan di WebGL2
Syarat pixi.js 8.23.0 atau lebih baru
Bahan belajar 35 panduan, lebih dari 100 contoh langsung, 3 tutorial di editor live
Game untuk dicoba Nightward dan Mach 2 di situs resmi Good Stuff

Pulau 3D kecil dengan pohon pinus, kabin merah, dan kolam, dirender langsung oleh PixiJS 3D di galeri contoh resmi, gambar: PixiJS

Apa yang ditambahkan PixiJS 3D ke PixiJS

PixiJS sudah lama menjadi salah satu renderer 2D paling populer untuk game web. Paket baru ini tidak menggantikannya dan bukan engine kedua yang berjalan di sampingnya. Adegan 3D berada di dalam View3D, dan View3D hanyalah display object biasa, seperti sprite. Kamu menambahkannya ke stage, mengatur posisi dan ukurannya, dan elemen 2D bisa berada di depan atau di belakangnya.

Desain ini membuka banyak kemungkinan:

  • Trofi atau karakter 3D yang berputar di dalam menu atau layar toko yang selebihnya 2D.
  • Game 3D layar penuh dengan HUD, menu, dan tombol sentuh digambar memakai PixiJS 2D biasa di atasnya, tanpa lapisan HTML terpisah yang harus disinkronkan.
  • Beberapa jendela View3D dalam satu adegan 2D, masing-masing dengan kameranya sendiri.
  • Container 2D yang digambar langsung ke permukaan 3D, misalnya layar di dalam monitor 3D.

Filter dan mask bekerja di view 3D, objek 3D menerima pointer event yang sama seperti sprite, dan model glTF dimuat lewat loader Assets yang biasa kamu pakai untuk gambar.

Tim juga menyebut engine ini “cepat secara bawaan”. Mesh yang berbagi satu geometry dan satu material digambar dalam satu panggilan instanced tanpa perlu kamu minta. Di sebagian besar browser WebGPU, culling berjalan di compute shader; di Safari serta iPhone atau iPad, culling berjalan di CPU untuk adegan biasa. Hanya mesh yang berubah yang diperbarui, jadi adegan yang diam nyaris tidak membebani CPU. Untuk hutan atau kerumunan, BatchedMesh3D menggambar salinan dalam jumlah sangat besar, dan demo resminya menampilkan 100.000 objek lengkap dengan bayangan.

Cincin raksasa dari banyak objek kecil berwarna-warni yang digambar BatchedMesh3D dalam contoh PixiJS 3D, gambar: PixiJS

6 bahan dasar sebuah adegan 3D

Tutorial resmi “3D 101” memecah 3D menjadi ide-ide kecil yang saling bertumpuk. Pelajari dengan urutan ini dan sisa dokumentasinya akan jauh lebih mudah dibaca.

  1. Ruang. Posisi 2D punya x dan y; 3D menambahkan z. Di PixiJS 3D, x mengarah ke kanan, y ke atas, dan z keluar dari layar ke arahmu. Perhatikan bahwa y mengarah ke atas, kebalikan dari PixiJS 2D. 0, 0, 0 adalah titik asal, dan satu unit dimaksudkan sebagai satu meter, jadi angkanya tetap kecil.
  2. Segitiga. Setiap bentuk tersusun dari segitiga. Satu titik disebut vertex, tiga vertex membentuk segitiga, kubus butuh 12 segitiga dan bola mulus sekitar seribu. Daftar vertex dan segitiga itu disebut geometry: hanya bentuk, tanpa warna.
  3. Mesh = geometry + material. Material menentukan benda itu terbuat dari apa. Gabungkan keduanya dan kamu mendapat mesh, objek yang ditambahkan ke adegan. PixiJS 3D menyediakan sembilan bentuk umum, termasuk kubus, bola, kerucut, dan torus.
  4. Transformasi. Setiap objek punya posisi, rotasi, dan skala, semuanya kini dengan z. Rotasi memakai radian (Math.PI berarti setengah putaran), atau pakai angle untuk derajat. Container3D mengelompokkan objek sehingga memutar induk ikut memutar anaknya, begitulah cara membuat planet dengan bulannya.
  5. Kamera. Setiap view punya kamera yang mulai di titik asal, jadi mundurkan dulu kameranya. Field of view (fov) bawaannya 60 derajat. OrbitCamera membuat pemain bisa menyeret untuk berputar mengelilingi target.
  6. Cahaya dan bayangan. Tanpa cahaya, Material3D tergambar hitam. DirectionalLight bekerja seperti matahari, PointLight seperti bohlam, dan SpotLight seperti senter. Aktifkan castShadow pada directional light atau spot light, maka mesh akan menjatuhkan dan menerima bayangan; point light tidak menghasilkan bayangan.

Sembilan bentuk 3D bawaan PixiJS 3D, termasuk bola, torus, kerucut, kubus, dan simpul, semuanya dengan material tanah liat, gambar: PixiJS

Adegan pertamamu dalam beberapa baris

Kamu hanya butuh dua paket: npm install pixi.js @pixi/3d. Lalu buat app, minta WebGPU (PixiJS beralih ke WebGL2 jika tidak tersedia), dan tambahkan view:

import { View3D, Mesh3D, SphereGeometry, Material3D, DirectionalLight } from '@pixi/3d';
import { Application } from 'pixi.js';

const app = new Application();
await app.init({ preference: 'webgpu', resizeTo: window, antialias: true });
document.body.appendChild(app.canvas);

const view3d = new View3D({ autoResize: true });
app.stage.addChild(view3d);

const ball = new Mesh3D({
  geometry: new SphereGeometry({ radius: 0.5 }),
  material: new Material3D({ baseColor: 0xe91e63 }),
});
ball.position.y = 0.5;
view3d.root.addChild(ball);

view3d.camera.position.set(0, 2, 5);
view3d.camera.lookAt(ball.position);

const sun = new DirectionalLight({ color: 0xfff4e0, intensity: 3 });
sun.position.set(-3, 5, 2);
view3d.root.addChild(sun);
sun.lookAt({ x: 0, y: 0, z: 0 });

Semua yang ada di dunia 3D ditaruh di bawah view3d.root, seperti objek 2D di bawah app.stage. Ada dua jebakan pemula yang perlu diingat: kalau tidak terlihat apa-apa, kemungkinan kamera masih berada di dalam objek di titik asal; kalau objeknya hitam, berarti kamu belum menambahkan cahaya. Menambahkan view3d.environment dengan warna langit dan warna tanah akan menerangi sisi yang tidak terkena matahari.

Untuk bayangan, atur sun.castShadow = true dan tambahkan lantai dari PlaneGeometry yang dibaringkan dengan rotation.x = -Math.PI / 2. Tutorialnya menyarankan mematikan castShadow pada lantai besar agar detail bayangan matahari yang terbatas dipakai untuk objek kecil, sehingga bayangan mereka tetap tajam.

Material dan model: membuat objek tampak nyata

Material3D yang hanya diberi warna akan tampak seperti kapur, karena roughness dimulai dari 1. Dua angka mengubah segalanya:

Pengaturan Nilai Tampak seperti
roughness 0 Halus seperti cermin, kilau tajam
roughness 1 (bawaan) Kasar sepenuhnya, seperti kapur atau tanah liat
metallic 0 Bukan logam: plastik, kayu, batu
metallic 1 Logam yang mewarnai pantulannya dengan warnanya sendiri

Jadi plastik merah muda mengilap adalah warna dengan roughness 0.3, krom adalah putih dengan metallic 1 dan roughness 0.05, dan emas adalah warna emas dengan metallic 1. Logam sebagian besar memantulkan sekelilingnya, jadi paling bagus jika ada environment untuk dipantulkan.

Deretan bola dari halus ke kasar dan dari plastik ke logam yang memantulkan langit senja di PixiJS 3D, gambar: PixiJS

Tidak ada yang membuat karakter dari kubus. Seniman mengekspor model dari alat seperti Blender ke glTF (.gltf atau .glb), format terbuka yang bisa memuat mesh, material, dan animasi. Di PixiJS 3D kamu memuat file dengan Assets.load, membungkusnya dalam Model3D, lalu memutar animasi bawaannya dengan autoPlay. Model mempertahankan ukuran saat dibuat, jadi ukur dan atur skalanya sebelum ditempatkan. Jika model adalah seluruh adegan, View3D.from(source) membuat view lengkap dengan kamera dan cahaya.

Di luar dasar-dasarnya, engine ini juga punya skinning, morph target, tekstur terkompresi, material PBR, Phong, flat, dan toon, HDR, tone mapping, post-processing, partikel, serta cascaded shadows.

Dua game gratis buatan PixiJS 3D

Tim PixiJS membuat dua game dengan engine ini dan menaruhnya di situs Good Stuff, tempat kamu bisa memainkannya gratis di browser.

Nightward adalah game survival berlatar kuburan di bawah sinar bulan. Kamu hanya bergerak: enam senjata menembak sendiri sementara gerombolan musuh terus bertambah, sampai Grave Reaper bangkit dari ruang bawah tanah makam. Sprite pixel art berdiri di adegan 3D sebagai billboard yang diterangi dan menjatuhkan bayangan, dengan efek bloom, tilt-shift, dan kabut di atasnya. Uniknya, game ini menggambar grafis dan membuat musiknya lewat kode, jadi sama sekali tidak memuat file gambar atau audio.

Gameplay Nightward dengan pahlawan pixel art melawan gerombolan yang terus bertambah di kuburan 3D bermandikan sinar bulan, gambar: PixiJS

Mach 2 adalah game runner di dalam half-pipe. Kamu berbelok mengelilingi pipa, melompat, dan mengumpulkan kubus melewati lima zona, dengan HUD 2D di atasnya. Game ini berjalan di WebGPU atau WebGL2, dengan keyboard atau di ponsel.

Tips singkat untuk pemain:

  1. Di Nightward, terus bergerak membentuk lingkaran lebar; diam di tempat membuat gerombolan mendekat, padahal senjatamu butuh ruang untuk bekerja.
  2. Di Mach 2, manfaatkan seluruh lengkungan pipa untuk menyejajarkan kubus sebelum melompat.
  3. Jika game tersendat, tutup tab lain yang berat dan pastikan akselerasi perangkat keras aktif di pengaturan browser.

Mach 2, game runner half-pipe bernuansa merah muda buatan PixiJS 3D, berjalan di browser desktop, gambar: PixiJS

Langkah selanjutnya untuk developer game web

  • Mulai dari yang kecil. Ikuti quick start resmi, lalu salin satu contoh dan ubah satu angka setiap kali. Setiap contoh di galeri dilengkapi kode sumbernya.
  • Coba tutorialnya. Tiga proyek berjalan di editor live: floating shapes, model showroom, dan shooting gallery yang membangun game kecil langkah demi langkah.
  • Baca game lengkap. Game balap di bagian contoh menunjukkan bagaimana sebuah proyek utuh disusun.

Contoh balap resmi PixiJS 3D dengan mobil kuning di lintasan, pohon pinus, dan gapura oranye, gambar: PixiJS

  • Pakai agen coding AI dengan bijak. Tim merilis skill pixijs-3d untuk agen seperti Claude Code, Cursor, Codex, dan Copilot, dipasang dengan npx skills add https://github.com/pixijs/pixijs-skills. Skill ini mencantumkan kesalahan yang tidak memunculkan error tetapi menghasilkan gambar yang salah.
  • Ingat ini masih beta. Penguji closed beta mengirim lebih dari 30 laporan bug dan permintaan fitur sebelum peluncuran, dan API masih bisa berubah sebelum 1.0. Kunci versimu dan baca catatan rilis sebelum memperbarui.

Tautan resmi yang berguna: pengumuman PixiJS 3D, tutorial 3D 101, galeri contoh, dan game di Good Stuff.

FAQ

Apakah PixiJS 3D gratis?

Ya. PixiJS 3D berlisensi MIT, dan tim menyatakan akan selalu begitu. Kamu bisa memakainya untuk proyek gratis maupun komersial.

Apakah perlu WebGPU untuk memakai PixiJS 3D?

Tidak. Engine ini dirancang di sekitar WebGPU, tetapi kode yang sama berjalan di WebGL2, dan setiap browser hanya mengunduh backend yang dipakainya.

Bisakah 2D dan 3D digabung dalam satu game PixiJS?

Bisa. View3D adalah display object, jadi kamu bisa menaruh adegan 3D di stage 2D, menggambar UI 2D di atas 3D, bahkan menggambar container 2D ke permukaan 3D.

Versi PixiJS berapa yang dibutuhkan?

@pixi/3d membutuhkan pixi.js 8.23.0 atau lebih baru, dan sebaiknya diimpor sebelum app.init dijalankan.

Bisakah memuat model dari Blender?

Bisa. Ekspor model ke glTF (.gltf atau .glb), muat dengan Assets.load, lalu tampilkan dengan Model3D, termasuk animasinya.

Di mana bisa main game buatan PixiJS 3D?

Nightward dan Mach 2 bisa dimainkan gratis di browser lewat situs resmi Good Stuff, goodstuff.pixijs.io.

Artikel terkait

Memuat game…

VENOGAME / PLAYBOOK

Arenaku

Di perangkat ini. Tanpa akun.

Ketuk hati untuk membuat koleksi gamemu.