roblox-game-ux

Roblox 游戏 UX

UX 原则

• 让玩家在 10-30 秒内进入核心玩法。
• 通过实际操作进行教学，使用目标标记和情境提示，而不是大段说明。
• 首屏应专注于游玩，而非菜单或背景介绍。
• 奖励反馈要足够醒目，让玩家看得懂，同时也要足够简短，以保持游戏节奏。
• 优先针对手机屏幕设计，再扩展到桌面端和平板电脑。

移动端优先的控制

• 使用较大的触控区域，并留出充足间距。
• 除非整个游戏围绕精准拖动设计，否则应避免需要精准拖动的控制方式。
• 在适用时加入自动锁定目标、瞄准辅助、吸附或简化操作。
• 关键按钮应避开屏幕边缘和系统手势区域。
• 确保 HUD 文字在小屏幕上清晰易读，并让重要信息避开拇指频繁操作的区域。

HUD 和菜单

• 显示当前目标、货币、进度、生命值／能量和下一项奖励。
• 首次游玩期间，深层菜单应为可选内容。
• 使用清晰的图标，并保持按钮位置一致。
• 在游戏循环中让进度条和收集进度计数清晰可见。
• 避免弹窗打断核心玩法，尤其是在前五分钟内。

新手引导流程

首次游玩时，建议按以下顺序进行：

1. 生成角色时，让其面朝第一个可交互对象或目标。
2. 提示玩家进行一项操作。
3. 立即提供反馈和奖励。
4. 显示下一个简短目标。
5. 在玩家已经采取行动后，再展示社交或进度相关内容。

UX 审查输出

审查 Roblox UX 时，请报告：

• 首次操作所需时间。
• 开始游戏前的阻碍点。
• 移动端控制风险。
• 缺失的进度提示。
• 社交内容可见性不足之处。
• 变现造成的干扰。
• 按留存影响排序的优先修复项。

构建 UI 之前先设计

对于任何较复杂的 UI 界面，在 roblox-ui-implementation 开始构建前，先制作并获得批准的UI 设计文档。这是视觉规范，可避免 Claude 在构建过程中自行决定布局、状态和移动端行为。Roblox UI 在 Studio 中构建，因此该文档应为 Markdown 设计说明（可选附参考图片／截图），而非 HTML 原型。

在 design/features/<feature-slug>/design.md 下创建文档（全局规范位于 design/DESIGN.md；参见 docs/agents/design.md）。设计说明必须涵盖：

• 用户目标，以及对应的界面／流程（HUD、商店、奖励、菜单等）。
• 移动端、平板电脑和桌面端的布局与响应行为，包括安全区域和拇指操作区域。
• 所有相关状态：默认、空、加载中、错误和权限／锁定。
• 交互方式和文案规则。
• 一行 Status: 状态说明——用户批准前为 draft，批准后改为 approved。

与用户反复迭代，直到获得批准，然后将状态设为 Status: approved。在该设计文档获批前，UI 部分不得在 roblox-to-issues / roblox-triage 中标记为 ready-to-build。

后续步骤

设计说明获批后，将其交给 roblox-ui-implementation 进行构建。如果 UI 属于更大的功能，请使用 roblox-to-issues 拆分任务。使用 roblox-mobile-playtest 和 roblox-playtest-qa 验证构建结果。