Aura3D
TypeScript 3D引擎提供了整个堆栈。 Aura3D是一个带有自己渲染器的浏览器3D引擎，加上围绕它的工具链：类型和授权资产，照明外观，游戏套件和部署检查。它是为代理编写的浏览器3D构建的，手工编写它的人使用相同的API。当前版本已导入 CHANGELOG.md.
一个带有轨道控制的发光、阴影、框架产品，共10行：
import { camera, createAuraApp, interactions, looks, model, scene } from "@aura3d/engine";
import { assets } from "./aura-assets";
createAuraApp("#app", {
scene: scene()
.add(looks.preset("product-studio"))
.add(model(assets.product, { name: "product", targetHeight: 1.6, castShadow: true }))
.add(interactions.orbit({ target: "product" }))
.camera(camera.frameAsset(assets.product, { targetHeight: 1.6 })),
...looks.appOptions("product-studio")
});
一、 looks.preset 提供基于图像的光，阴影投射键，雾，背景和post grade作为一个单元。 model(assets.product) 是由CLI生成的类型化资产，而不是原始URL。js中的相同场景在轨道控制(口号检查;行计数包括导入和跳过（空白行和注释行）。
以五个命令开始
npx create-aura3d@latest my-scene --template mini-game # also writes llms.txt and the Aura3D agent skills
cd my-scene && npm install
npm run dev # Vite on 127.0.0.1
npx @aura3d/cli@latest assets resolve "robot" --name robot # assets add also works for local GLBs; then model(assets.robot)
npm run build && npx @aura3d/cli@latest check-deploy --dist dist
模板: product-viewer (默认), cinematic-scene， mini-game， racing-starter， falling-blocks-starter， fighting-game， character-controller， arena-shooter 还有更多(npx create-aura3d@latest --help）。
如果你是一个人工智能代理
读 llms.txt （一个屏幕，快速路径），然后 docs/agents/agent-quickstart.md 和 docs/agents/claims-and-boundaries.md． 每个代理文档的索引为 docs/agents/README.md;技能生活 packages/aura3d-cli/skills/. npx create-aura3d@latest 和 npx @aura3d/cli@latest init --agent all 将指令文件写入项目中。
你得到了什么
- 类型化场景API。
scene，model，looks，lights，camera，effects，interactions，primitives，instances和game.*通过一个入口，@aura3d/engine. - 输入的、经过出处检查的资产。
assets search，assets resolve，assets add，assets import-meshy，assets optimize，assets validate． 在生产环境中，模型需要同源URL、sha256和来源，否则它将不绘制任何内容。网格生成通过带有准入记录的CLI。 - 游戏装备。
@aura3d/engine/game（createGame（生命周期，暂停，结果，DOM HUD，触摸，果汁，声音），createFixedStepLoop，installQaHooks和种子重赛，createCueBank音频合成器,defineModelAssets，球拍运动和其他类型的工具包。 - 安全网。
installSafetyNet从@aura3d/debug：?diag=1面板，优质开关和黑框自愈。自定义着色器失败报告，而不是沉默。 - 检查。
aura3d doctor，aura3d check-deploy(添加--browser加载headless Chromium中的每个路由，并在失败的请求和控制台错误时失败)，路由健康和屏幕截图证据，look-dev循环(aura3d look capture，aura3d look lint）。 - 迁移。
aura3d migrate three是记录每个近似的代码模块。这不是一个临时索赔。
组件的文档: docs/api/game-kit.md， qa-kit.md， safety-net.md， audio-synth.md， model-loader.md， glsl-chunks.md， scatter-merge.md， cli-asset-tools.md， toon.md.
用它来建造
这个 展示指数 有25款可玩游戏，包括赛车，运动，动作，平台和街机，包括Aura Slam 3D（网球，带有确定性重播门），Apex Overdrive（赛车），Glint Courier（迷宫追逐）和Craterline GP（自行车赛车）。每页都说明了它的限制；游戏是独立作品，不隶属于任何其他游戏或工作室。游戏在WebGL2软件上进行远程检查；real-GPU确认是部分的，并在 evidence/.
为什么是Aura3D而不是three.js
js给你一个渲染器。Aura3D是一个完整的TypeScript 3D引擎和工具链，它有自己的渲染器，所以3 .js留给你的部分是内置的：
- 一个有灯光、阴影、框架的10行产品。 js中的相同场景在轨道控制(口号检查）. 在我们的5个场景基准测试中，带有HDR照明、阴影、绽放和轨道控制的PBR查看器是24行而不是49行，1个导入而不是8行(结果）。
- 你可以信任的资产。 每个模型都经过输入、散列和许可；在生产中，未经验证的模型无法绘制。
- 包括游戏堆栈。 HUD，触摸控制，音频提示，固定步长循环，种子回放，安全网和120和144hz显示器的平滑运动。
- 为AI编码代理构建。
llms.txt每个新项目都会附带14项技能和汇编的食谱。 - 在已发布的4.5.0包上进行测量。 一个立方体场景在420毫秒内到达第一帧，并在一次调用中绘制；一个带有阴影和花朵的PBR查看器场景绘制在25。五个基准测试场景没有记录控制台警告或错误，并且16个选项覆盖测试通过，因此一个选项要么生效，要么引发
OPTION_IGNORED． 软件WebGL2远程运行，一次运行，第一帧中位数为3个冷负载；非GPU编号(结果）。
移植一个已有的three.js项目： docs/migration/from-threejs.md.
包
公共包(都在同一个版本； @aura3d/engine 是这个存储库的根目录)：
| 包 | 目的 |
|---|---|
@aura3d/engine | 公共运行时: createAuraApp，场景节点，外观，效果，游戏套件，子路径等 /game 和 /audio |
@aura3d/cli | 类型资产工作流，跨开放公共资源的资产搜索，mesh准入，look-dev， check-deploy， init， migrate three |
create-aura3d | Vite项目脚手架与代理技能和 llms.txt |
@aura3d/core， @aura3d/math， @aura3d/scene | 生命周期和确定性步进，数学，场景图 |
@aura3d/rendering | 渲染设备，WebGL2后端，材料，通道 |
@aura3d/assets， @aura3d/asset-index | 资产加载和缓存；跨公共资源的资产搜索 |
@aura3d/animation， @aura3d/audio， @aura3d/input， @aura3d/controls | 剪辑和状态机，音频总线，输入，摄像机控制 |
@aura3d/physics， @aura3d/physics-rapier， @aura3d/navigation-recast | 物理，可选的剑和导航适配器 |
@aura3d/ecs， @aura3d/scripting | ECS和行为图 |
@aura3d/debug | 诊断和运行时安全网 |
@aura3d/product-studio， @aura3d/apps， @aura3d/workflows， @aura3d/react， @aura3d/editor-runtime | 产品查看器、应用预设、工作流、React主机、编辑器运行时 |
@aura3d/engine/production-runtime， /advanced-runtime， /rendering 和 /contracts 是弃用的子路径；新代码使用根目录。
索赔和核实
每一项公开声明 docs/agents/claims-and-boundaries.md：标明能力，并只要求经过判断的捕获或保留的证据显示的能力。发布的门包括路由运行状况、类型来源、公共api表面检查、包大小检查和 check-deploy． 发行说明见 CHANGELOG.md.
文档
docs/index.md：人类和代理的中心docs/agents/README.md：代理文档索引docs/api/public-api.md：公共APIdocs/aura3d-vs-threejs.md和docs/migration/from-threejs.md为什么Aura3D超过three.js，以及如何移植docs/workflows/game-conversion-playbook.md：将浏览器游戏转变为Aura3D游戏- 网站: https://aura3d.auraone.ai
贡献
使用提示、包版本、资源源和屏幕截图或路由运行状况输出打开问题。在这个单线程中，浏览器、剧作家套件和重型构建在远程运行器上运行。tools/remote-acr/run.sh)，而不是在笔记本电脑上。麻省理工学院授权。