跳至主要内容

PixiJS 3D 入门指南:零基础做浏览器 3D 游戏,另附 2 款免费游戏

abe ·

PixiJS 3D 为 PixiJS 加入了完整的 3D 引擎,采用 MIT 许可免费使用。本文讲清 3D 场景由什么组成、怎样搭出第一个场景,以及两款用它做的免费网页游戏。

VENO 封面:PixiJS 3D 渲染的 3D 小岛场景,配标题“PixiJS 3D 网页 3D 入门”

PixiJS 3D 是 PixiJS 团队推出的全新免费 3D 引擎,它和你的 2D 精灵共用同一个舞台。它于 2026 年 11 月 12 日进入公开测试,优先使用 WebGPU,不支持时自动回退到 WebGL2,并采用 MIT 许可。只要会一点 JavaScript,今天就能在网页里放一个带光照和阴影的 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 实时渲染的 3D 小岛,有松树、红色小屋和池塘,图片:PixiJS

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 个带阴影的物体。

PixiJS 3D 示例中由 BatchedMesh3D 绘制的大量彩色小物体组成的巨大圆环,图片:PixiJS

3D 场景的 6 个基本组成部分

官方“3D 101”教程把 3D 拆成一层层叠起来的小概念。按下面的顺序学,再看其余文档就轻松多了。

  1. 空间。 2D 坐标有 x 和 y,3D 多了 z。在 PixiJS 3D 中,x 向右,y 向上,z 从屏幕指向你。注意 y 向上,和 PixiJS 2D 正好相反。0, 0, 0 是原点,1 个单位约等于 1 米,所以数值都比较小。
  2. 三角形。 所有形状都由三角形组成。一个点叫顶点,三个顶点组成一个三角形,立方体需要 12 个三角形,光滑的球大约要一千个。顶点和三角形的列表就是几何体:只有形状,没有颜色。
  3. 网格 = 几何体 + 材质。 材质决定物体是什么做的。两者合在一起就是网格,也就是你加到场景里的对象。PixiJS 3D 内置九种常用形状,包括立方体、球体、圆锥和圆环。
  4. 变换。 每个物体都有位置、旋转和缩放,现在都多了 z。旋转用弧度表示(Math.PI 是半圈),也可以用 angle 直接写角度。Container3D 可以把物体分组,转动父级时子级跟着转,做行星带卫星就是这么来的。
  5. 摄像机。 每个视图都有一个摄像机,初始位置在原点,所以第一步要把它往后移。视野 fov 默认是 60 度。OrbitCamera 让玩家拖动就能绕着目标旋转视角。
  6. 光照和阴影。 没有光,Material3D 会画成黑色。DirectionalLight 像太阳,PointLight 像灯泡,SpotLight 像手电筒。在平行光或聚光灯上设置 castShadow,网格就会投射和接收阴影;点光源不投射阴影。

PixiJS 3D 的九种内置 3D 形状,包括球体、圆环、圆锥、立方体和绳结,均使用黏土材质,图片:PixiJS

几行代码做出第一个场景

只需要两个包: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。金属主要反射周围环境,所以有环境可以反射时效果最好。

PixiJS 3D 中一排排从光滑到粗糙、从塑料到金属的球体,倒映着夕阳,图片:PixiJS

没人会用立方体拼角色。美术会在 Blender 等工具里导出 glTF(.gltf 或 .glb)模型,这是一种开放格式,可以包含网格、材质和动画。在 PixiJS 3D 中,用 Assets.load 加载文件,包进 Model3D,再用 autoPlay 播放文件自带的动画。模型保持制作时的尺寸,所以摆放前要先量一下再缩放。如果整个场景就是一个模型,View3D.from(source) 会直接建好带摄像机和灯光的视图。

除了这些基础功能,引擎还支持蒙皮、变形目标、压缩纹理,PBR、Phong、平面和卡通材质,以及 HDR、色调映射、后期处理、粒子和级联阴影。

两款用 PixiJS 3D 做的免费游戏

PixiJS 团队用这个引擎做了两款游戏,放在官方 Good Stuff 网站上,可以在浏览器里免费玩。

Nightward 是一款发生在月光墓地里的生存游戏。你只负责移动:六种武器会自动开火,敌群越来越多,直到墓穴中的 Grave Reaper 现身。像素风精灵以受光照的广告牌形式立在 3D 场景里并投下阴影,上面还叠加了泛光、移轴和雾效。更厉害的是,游戏的美术和音乐都由代码生成,完全不加载任何图片或音频文件。

Nightward 游戏画面:像素风主角在月光下的 3D 墓地中对抗越来越多的敌人,图片:PixiJS

Mach 2 是一款半管跑酷游戏。你绕着管道转向、跳跃,在五个区域里收集方块,奔跑时上方有 2D HUD。它可以在 WebGPU 或 WebGL2 上运行,支持键盘,也能在手机上玩。

给玩家的小技巧:

  1. 玩 Nightward 时要绕大圈持续移动;站着不动会让敌群围上来,而武器需要空间才能发挥。
  2. 玩 Mach 2 时要利用管道的整个弧面,先对准方块再起跳。
  3. 如果游戏卡顿,关掉其他占资源的标签页,并在浏览器设置里确认已开启硬件加速。

Mach 2:用 PixiJS 3D 制作的粉色半管跑酷游戏,运行在桌面浏览器中,图片:PixiJS

网页游戏开发者下一步该做什么

  • 从小处开始。 先跟着官方快速入门做,然后复制一个示例,每次只改一个数值。示例库里的每个示例都附带源码。
  • 试试教程。 有三个项目可以在在线编辑器里完成:漂浮的形状、模型展示厅和射击场,最后一个会一步步做出一个小游戏。
  • 读一个完整游戏。 示例中的赛车游戏展示了完整项目是怎么组织起来的。

PixiJS 3D 官方赛车示例:黄色小车在赛道上行驶,旁边有松树和橙色拱门,图片:PixiJS

  • 聪明地使用 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 是显示对象,你可以把 3D 场景放进 2D 舞台,在 3D 上面绘制 2D 界面,甚至把 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 上免费在浏览器中游玩。

相关文章

游戏加载中…

VENOGAME / PLAYBOOK

我的竞技场

保存在此设备,无需账号。

点击爱心,建立自己的游戏收藏。