我用 AI 复刻了 CodeTank,重温代码坦克

我用 AI 复刻了 CodeTank,重温代码坦克

一个周末级的"考古 + 重制"项目:把童年记忆里的代码坦克,用现代浏览器技术和 AI 协作重新做了一遍。

在线演示:https://codetank.escms.cn

开源仓库:https://gitee.com/escms/codetank


一、初衷:想再玩一次"用代码打架"的游戏

很多年前的 CodeTank(代码坦克)是一种很特别的玩法:你不是用键盘操控坦克,而是写一段代码,让坦克在战场上自己判断、移动、瞄准、开火。两辆坦克放在同一个场地里,代码即战力。

这种玩法在今天看来依然不过时------它把编程变成了一场看得见的对抗:你写的每一个 if、每一次转向,都会实时反映在战场上。调试不再是盯着控制台,而是看自己的坦克怎么被打趴下。

原版 CodeTank 来自腾讯 AlloyTeam,源码并未公开。这次重制不是逐字节还原,而是:

  • 玩法与 API 命名参照公开资料还原;
  • 物理规则参照 Robocode 体系重新实现;
  • 用现代浏览器技术重写,并补上当年没有的积木编程、联机、排行榜与云端存档。

整个项目由我和 WorkBuddy 协作完成。从架构设计、引擎实现到 UI 细节、文档与安全审计,大量工作是对话式推进的:我描述目标和约束,AI 给出实现与验证,我再逐轮实测、纠偏。这种模式很适合这种"想法明确、细节繁多"的复刻项目------既保留了原创判断,又把重复劳动压到最低。


二、游戏玩法:写代码,然后看它打

2.1 三步开打

  1. 左侧选一辆坦克,写 run() / onScannedRobot() 等函数;
  2. 点工具栏「选择坦克」,勾选至少两辆(可以从我的坦克、排行榜、其他用户坦克、系统机器人里挑);
  3. 选地图和模式,点「开始战斗」。

编辑器里写的代码会在开战时实时应用,不需要先保存。想验证一辆坦克的行为,可以点「▶ 测试运行」:只有它入场,不判胜负、不计分,能量耗尽自动补满,可以一直跑下去观察转向和开火逻辑。

2.2 API 设计的取舍

坦克能通过一组受控 API 感知世界、下达指令,例如:

javascript 复制代码
function run() {
  ahead(100);                 // 前进 100 像素
  turnGunRight(360);          // 炮管转一圈扫描
}

function onScannedRobot(e) {
  fire(e.distance < 150 ? 3 : 1);
}

感知包只给当前帧可见的信息:自身能量、坐标、朝向、雷达方位、敌人距离 / 方位 / 炮管偏差等。指令包也只支持移动、转向、开火、雷达控制这几类。这个边界既是游戏公平性的需要,也是沙箱隔离的基础。

2.3 四种模式与确定性引擎

  • 混战:所有选中坦克一起打;
  • 1v1 对决:两两单挑;
  • 红蓝对抗:按队伍总能量判胜;
  • 循环赛:最多 10 辆,两两各打一局,按总积分排名,全程锁定 1× 速度,方便看每局过程。

引擎是确定性帧仿真:相同地图、相同种子、相同代码,能得到完全相同的一局。浏览器和 Node 服务端共用同一个 engine.js,所以联机对局与本地对战的物理规则一致。速度只有 0.5× / 1× / 2× 三档,1× = 30 仿真帧/秒,按真实时间推进------120Hz 屏幕不会比 60Hz 快一倍。加上暂停、单步和逐帧回放,调试代码非常直观。

2.4 地图与道具

11 张地图,每局自动生成随机种子,障碍位置与道具刷新点随之变化。障碍会挡住坦克和炮弹,但不遮挡雷达------这是为了保证系统机器人的行为稳定。

场上会随机刷新 6 类道具:维修、护盾、加速、火力、减速、雷达。道具机制做过一次有意思的改造:如果代码里写了 onGetItem 事件,拾取时引擎不再"自动生效",而是发一张一次性道具券,由代码决定用不用、什么时候用。这样孩子可以写出"跳过减速陷阱"或"血少才用维修"的策略;一张券只产生一次效果,也不会出现无限加血。没写这个事件的老代码仍然保持"拾取即生效",向后兼容。


三、面向孩子:从积木开始,而不是从语法开始

成年人可以写 JS,但孩子第一次接触编程时,不应该被括号和分号挡在门外。所以项目里做了一个独立的「积木乐园」:

  • 26 块中文积木,分 6 类:开动、大炮、动脑、记数、变样、道具;
  • 8 个循序渐进的关卡,从"向前走"到"发现敌人再开火";
  • 积木程序可以编译成 JS,送到主站战场参战,和手写代码的坦克同场竞技。

