Skip to content

Latest commit

 

History

History
180 lines (123 loc) · 9.68 KB

CHALLENGE.md

File metadata and controls

180 lines (123 loc) · 9.68 KB

AI辅助可调参撤离游戏原型

Summary

  • Difficulty: medium
  • Time limit: none — take as long as you need
  • Submissions allowed: one (your first push is final)
  • Estimated effort: 10.0 hours
  • Language: Unity C#

Problem

Take-home Challenge:AI 辅助可调参微型游戏原型

背景

你将扮演 AI Builder 游戏策划师:在已有通用游戏工程基础上,使用 Unity 和 AI 编程工具快速落地一个可试玩、可调参、可复盘的小型游戏体验。

请制作一个 30-90 秒单局时长 的微型游戏原型,主题为:

“夺取核心并撤离”:玩家需要在一个小型关卡中收集目标物/资源,在风险逐步上升的情况下回到撤离点。玩家需要在“多拿一点资源”和“及时撤离”之间做决策。

你可以选择 2D 俯视角、横版或简化 3D,但必须保证核心体验清晰可玩。美术可以使用简单几何体、免费素材或 AI 生成素材,不以美术精度为主要评分项。


必须实现的游戏内容

1. 核心玩法循环

单局需要包含以下流程:

  1. 玩家从起点进入关卡;
  2. 玩家移动、躲避风险、收集至少一种资源或目标物;
  3. 随着时间推进,压力上升,例如敌人变快、视野变窄、陷阱增加、倒计时减少、警报等级提高等;
  4. 玩家选择继续冒险获得更高分,或返回撤离点完成结算;
  5. 游戏显示本局胜利/失败、得分、耗时和关键行为统计;
  6. 玩家可以一键重新开始下一局。

2. 数据驱动调参

核心数值必须从外部配置读取,推荐使用 StreamingAssets/tuning.json 或等价方案。评审应能在不改 C# 代码的情况下修改配置并观察体验变化。

配置至少应包含以下 4 类参数:

  • 玩家参数:移动速度、冲刺冷却、生命/容错次数等;
  • 关卡参数:资源数量、地图尺寸、障碍密度、撤离点位置规则等;
  • 风险参数:敌人数量、敌人速度、警报成长速度、陷阱伤害等;
  • 评分参数:基础分、连收奖励、撤离奖励、超时惩罚等;
  • 时间参数:局内倒计时、警报阶段时间、资源刷新节奏等。

你需要提供至少 3 套调参预设:

  • easy.json:新手可较高概率完成撤离;
  • normal.json:有适度压力,需要做风险收益决策;
  • hard.json:高风险,鼓励熟练玩家挑战高分。

游戏内或启动参数中需要能切换这些预设。

3. 试玩指标采集

每局游戏结束后,需要生成结构化日志文件,例如 telemetry/session_YYYYMMDD_HHMMSS.json 或 .csv。

至少记录:

  • 使用的调参预设;
  • 是否成功撤离;
  • 本局时长;
  • 最终得分;
  • 收集资源数量;
  • 受到伤害次数或失败原因;
  • 玩家死亡/撤离/超时位置;
  • 至少 5 个关键事件时间线,例如拾取资源、进入警报阶段、受到伤害、接近撤离点、游戏结束等。

同时提供一个简单的复盘界面或 summary.json,能展示最近若干局的聚合指标,例如平均得分、通关率、平均局长、常见失败原因。

4. 表达与设计说明

提交以下文档:

  • README.md:启动方式、操作方式、玩法目标、调参文件说明;
  • DESIGN_NOTES.md:不超过 800 字,说明你的核心设计假设、目标玩家体验、3 套调参预设的差异、你希望通过 telemetry 验证什么;
  • AI_WORKFLOW.md:说明你使用了哪些 AI 工具,例如 Claude Code、Cursor、Codex、Windsurf 等;哪些内容由 AI 协助生成;你如何检查、修改和收束 AI 输出。

输入与输出约定

输入

  • Unity 项目源码;
  • 至少 3 个 tuning 配置文件:easy.json、normal.json、hard.json;
  • 可选:命令行参数或游戏内菜单选择调参预设。

输出

  • 一个可运行游戏;
  • 每局结束生成 telemetry 文件;
  • 最近多局聚合 summary;
  • 设计和 AI 工作流说明文档。

运行要求

请使用 Unity 2022.3 LTS 或 Unity 2023 LTS。提交仓库根目录必须包含启动脚本:

./run.sh

run.sh 可以选择以下任一方式:

  1. 启动你提交的 WebGL/桌面构建;或
  2. 调用 Unity batchmode 构建后启动;或
  3. 在 README 中明确说明本机 Unity 路径变量,并由脚本打开指定场景。

评审执行 ./run.sh 后,应能看到可操作的游戏画面。若因平台限制无法自动启动 Unity,请确保 README 中有不超过 3 步的替代启动方式。


