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 |

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
View3Ddalam 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.

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.
- 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, 0adalah titik asal, dan satu unit dimaksudkan sebagai satu meter, jadi angkanya tetap kecil. - 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.
- 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.
- Transformasi. Setiap objek punya posisi, rotasi, dan skala, semuanya kini dengan z. Rotasi memakai radian (
Math.PIberarti setengah putaran), atau pakaiangleuntuk derajat.Container3Dmengelompokkan objek sehingga memutar induk ikut memutar anaknya, begitulah cara membuat planet dengan bulannya. - Kamera. Setiap view punya kamera yang mulai di titik asal, jadi mundurkan dulu kameranya. Field of view (
fov) bawaannya 60 derajat.OrbitCameramembuat pemain bisa menyeret untuk berputar mengelilingi target. - Cahaya dan bayangan. Tanpa cahaya,
Material3Dtergambar hitam.DirectionalLightbekerja seperti matahari,PointLightseperti bohlam, danSpotLightseperti senter. AktifkancastShadowpada directional light atau spot light, maka mesh akan menjatuhkan dan menerima bayangan; point light tidak menghasilkan bayangan.

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.

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.

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

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.

- Pakai agen coding AI dengan bijak. Tim merilis skill
pixijs-3duntuk agen seperti Claude Code, Cursor, Codex, dan Copilot, dipasang dengannpx 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.