积木不是玩具化阉割:它有事件、条件、循环、变量,还有安全预算防止死循环。道具积木的语义和 JS 版一致------必须放进「捡到道具」事件里才会生效,这样从积木过渡到代码时,概念不会断层。

这个设计的目标很明确:孩子先用积木理解"顺序、条件、循环、事件",再看编译出来的 JS,最后自己改代码。学习曲线是连续的,而不是从图形界面直接跳进语法沼泽。


四、工程实现:几个值得记的点

4.1 零依赖

前端是原生 HTML / CSS / JavaScript,服务端只用 Node 内置模块。node server/server.js 直接能跑,不需要 npm install。运行期数据库默认落在 SQLite(Node 低于 22 时自动降级为 JSON 存储)。

4.2 沙箱与代码安全

用户代码在 Worker 里执行,编译前会做词法审查,拒绝 Function()、eval()、网络 API、定时器等受限语法;Worker 内宿主能力被不可配置地屏蔽,通信带随机令牌校验。这里要说清楚:这是语言级隔离,不是形式化安全边界------如果要把不可信代码放到公网大规模运行,仍需要 SES、isolated-vm 或独立 origin iframe。

4.3 云端与可信排名

静态托管版默认走本地数据层;接入自定义云服务后,可以有账号、微信登录、云端存档和排行榜。但静态版本的对局存档会带 [demo] 标记,不计入 ELO / 胜场 / 积分------因为浏览器端算分天然不可信。想要真实排名,需要部署自带权威结算的 Node 服务端。这个取舍在 README 里写得很直白,不想给人"看起来有排名其实能刷"的错觉。

4.4 AI 协作的实际收益

这个项目能快速成型,AI 协作帮了三个大忙:

  1. 架构一致性:引擎是浏览器 / 服务端 / 积木页共用的 UMD 模块,涉及多端同步的改动,由 AI 逐端检查引用和协议,避免"改一处漏三处";
  2. 回归验证:道具机制、积分实时化、编辑器持久化这些容易反复出问题的地方,都是先写模拟测试再改代码,Node + DOM stub 跑几十项断言,比手动点页面可靠得多;
  3. 文档与安全审计:功能改完后,文档数字和表述容易滞后;让 AI 按源码交叉校验,一次性找出了十几处过时描述和一个默认口令问题。

AI 不是替代判断,而是把"检查、同步、回归"这些容易漏的环节补上。真正决定做成什么样、怎么取舍的,还是人。


五、开源与地址

项目已开源,MIT 许可:

仓库只含网页版源码,不含任何云服务配置、密钥和私有数据;静态发布包由 build-static.sh 生成,不入库。本地跑起来很简单:

bash 复制代码
# 静态演示
python -m http.server 8787
# 打开 http://localhost:8787

# 完整后端(联机 + 后台 + SQLite)
node server/server.js

注意不要用 file:// 直接双击 HTML:浏览器会禁用 Worker,玩家代码不会执行。


六、写在最后

复刻 CodeTank 的最大收获,不是把当年的游戏搬进了浏览器,而是验证了这种"代码即玩法"的设计依然有生命力:它既是编程练习,也是可以反复调优的对抗游戏。

如果你也想让孩子从"玩游戏"走向"写游戏",或者只是想重温一下当年盯着战场调代码的乐趣,欢迎试试。有想法也欢迎去 Gitee 提 Issue------尤其是积木课程和关卡设计,这块还有很大空间。


七、截图


标签:JavaScript / 前端 / 游戏开发 / 编程教育 / 开源 / AI 编程 / CodeTank / WorkBuddy

相关推荐
有趣的老凌8 分钟前
学习MarkDown笔记
前端
掘黄金的打工人24 分钟前
LangChain 少样本示例 和 动态示例选择
langchain·aigc·ai编程
掘金者阿豪25 分钟前
数据库选型到底应该看什么?从业务需求到技术架构的实践分析
前端·后端
徐小夕1 小时前
万字拆解:零向量库、无模型微调,SAG2 凭什么刷新多跳问答 SOTA
前端·vue.js·github
黑土豆2 小时前
用 drawink 给业务页面加一层画板:从网页批注到无限板书
前端·javascript·github
回家路上绕了弯2 小时前
做错一步不算什么,错了接着干才是事故
ai编程
狂师2 小时前
牛逼!谷歌亲自下场开源的AI自动化神器!
人工智能·开源·测试
恋猫de小郭2 小时前
Flutter 3.50.0 Release 的第一个崩溃,修好了,还没 hotfix
android·前端·flutter
Flynt3 小时前
不装SDK手写了一遍MCP:最新规范已经没有initialize握手了
agent·ai编程·mcp