threejs-aaa-graphics-builder

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Three.js AAA Graphics Builder

Three.js AAA级图形构建工具

Purpose

目标

Own the production graphics pass. Convert basic screenshots into authored, high-density, performance-aware visual experiences.

负责生产级图形优化流程。将基础截图转换为精心制作、高密度且兼顾性能的视觉体验。

Use When

适用场景

Screenshots still look basic, models look primitive, worlds are sparse, UI/world art feels generic, or the user asks for premium, AAA, high-fidelity, showcase, or less-basic graphics.

当截图仍显基础、模型粗糙、场景空旷、UI/场景美术缺乏特色，或者用户要求高端、AAA级、高保真、展示级或更优质的图形效果时使用。

Required References

必备参考资料

These references are required phase-entry gates, not optional reading:

Load
```
references/visual-scorecard.md
```
before scoring, judging completion, or making any premium/AAA/showcase claim.
Load
```
references/implementation-blueprint.md
```
before changing graphics architecture, materials, VFX, rendering, diagnostics, or broad visual systems.
Load
```
references/model-recipes.md
```
before building or upgrading hero/player, obstacle, enemy, pickup, world-kit, material, or prop models.
Load
```
references/render-recipes.md
```
before changing lighting, tone mapping, shadows, fog, post-processing, materials, or render composition.
Load
```
references/technical-art.md
```
before premium/AAA/showcase graphics work, shaders/material systems, VFX systems, generated/imported asset cleanup, LOD/instancing work, or visual changes that could affect browser performance.
Load
```
references/shader-cookbook.md
```
before writing any custom shader,
```
onBeforeCompile
```
injection, material recipe, sky, or post-processing chain — use its proven values and GLSL patterns instead of improvising.
Load
```
references/checklists/aaa-game-quality-gate.md
```
and
```
references/checklists/aaa-visual-scorecard.md
```
before declaring a game premium, AAA, showcase, complete, release-ready, or less basic.

Load the relevant checklist before focused work:

references/checklists/procedural-model-quality.md

references/checklists/material-lighting-quality.md

references/checklists/performance-safe-visual-detail.md

, or

references/checklists/technical-art-quality.md

Load
```
references/prompt-templates.md
```
only when the user asks for reusable prompts, a graphics-pass prompt, or a task template.

For broad "still looks basic", premium, AAA, high-fidelity, showcase, or less-basic graphics work, load all five references as the first action in the phase. Track them in a reference ledger with yes/no, path, and failure reason. Do not mark the graphics phase complete while any required reference is skipped.

External asset sourcing gate:

For premium/AAA/showcase/high-fidelity/less-basic graphics with a hero/player, character, creature, boss, vehicle, ship, building, weapon, signature prop, complex pickup, or hero environment piece, load
```
threejs-3d-generator
```
before deciding procedural geometry is enough.
For premium/AAA/showcase/high-fidelity/less-basic graphics with concept needs, texture/material references, decals, logos, faction marks, icons, GUI art, skies, backgrounds, title/menu art, or image-to-3D inputs, load
```
threejs-image-generator
```
before deciding 2D external assets are not needed.
Run the director credential probe before using
```
key unavailable
```
as a skip reason and paste the SET/MISSING output.
Create an asset sourcing ledger for each high-value surface: procedural / threejs-image-generator / threejs-3d-generator / hybrid, plus outputs or skip reason.
```
not-needed
```
is valid only after the relevant skill was loaded and the ledger explains why external generation would not improve a non-hero support surface, or why the credential probe or attempted generation shows a real blocker.
For premium hero surfaces, procedural-only is not an allowed final answer unless there is real blocker evidence. At least one high-value surface must show a 3D generator task ID, downloaded GLB/GLTF/FBX path, image generator output path, or documented hybrid chain.

这些参考资料是进入该阶段的必备条件，而非可选阅读内容：

在进行评分、判定完成情况或提出任何高端/AAA级/展示级效果声明之前，加载
```
references/visual-scorecard.md
```
。
在更改图形架构、材质、VFX、渲染、诊断或广泛视觉系统之前，加载
```
references/implementation-blueprint.md
```
。
在构建或升级主角/玩家、障碍物、敌人、拾取物、场景套件、材质或道具模型之前，加载
```
references/model-recipes.md
```
。
在更改光照、色调映射、阴影、雾效、后期处理、材质或渲染合成之前，加载
```
references/render-recipes.md
```
。
在开展高端/AAA级/展示级图形工作、着色器/材质系统、VFX系统、生成/导入资源清理、LOD/实例化工作，或可能影响浏览器性能的视觉更改之前，加载
```
references/technical-art.md
```
。
在编写任何自定义着色器、
```
onBeforeCompile
```
注入、材质配方、天空或后期处理链之前，加载
```
references/shader-cookbook.md
```
——使用其中经过验证的值和GLSL模式，而非自行摸索。
在宣称游戏达到高端、AAA级、展示级、完成、可发布或更优质标准之前，加载
```
references/checklists/aaa-game-quality-gate.md
```
和
```
references/checklists/aaa-visual-scorecard.md
```
。

在开展针对性工作之前，加载相关检查清单：

references/checklists/procedural-model-quality.md

、

references/checklists/material-lighting-quality.md

、

references/checklists/performance-safe-visual-detail.md

