我用 AI 复刻了 CodeTank,重温代码坦克
一个周末级的"考古 + 重制"项目:把童年记忆里的代码坦克,用现代浏览器技术和 AI 协作重新做了一遍。
一、初衷:想再玩一次"用代码打架"的游戏
很多年前的 CodeTank(代码坦克)是一种很特别的玩法:你不是用键盘操控坦克,而是写一段代码,让坦克在战场上自己判断、移动、瞄准、开火。两辆坦克放在同一个场地里,代码即战力。
这种玩法在今天看来依然不过时------它把编程变成了一场看得见的对抗:你写的每一个 if、每一次转向,都会实时反映在战场上。调试不再是盯着控制台,而是看自己的坦克怎么被打趴下。
原版 CodeTank 来自腾讯 AlloyTeam,源码并未公开。这次重制不是逐字节还原,而是:
- 玩法与 API 命名参照公开资料还原;
- 物理规则参照 Robocode 体系重新实现;
- 用现代浏览器技术重写,并补上当年没有的积木编程、联机、排行榜与云端存档。
整个项目由我和 WorkBuddy 协作完成。从架构设计、引擎实现到 UI 细节、文档与安全审计,大量工作是对话式推进的:我描述目标和约束,AI 给出实现与验证,我再逐轮实测、纠偏。这种模式很适合这种"想法明确、细节繁多"的复刻项目------既保留了原创判断,又把重复劳动压到最低。
二、游戏玩法:写代码,然后看它打
2.1 三步开打
- 左侧选一辆坦克,写
run()/onScannedRobot()等函数; - 点工具栏「选择坦克」,勾选至少两辆(可以从我的坦克、排行榜、其他用户坦克、系统机器人里挑);
- 选地图和模式,点「开始战斗」。
编辑器里写的代码会在开战时实时应用,不需要先保存。想验证一辆坦克的行为,可以点「▶ 测试运行」:只有它入场,不判胜负、不计分,能量耗尽自动补满,可以一直跑下去观察转向和开火逻辑。
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 协作帮了三个大忙:
- 架构一致性:引擎是浏览器 / 服务端 / 积木页共用的 UMD 模块,涉及多端同步的改动,由 AI 逐端检查引用和协议,避免"改一处漏三处";
- 回归验证:道具机制、积分实时化、编辑器持久化这些容易反复出问题的地方,都是先写模拟测试再改代码,Node + DOM stub 跑几十项断言,比手动点页面可靠得多;
- 文档与安全审计:功能改完后,文档数字和表述容易滞后;让 AI 按源码交叉校验,一次性找出了十几处过时描述和一个默认口令问题。
AI 不是替代判断,而是把"检查、同步、回归"这些容易漏的环节补上。真正决定做成什么样、怎么取舍的,还是人。
五、开源与地址
项目已开源,MIT 许可:
- Gitee :https://gitee.com/escms/codetank
- 在线演示 :https://codetank.escms.cn
- 积木乐园:在线地址进入后点顶部「积木乐园」
仓库只含网页版源码,不含任何云服务配置、密钥和私有数据;静态发布包由 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