Auto-sync: 2026-04-26 12:02

wiki/sources/roblox-avatar-creator.md

@@ -0,0 +1,58 @@
+---
+title: "Roblox Avatar Creator Agent Personality"
+type: source
+tags: []
+date: 2026-04-26
+---
+
+## Source File
+- [[Agent/agency-agents/game-development/roblox-studio/roblox-avatar-creator.md]]
+
+## Summary（用中文描述）
+- 核心主题：Roblox UGC（用户生成内容）化身系统专家 AI Agent 人格规范——从建模绑定到 Creator Marketplace 提交的完整 avatar pipeline
+- 问题域：Roblox avatar 配件系统、Layered Clothing 分层服装、Creator Marketplace 合规审核、化身自定义 API
+- 方法/机制：R15 骨骼权重系统；附件点（Attachment）定位；纹理规范（256-1024px PNG）；三角面数硬限制（配件≤4000、Bundle部件≤10000）；InnerCage/OuterCage 双笼系统
+- 结论/价值：提供可直接使用的 Luau 代码模块（HumanoidDescription、Layered Clothing cage setup、UGC Shop UI flow）和 Creator Marketplace 提交检查清单
+
+## Key Claims（用中文描述）
+- UGC 配件网格必须低于 4,000 三角面——超过此限制将导致自动拒绝（Roblox 强制规则）
+- 所有 UGC 配件必须使用单个 UV 通道，UV 范围严格限制在 [0,1] 空间内——超出该范围将导致贴图采样错误
+- Layered Clothing 配件必须同时包含外层网格和 InnerCage 网格——缺失 InnerCage 将导致服装穿透过角色身体
+- 化身附件必须使用标准命名：HatAttachment、FaceFrontAttachment、LeftShoulderAttachment 等——命名错误导致跨 body type 附件失效
+- Creator Marketplace 商品名称必须准确描述商品——误导性名称将触发审核暂停
+
+## Key Quotes
+> "4,000 triangles is the hard limit — model to 3,800 to leave room for exporter overhead" — Roblox 网格三角面数规范：留 200 面余量防止导出器开销
+> "Looks great in Blender — now test it on Rthro Broad in a run cycle before submitting" — 测试原则：必须覆盖所有 5 种 body type 动画循环
+> "That logo will get flagged — use an original design instead" — 纹理内容规范：禁止任何商标或真实世界品牌
+> "Similar hats sell for 75 Robux — pricing at 150 without a strong brand will slow sales" — Creator Marketplace 定价策略：参考同类商品定价
+
+## Key Concepts
+- [[UGC]]: User Generated Content，Roblox 平台允许创作者发布和销售虚拟物品的经济系统
+- [[LayeredClothing]]: Roblox 分层服装系统，需要 Outer Mesh + InnerCage + OuterCage 三层 cage 网格实现变形
+- [[HumanoidDescription]]: Roblox 化身 API，通过 description.Apply() 方法应用全身装扮，支持 Shirt/Pants/Accessory 等属性
+- [[R15Rig]]: Roblox R15 avatar 骨骼系统，Layered Clothing 权重绑定到标准 R15 骨骼
+- [[CreatorMarketplace]]: Roblox 官方 UGC 交易平台，所有 UGC 商品需通过 Creator Dashboard 提交并通过自动化+人工审核
+- [[AttachmentPoint]]: Roblox 化身附件定位点，名称必须匹配 Roblox 标准（HatAttachment/FaceFrontAttachment 等）
+- [[RthroBodyType]]: Roblox 瘦长型化身比例，与 Classic/R15 Normal 不同——需单独测试附件兼容性
+
+## Key Entities
+- [[Blender]]: 3D 建模软件，用于制作 UGC 配件网格和 cage 网格
+- [[RobloxStudio]]: Roblox 官方开发工具，通过 Avatar → Import Accessory 导入 UGC 物品
+- [[R15TestBodies]]: Roblox Studio 提供的 5 种测试化身预设：Young / Classic / Normal / Rthro Narrow / Rthro Broad
+- [[DataStore]]: Roblox 服务器端持久化系统，用于存储玩家装扮数据
+
+## Connections
+- [[RobloxSystemsScripter]] ← game-dev-scope ← [[RobloxAvatarCreator]]
+- [[RobloxExperienceDesigner]] ← player-economy ← [[RobloxAvatarCreator]]
+- [[Blender]] ← mesh-pipeline ← [[RobloxAvatarCreator]]
+- [[RobloxStudio]] ← asset-pipeline ← [[RobloxAvatarCreator]]
+- [[CreatorMarketplace]] ← submission ← [[RobloxAvatarCreator]]
+- [[R15Rig]] ← bone-weights ← [[RobloxAvatarCreator]]
+
+## Contradictions
+- 与 [[UnityArchitect]] / [[UnityMultiplayerEngineer]] 冲突：
+  - 冲突点：角色自定义系统的实现路径差异
+  - 当前观点（Roblox）：使用 HumanoidDescription API 实现服务端权威的化身自定义，数据通过 DataStore 持久化
+  - 对方观点（Unity）：推荐客户端预测式角色定制，使用 LocalPlayer 状态缓存提升响应体验
+  - 说明：此差异由平台架构约束决定——Roblox 的 LocalScript 不可写 DataStore，Unity 无此限制，均为各自平台最优解