或

references/checklists/technical-art-quality.md

。

仅当用户要求可复用提示词、图形优化流程提示词或任务模板时，才加载
```
references/prompt-templates.md
```
。

对于广泛的“仍显基础”、高端、AAA级、高保真、展示级或更优质图形工作，需在阶段的第一步加载全部五份参考资料。在参考资料台账中记录是否加载、路径以及失败原因。若有任何必备参考资料未加载，不得标记图形优化阶段完成。

外部资源采购要求：

对于包含主角/玩家、角色、生物、BOSS、载具、飞船、建筑、武器、标志性道具、复杂拾取物或主角场景元素的高端/AAA级/展示级/高保真/更优质图形，在判定程序化几何足够之前，需加载
```
threejs-3d-generator
```
。
对于有概念需求、纹理/材质参考、贴花、标志、阵营标识、图标、GUI美术、天空、背景、标题/菜单美术或图像转3D输入的高端/AAA级/展示级/高保真/更优质图形，在判定无需2D外部资源之前，需加载
```
threejs-image-generator
```
。
在使用“密钥不可用”作为跳过理由之前，运行凭证探测并粘贴SET/MISSING输出结果。
为每个高价值元素创建资源采购台账：程序化/threejs-image-generator/threejs-3d-generator/混合模式，以及输出结果或跳过理由。
仅在加载相关技能且台账解释了为何外部生成无法提升非主角辅助元素效果，或为何凭证探测或尝试生成显示存在实际障碍时，“无需”才是有效的理由。
对于高端主角元素，仅程序化生成并非允许的最终方案，除非有实际障碍的证据。至少一个高价值元素必须展示3D生成器任务ID、下载的GLB/GLTF/FBX路径、图像生成器输出路径或有文档记录的混合流程。

Workflow

工作流程

Capture or inspect active desktop/mobile screenshots.
Score visuals across art direction, hero/player, obstacles, rewards, world, materials, render, VFX, UI, and performance evidence.
Add missing graphics architecture: material library, procedural textures/decals, model factories, world prop kit, technical-art budget, VFX system, render pipeline, diagnostics.
Run the credential probe, then fill the external asset sourcing ledger per surface: procedural Three.js factory,
```
threejs-image-generator
```
2D reference/texture,
```
threejs-3d-generator
```
3D generation, or a hybrid.
Upgrade every weak visible surface, not only one hero object.
Add lighting/render/material polish after authored forms exist.
Add event-driven VFX tied to gameplay state.
Re-score screenshots against the calibration anchors, citing the inspector's measured metrics. Continue until every premium category is at least 2/3 or report exact blockers.
Run the fresh-eyes review per
```
references/visual-scorecard.md
```
before finalizing premium/AAA/showcase claims.
Verify renderer diagnostics against the render budget table, technical-art budget, desktop/mobile screenshots, console/page errors, canvas pixels, imported asset budgets, and playability.

捕获或检查当前桌面/移动端截图。
从艺术指导、主角/玩家、障碍物、奖励、场景、材质、渲染、VFX、UI以及性能证据等维度对视觉效果进行评分。
添加缺失的图形架构：材质库、程序化纹理/贴花、模型工厂、场景道具套件、技术美术预算、VFX系统、渲染管线、诊断工具。
运行凭证探测，然后为每个元素填写外部资源采购台账：程序化Three.js工厂、
```
threejs-image-generator
```
2D参考/纹理、
```
threejs-3d-generator
```
3D生成，或混合模式。
升级所有视觉效果薄弱的元素，而非仅升级一个主角对象。
在完成元素制作后，添加光照/渲染/材质优化。
添加与游戏玩法状态绑定的事件驱动型VFX。
对照校准基准重新对截图进行评分，并引用检查器测量的指标。持续优化直到所有高端类别至少达到2/3的评分，或报告具体障碍。
在最终确定高端/AAA级/展示级效果声明之前，按照
```
references/visual-scorecard.md
```
进行新视角评审。
对照渲染预算表、技术美术预算、桌面/移动端截图、控制台/页面错误、画布像素、导入资源预算以及可玩性，验证渲染器诊断结果。

Core Rule

核心规则

Do not make primitives look AAA by adding glow. First build authored forms, then materials, then lighting, then effects.

不要通过添加光晕让基础模型看起来像AAA级效果。先制作元素形态，再处理材质，然后设置光照，最后添加特效。

Final Response

最终输出

Report the reference ledger, credential probe output, external asset sourcing ledger, technical art brief, score before/after, production surfaces upgraded, files changed, screenshots/artifacts, renderer diagnostics, imported asset diagnostics when relevant, VFX readability and render-budget tradeoffs, and remaining blockers. For premium/AAA/showcase claims, include the filled visual scorecard exactly as defined in

references/visual-scorecard.md

, including average and automatic failures remaining.

报告参考资料台账、凭证探测输出结果、外部资源采购台账、技术美术简报、优化前后评分、已升级的生产元素、已更改文件、截图/工件、渲染器诊断结果、相关的导入资源诊断结果、VFX可读性与渲染预算的权衡，以及剩余障碍。对于高端/AAA级/展示级效果声明，需包含按照

references/visual-scorecard.md

定义填写完整的视觉评分卡，包括平均分和剩余的自动失败项。