PixiJS 3D는 PixiJS 팀이 내놓은 새로운 무료 3D 엔진으로, 2D 스프라이트와 같은 스테이지 안에서 동작합니다. 2026년 11월 12일 오픈 베타를 시작했고, WebGPU를 우선 사용하되 WebGL2로도 대체 실행되며, MIT 라이선스로 제공됩니다. 자바스크립트를 조금만 알면 오늘 바로 조명과 그림자가 있는 3D 장면을 웹 페이지에 올릴 수 있고, 게임만 즐기고 싶다면 이 엔진으로 만든 무료 게임 두 편을 이미 브라우저에서 플레이할 수 있습니다.
이 가이드는 모든 3D 장면에 들어가는 몇 가지 기본 개념을 정리하고, 첫 장면을 만드는 최소한의 코드와 함께 해 볼 만한 게임과 예제를 소개합니다.
PixiJS 3D 한눈에 보기
| 무엇인가 | PixiJS용 3D 확장, npm 패키지 이름 @pixi/3d |
| 개발 | PixiJS 팀 |
| 상태 | 2026년 11월 12일부터 오픈 베타, 1.0 전까지 API가 바뀔 수 있음 |
| 가격과 라이선스 | 무료, MIT 라이선스 |
| 렌더링 | WebGPU 우선, 같은 코드가 WebGL2에서도 실행 |
| 요구 사항 | pixi.js 8.23.0 이상 |
| 학습 자료 | 가이드 35편, 100개가 넘는 라이브 예제, 라이브 에디터 튜토리얼 3편 |
| 즐길 수 있는 게임 | 공식 Good Stuff 사이트의 Nightward와 Mach 2 |

PixiJS 3D가 PixiJS에 더하는 것
PixiJS는 오랫동안 웹 게임에서 가장 인기 있는 2D 렌더러 중 하나였습니다. 새 패키지는 이를 대체하지도, 옆에서 따로 돌아가는 두 번째 엔진도 아닙니다. 3D 장면은 View3D 안에 들어가고, View3D는 스프라이트와 똑같은 디스플레이 오브젝트입니다. 스테이지에 추가해 위치와 크기를 정하면 2D를 그 앞에도, 뒤에도 둘 수 있습니다.
이런 구조 덕분에 다양하게 활용할 수 있습니다.
- 평범한 2D 메뉴나 상점 화면에 회전하는 3D 트로피나 캐릭터를 넣기.
- 전체 화면 3D 게임을 만들고 HUD, 메뉴, 터치 버튼은 일반 PixiJS 2D로 위에 그리기. 따로 맞춰야 할 HTML 오버레이가 필요 없습니다.
- 하나의 2D 장면에 여러
View3D창을 두고 각각 다른 카메라 쓰기. - 2D 컨테이너를 3D 표면에 실시간으로 그리기. 예를 들어 3D 모니터 속 화면처럼 쓸 수 있습니다.
필터와 마스크는 3D 뷰에도 적용되고, 3D 오브젝트는 스프라이트와 같은 포인터 이벤트를 받습니다. glTF 모델도 이미지를 불러올 때 쓰는 Assets 로더로 그대로 불러옵니다.
팀은 이 엔진이 “기본값부터 빠르다”고 설명합니다. 같은 지오메트리와 같은 머티리얼을 공유하는 메시는 따로 설정하지 않아도 한 번의 인스턴스 드로우로 묶입니다. 대부분의 WebGPU 브라우저에서는 컬링을 컴퓨트 셰이더에서 처리하고, Safari와 iPhone, iPad에서는 일반적인 장면의 컬링을 CPU에서 처리합니다. 바뀐 메시만 업데이트하므로 멈춰 있는 장면은 CPU를 거의 쓰지 않습니다. 숲이나 군중 같은 장면에는 BatchedMesh3D로 엄청난 수의 복제본을 그릴 수 있으며, 공식 데모는 그림자가 있는 오브젝트 100,000개를 보여 줍니다.