约束与澄清

  • 不要求联网,不允许依赖付费服务才能运行;
  • 可以使用免费素材、AI 生成素材或 Unity Primitive;
  • 不以画面精致度为核心评分,但反馈清晰度会影响评分;
  • 不需要复杂账号、后端或排行榜;
  • 请避免把范围做成大型 Roguelike、完整剧情游戏或复杂 ECS 框架;
  • 重点是:小而完整、可调、可测、可复盘。

Requirements

  • 提交一个 Unity C# 可运行项目,根目录包含 run.sh,评审能一条命令或 README 中不超过 3 步启动游戏。
  • 实现 30-90 秒单局闭环:开始、操作、收集/风险、撤离或失败、结算、重新开始。
  • 至少 4 类核心数值从外部配置读取,并提供 easy、normal、hard 三套可切换预设。
  • 每局结束生成结构化 telemetry,包含结果、耗时、得分、资源数量、失败原因/结束位置和关键事件时间线。
  • 提供最近多局聚合 summary 或游戏内复盘界面,用于观察通关率、平均分、平均时长和常见失败原因。
  • 提交 README.md、DESIGN_NOTES.md、AI_WORKFLOW.md,且设计说明聚焦,不超过 800 字。

Behavioural Test Cases

  1. 首次启动与基础可玩性
    • Input/context: 执行 ./run.sh,选择 normal 预设,使用键盘或鼠标进行一局游戏。
    • Expected behaviour: 评审运行启动命令后能进入游戏,看到明确目标和操作提示;玩家可以在 1 分钟左右完成一次收集并撤离,或因风险失败;结束后能重新开始。
  2. 调参预设影响体验
    • Input/context: 分别加载 easy.json 和 hard.json,各试玩 2 局,对比敌人速度、倒计时、资源数量或评分差异。
    • Expected behaviour: 切换 easy、normal、hard 后,游戏难度有可感知变化,例如 hard 中敌人更快、时间更紧或惩罚更高;这种变化来自配置文件,而不是改代码。
  3. Telemetry 正确记录关键行为
    • Input/context: 在 normal 预设中拾取 2 个资源后故意被敌人击败,查看 telemetry/ 目录中新生成的 session 文件。
    • Expected behaviour: 每局结束后生成新的日志文件,能看到本局预设、成功/失败、耗时、得分、收集数量、失败原因或撤离位置,以及按时间排序的关键事件。
  4. 聚合复盘能支持调参判断
    • Input/context: 使用 easy 玩 3 局、hard 玩 3 局,然后查看 summary 或游戏内统计面板。
    • Expected behaviour: 连续玩多局后,summary 或复盘界面能展示通关率、平均分、平均时长、常见失败原因等指标;这些指标能帮助判断某个预设是否过难或过易。
  5. 设计说明聚焦且可验证
    • Input/context: 阅读 DESIGN_NOTES.md 和 AI_WORKFLOW.md,检查是否能在 5 分钟内理解设计意图和 AI 协作方式。
    • Expected behaviour: 文档能清楚说明目标体验、核心风险收益决策、三套预设差异,以及计划用哪些指标判断调参是否成功;不会大量发散到无关技术细节。

Bonus Points

  • 加入一个简单的 AI 关卡生成/验证流程:根据 level_seed 和目标通关率自动生成障碍/资源布局,并在 README 中说明你如何用 AI 工具迭代提示词与筛选结果。
  • 提供 2-3 个可切换玩家画像预设,例如新手、熟练玩家、冒险型玩家,并解释不同调参如何服务不同画像。
  • 实现回放或热力图:可视化玩家死亡点、停留区域、资源获取路径,帮助策划复盘。
  • 加入最小化的自动化模拟器/机器人玩家,用于批量跑 20 局并估算调参对通关率、平均得分、死亡率的影响。

Evaluation Rubric

评分重点:

  1. 可玩循环完整度,30%:游戏必须有清晰目标、即时反馈、失败/成功条件、重复游玩的动力;核心循环应在 30-90 秒内闭环,不只是技术 Demo。
  2. 数据驱动调参,25%:关键数值必须外置到配置文件或可视化调参面板中,且能在不改代码的情况下改变体验;至少包含速度、时间限制、奖励、敌人/障碍强度、关卡资源分布等维度中的 4 类。
  3. 试玩指标与复盘能力,20%:必须记录结构化 telemetry,并生成可读的本局总结;指标应能回答“玩家为什么失败/成功、哪里卡住、调参是否有效”。
  4. AI Builder 工作流质量,10%:提交 AI_WORKFLOW.md,说明使用了哪些 AI 工具、让 AI 完成了哪些模块、人工如何验收与收敛范围;重点看能否指挥 AI 交付完整体验,而不是堆功能。
  5. 工程可运行性与交付质量,10%:一条命令可启动,目录清晰,无缺失资源;代码结构足以让他人继续调参和扩展。
  6. 表达收束,5%:README 和设计说明简洁,能在 5 分钟内让评审理解玩法目标、调参假设、试玩指标和下一步迭代。

Submission

You may submit only once. There is no time limit — take as long as you need. When your work is complete, push it to this repository. Your first push is treated as your final submission: it is evaluated immediately and your access to this repository is then revoked, so make sure everything is ready before you push.

Include setup and run instructions in your changes.