68 lines
5.8 KiB
Markdown
68 lines
5.8 KiB
Markdown
---
|
||
title: "Roblox Avatar Creator Agent Personality"
|
||
type: source
|
||
tags: []
|
||
date: 2026-04-30
|
||
---
|
||
|
||
## Source File
|
||
- [[Agent/agency-agents/game-development/roblox-studio/roblox-avatar-creator.md]]
|
||
|
||
## Summary（用中文描述）
|
||
- 核心主题：Roblox UGC（用户生成内容）虚拟形象物品设计与发布全流程规范，包括配饰制作、分层服装、贴图标准、Avatar 系统集成和 Creator Marketplace 合规要求。
|
||
- 问题域：如何在 Roblox 平台内创建技术上正确、视觉上精致、平台合规的 Avatar 物品，并成功上架 Creator Marketplace。
|
||
- 方法/机制：通过严格的技术规范（三角面数限制、UV 规范、附件点命名）、Blender 骨骼绑定与 Cage 网格制作、HumanoidDescription API 驱动的游戏内换装系统，以及完整的提交审查流程。
|
||
- 结论/价值：提供了一套从建模 → 绑定 → 测试 → 发布的端到端 UGC Avatar 物品制作方法论，帮助创建者规避 moderation 拒绝，实现 Creator Marketplace 上架目标。
|
||
|
||
## Key Claims（用中文描述）
|
||
- UGC 配饰网格必须低于 4,000 三角面，超过则自动被平台拒绝。
|
||
- 所有网格必须是单一物体、单一 UV 通道，UV 范围限制在 [0,1] 空间内，禁止超出范围的重叠 UV。
|
||
- 分层服装（Layered Clothing）必须同时包含外层网格和内层变形 Cage 网格（_InnerCage），缺少内层 Cage 会导致服装穿透 Avatar 身体。
|
||
- 配饰通过 `Attachment` 对象附件至 Avatar，附件点名称必须与 Roblox 标准一致（如 HatAttachment、FaceFrontAttachment）。
|
||
- 贴图分辨率为 256×256 至 1024×1024，格式为 PNG（带透明通道的配饰需 RGBA），UV island 边缘至少 2px 内边距。
|
||
- 所有变换必须先应用（scale=1, rotation=0）再导出，导出格式：带绑定的配饰用 .fbx，不变形的简单配饰用 .obj。
|
||
- 物品提交后需通过 Roblox 自动 moderation 和人工审核（精选物品），审核周期通常 24-72 小时。
|
||
- 体验内 Avatar 自定义通过 `HumanoidDescription` API 实现，支持在不刷新角色的情况下动态应用换装。
|
||
- R15/Rthro 兼容性要求在 Classic、R15 Normal、R15 Rthro 等多种体型上测试配饰，防止穿插。
|
||
- UGC Limited 物品需要建立创作者账户记录，并设计符合二级市场价值的内容以吸引买家。
|
||
|
||
## Key Quotes
|
||
> "MANDATORY: All UGC accessory meshes must be under 4,000 triangles for hats/accessories — exceeding this causes auto-rejection" — Roblox UGC 技术红线
|
||
|
||
> "Layered Clothing requires both the outer mesh AND an inner cage mesh (_InnerCage) for deformation — missing inner cage causes clipping through body" — 分层服装变形核心要求
|
||
|
||
> "Looks great in Blender — now test it on Rthro Broad in a run cycle before submitting" — 沟通风格：强调跨体型实测
|
||
|
||
> "That logo will get flagged — use an original design instead" — 沟通风格： moderation 风险预判
|
||
|
||
## Key Concepts
|
||
- [[UGC (User-Generated Content)]]：Roblox 平台允许创作者自行设计虚拟形象物品并通过 Creator Marketplace 销售的内容生态。
|
||
- [[Layered Clothing]]：Roblox 分层服装系统，通过外层可见网格 + 内层变形 Cage 网格 + 外层堆叠 Cage 实现与其他分层物品的叠穿。
|
||
- [[R15 Avatar Rig]]：Roblox 第 15 代 Avatar 骨架系统，提供标准骨骼命名和体型预设，是所有配饰绑定的参考基准。
|
||
- [[HumanoidDescription]]：Roblox API，通过修改 Description 对象中的配件字段（如 HatAccessory、Shirt）并调用 ApplyDescription 实现换装。
|
||
- [[Creator Marketplace]]：Roblox UGC 物品的官方销售渠道，所有物品必须通过自动 moderation 和人工审核才能上架。
|
||
- [[Cage Mesh]]：分层服装中的变形网格，_InnerCage 定义服装包裹 Avatar 的形状，_OuterCage 允许其他分层物品堆叠在其上方。
|
||
- [[Rthro Avatar Scale]]：Roblox Rthro 体型系统，包含 Rthro Narrow 和 Rthro Broad 两种体型变体，需在配饰测试中覆盖。
|
||
- [[Blender R15 Rig]]：Roblox 官方提供的 Blender 参考骨架文件，用于正确命名骨骼和进行权重绘制。
|
||
|
||
## Key Entities
|
||
- [[RobloxAvatarCreator]]：本 agent 角色——Roblox UGC 虚拟形象流水线专家，精通从建模到 Creator Marketplace 提交的完整流程。
|
||
- [[Roblox Studio]]：Roblox 官方开发引擎，用于导入配饰、测试体型、预览动画穿插和管理 Creator Dashboard。
|
||
- [[Blender]]：第三方 DCC 工具，用于网格建模、UV 展开、骨骼绑定和 Cage 网格制作。
|
||
- [[Creator Dashboard]]：Roblox 创作者后台，用于提交 UGC 物品、管理 moderation 状态和发布内容。
|
||
- [[MarketplaceService]]：Roblox 服务端 API，通过 PromptPurchase 驱动游戏内购买 UGC 物品的流程。
|
||
|
||
## Connections
|
||
- [[Roblox Systems Scripter Agent Personality]] ← related_to ← [[Roblox Avatar Creator Agent Personality]]
|
||
- [[Roblox Experience Designer]] ← related_to ← [[Roblox Avatar Creator Agent Personality]]
|
||
- [[HumanoidDescription]] ← drives ← [[AvatarManager.lua]]（游戏内换装模块）
|
||
- [[Layered Clothing]] ← requires ← [[R15 Avatar Rig]]（骨骼绑定参考）
|
||
- [[Creator Marketplace]] ← requires ← [[UGC (User-Generated Content)]]（物品来源）
|
||
|
||
## Contradictions
|
||
- 与 [[Roblox Systems Scripter Agent Personality]] 的潜在重叠：
|
||
- 冲突点：Avatar 自定义系统同时涉及脚本编写和物品设计，职责边界可能模糊。
|
||
- 当前观点：Avatar Creator 专注物品层面的建模/绑定/提交，Systems Scripter 专注游戏内 Avatar 逻辑和 API 调用。
|
||
- 对方观点：Systems Scripter 可能认为游戏内换装逻辑属于自己的职责范围。
|
||
- 协调方案：物品层面的 HumanoidDescription 填充属于 Avatar Creator，DataStore 保存/加载和换装触发逻辑属于 Systems Scripter。
|