3D 장면을 이루는 6가지 기본 요소
공식 튜토리얼 “3D 101″은 3D를 차곡차곡 쌓이는 작은 개념들로 나눠 설명합니다. 아래 순서대로 익히면 나머지 문서도 훨씬 쉽게 읽힙니다.
- 공간. 2D 위치는 x와 y, 3D는 여기에 z가 더해집니다. PixiJS 3D에서 x는 오른쪽, y는 위쪽, z는 화면에서 나를 향하는 방향입니다. y가 위쪽이라는 점은 PixiJS 2D와 반대이니 주의하세요.
0, 0, 0이 원점이고 1단위는 약 1미터라서 숫자가 작게 유지됩니다. - 삼각형. 모든 형태는 삼각형으로 만들어집니다. 점 하나를 정점이라 부르고, 정점 세 개가 삼각형 하나를 이룹니다. 정육면체에는 삼각형 12개, 매끄러운 구에는 약 1000개가 필요합니다. 정점과 삼각형의 목록이 지오메트리이며, 형태만 있고 색은 없습니다.
- 메시 = 지오메트리 + 머티리얼. 머티리얼은 물체가 무엇으로 만들어졌는지를 정합니다. 둘을 합치면 메시가 되고, 이것이 장면에 추가하는 오브젝트입니다. PixiJS 3D는 정육면체, 구, 원뿔, 토러스 등 자주 쓰는 형태 9가지를 기본으로 제공합니다.
- 트랜스폼. 모든 오브젝트에는 위치, 회전, 크기가 있고 이제 각각 z가 추가됩니다. 회전은 라디안 단위(
Math.PI가 반 바퀴)이며, 각도로 쓰고 싶다면angle을 사용합니다.Container3D로 오브젝트를 묶으면 부모를 돌릴 때 자식도 함께 돌아서, 행성과 위성 같은 구조를 만들 수 있습니다. - 카메라. 뷰마다 카메라가 있으며 처음에는 원점에 있으니 먼저 뒤로 옮겨야 합니다. 시야각
fov의 기본값은 60도입니다.OrbitCamera를 쓰면 드래그로 대상 주위를 돌며 볼 수 있습니다. - 조명과 그림자. 조명이 없으면
Material3D는 검게 그려집니다.DirectionalLight는 태양,PointLight는 전구,SpotLight는 손전등 같은 빛입니다. 방향광이나 스포트라이트에castShadow를 설정하면 메시가 그림자를 드리우고 받습니다. 포인트 라이트는 그림자를 만들지 않습니다.

몇 줄의 코드로 첫 장면 만들기
필요한 패키지는 두 개뿐입니다: npm install pixi.js @pixi/3d. 앱을 만들고 WebGPU를 요청한 뒤(지원하지 않으면 PixiJS가 WebGL2로 전환합니다) 뷰를 추가하세요.
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 });
3D 세계의 모든 것은 view3d.root 아래에 둡니다. 2D 오브젝트를 app.stage 아래에 두는 것과 같습니다. 초보자가 자주 겪는 함정은 두 가지입니다. 아무것도 보이지 않으면 카메라가 아직 원점, 즉 오브젝트 안에 있을 가능성이 크고, 오브젝트가 새까맣다면 아직 조명을 추가하지 않은 것입니다. view3d.environment에 하늘색과 땅색을 지정하면 태양이 닿지 않는 옆면도 밝아집니다.
그림자를 만들려면 sun.castShadow = true를 설정하고 PlaneGeometry로 바닥을 만든 뒤 rotation.x = -Math.PI / 2로 눕힙니다. 튜토리얼은 큰 바닥의 castShadow를 꺼서 태양의 한정된 그림자 해상도를 작은 오브젝트에 쓰도록 하면 그림자가 더 선명해진다고 권합니다.
머티리얼과 모델: 더 진짜처럼 보이게 하기
색만 지정한 Material3D는 분필처럼 보입니다. 거칠기 기본값이 1이기 때문입니다. 핵심은 두 숫자입니다.
| 설정 | 값 | 보이는 모습 |
|---|---|---|
roughness |
0 | 거울처럼 매끄럽고 하이라이트가 또렷함 |
roughness |
1(기본값) | 완전히 거침, 분필이나 점토 같음 |
metallic |
0 | 비금속: 플라스틱, 나무, 돌 |
metallic |
1 | 자기 색으로 반사가 물드는 금속 |
그래서 반짝이는 분홍 플라스틱은 색에 거칠기 0.3, 크롬은 흰색에 metallic 1과 거칠기 0.05, 금은 금색에 metallic 1입니다. 금속은 주로 주변을 비추므로 반사할 환경이 있을 때 가장 보기 좋습니다.

캐릭터를 정육면체로 조립하는 사람은 없습니다. 아티스트는 Blender 같은 도구에서 glTF(.gltf 또는 .glb) 형식으로 모델을 내보냅니다. 메시, 머티리얼, 애니메이션을 함께 담을 수 있는 개방형 형식입니다. PixiJS 3D에서는 Assets.load로 파일을 불러와 Model3D로 감싸고, 파일에 포함된 애니메이션을 autoPlay로 재생합니다. 모델은 제작 당시 크기를 그대로 유지하므로 배치하기 전에 크기를 재고 조정하세요. 모델 하나가 곧 장면 전체라면 View3D.from(source)가 카메라와 조명까지 갖춘 뷰를 바로 만들어 줍니다.
기본 기능 외에도 스키닝, 모프 타깃, 압축 텍스처, PBR·Phong·플랫·툰 머티리얼, HDR, 톤 매핑, 포스트 프로세싱, 파티클, 캐스케이드 그림자를 지원합니다.
PixiJS 3D로 만든 무료 게임 2종
PixiJS 팀은 이 엔진으로 게임 두 편을 만들어 공식 Good Stuff 사이트에 올렸고, 브라우저에서 무료로 플레이할 수 있습니다.
Nightward는 달빛 아래 묘지를 배경으로 한 생존 게임입니다. 플레이어는 이동만 하고, 무기 6종이 자동으로 공격하는 동안 적 무리는 점점 늘어나며, 마침내 무덤에서 Grave Reaper가 깨어납니다. 픽셀 아트 스프라이트는 빛을 받고 그림자를 드리우는 빌보드로 3D 장면에 서 있고, 그 위에 블룸, 틸트 시프트, 안개 효과가 더해집니다. 놀랍게도 아트와 음악을 모두 코드로 만들어 내기 때문에 이미지나 오디오 파일을 하나도 불러오지 않습니다.

