跳至主要內容

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

我的競技場

儲存在此裝置,無需帳號。

點擊愛心,建立自己的遊戲收藏。