Mach 2는 하프파이프 러너 게임입니다. 파이프를 따라 방향을 틀고 점프하며 다섯 구역에서 큐브를 모으고, 달리는 동안 위에 2D HUD가 표시됩니다. WebGPU와 WebGL2 모두에서 실행되며 키보드로도, 휴대폰으로도 즐길 수 있습니다.
플레이어를 위한 간단한 팁:
- Nightward에서는 큰 원을 그리며 계속 움직이세요. 멈춰 서면 적에게 둘러싸이고, 무기도 공간이 있어야 제 힘을 냅니다.
- Mach 2에서는 파이프의 곡면 전체를 활용해 큐브에 줄을 맞춘 뒤 점프하세요.
- 게임이 끊긴다면 다른 무거운 탭을 닫고, 브라우저 설정에서 하드웨어 가속이 켜져 있는지 확인하세요.

웹 게임 개발자를 위한 다음 단계
- 작게 시작하세요. 공식 빠른 시작을 따라 해 본 뒤, 예제 하나를 복사해 숫자를 하나씩 바꿔 보세요. 갤러리의 모든 예제에는 소스 코드가 함께 있습니다.
- 튜토리얼을 해 보세요. 라이브 에디터에서 진행하는 프로젝트 세 가지, 떠다니는 도형, 모델 쇼룸, 사격장이 있으며 마지막 것은 작은 게임을 한 단계씩 만듭니다.
- 완성된 게임을 읽어 보세요. 예제에 있는 레이싱 게임을 보면 하나의 완전한 프로젝트가 어떻게 짜여 있는지 알 수 있습니다.

- AI 코딩 에이전트를 현명하게 활용하세요. 팀은 Claude Code, Cursor, Codex, Copilot 같은 에이전트를 위한
pixijs-3d스킬을 제공하며,npx skills add https://github.com/pixijs/pixijs-skills로 설치할 수 있습니다. 오류는 나지 않는데 그림이 잘못 그려지는 실수들도 정리되어 있습니다. - 아직 베타라는 점을 기억하세요. 출시 전 비공개 베타 테스터들이 30건이 넘는 버그 리포트와 기능 요청을 보냈고, 1.0 전까지 API가 바뀔 수 있습니다. 버전을 고정하고 업그레이드 전에 릴리스 노트를 읽으세요.
공식 링크: PixiJS 3D 발표 글, 3D 101 튜토리얼, 예제 갤러리, Good Stuff 게임.
자주 묻는 질문
PixiJS 3D는 무료인가요?
네. PixiJS 3D는 MIT 라이선스이며, 팀은 앞으로도 계속 무료로 유지하겠다고 밝혔습니다. 무료 프로젝트와 상업 프로젝트 모두에 쓸 수 있습니다.
PixiJS 3D를 쓰려면 WebGPU가 꼭 필요한가요?
아니요. WebGPU를 중심으로 설계됐지만 같은 코드가 WebGL2에서도 실행되며, 각 브라우저는 자신이 쓰는 백엔드만 내려받습니다.
하나의 PixiJS 게임에서 2D와 3D를 섞을 수 있나요?
네. View3D는 디스플레이 오브젝트라서 2D 스테이지 안에 3D 장면을 넣고, 3D 위에 2D UI를 그리고, 2D 컨테이너를 3D 표면에 그릴 수도 있습니다.
어떤 버전의 PixiJS가 필요한가요?
@pixi/3d는 pixi.js 8.23.0 이상이 필요하며, app.init이 실행되기 전에 임포트해야 합니다.
Blender로 만든 모델을 불러올 수 있나요?
네. 모델을 glTF(.gltf 또는 .glb)로 내보내 Assets.load로 불러오고 Model3D로 표시하면 애니메이션까지 재생됩니다.
PixiJS 3D로 만든 게임은 어디서 할 수 있나요?
Nightward와 Mach 2는 공식 Good Stuff 사이트 goodstuff.pixijs.io에서 브라우저로 무료로 플레이할 수 있습니다.




