Note
当前代码仍在积极迭代更新，可能仍存在一些尚未解决的Bug与待优化的性能项，如果您发现游戏中与原版不一致的情况，欢迎在issue中提出问题
一个完全开放的 Terraria 1.4.5.8 ，历经70天，总消耗1238亿Tokens，其中GLM-5.3贡献477亿，GLM-5.3-Flash贡献761亿，使用Claude Code作为Vibe Coding工具。
未基于任何游戏引擎，完全基于Web平台原生实现，采用 Canvas 2D + WebGL2 混合渲染管线，部分模块采用Web Worker并行化处理或编译为WebAssembly以提升性能，当前最高帧率上限可支持120fps。
支持移植mod、材质包、原版世界/角色存档导入导出。
人类不写代码只发指令，我发送了7827条指令，会话数达到124个，使用1484个子代理
Agent侧产生了112338条消息，工具调用数量达36815次
150 万行 TypeScript（引擎 47 万手写 + 数据定义 2 万 + 测试 45 万 + 探针工具 46 万 + mod 参考实现 5.5 万），2600+ 测试用例，全部开发过程有逐日开发日志（docs/devlog/DAILY_DEVLOG.md）存档。这个仓库本身，就是这场人机协作实验的完整记录。
多人模式服务端仍在开发中，后续可能支持大型公共房间。
建议使用 Google Chrome 浏览器访问，以获得最佳游戏性能，如使用国内网络首次访问可能遇到网络延迟，请多加等待。
如多次刷新无法访问，可尝试强制刷新以刷新Service Worker缓存状态。
同时支持导入原版*.wld格式存档和*.plr格式角色
npm install
npm run dev # http://localhost:5199
npm test # vitest 全量(2600+ 用例)
npm run build # 产物 dist/本项目的全部开发均由 AI Agent 完成协作迭代。如果你想让 AI Agent（Claude Code / Codex / Cursor 等） 参与本项目的开发，它可以通过 AGENTS.md 快速上手——其中包含：项目真值层级（反编译源码 → 数据表 → wiki）、 测试三层结构与金标闸门纪律、诊断探针方法（F5 调试报告 / 性能 trace 拆解）、迭代方法论（先定谳再动刀 / 红蓝对抗）， 以及仓内 70 天逐日开发日志等全部判例档案的路由表。AI Agent 无需任何会话记忆，即可按本项目已验证的工作流进行工程迭代。
→ 完整指南:docs/mod-dev-guide.md
由于跨语言与平台的原因，无法支持tmod载入，建议通过AI精准转译到swmod（目前我们正在尝试全量转译灾厄mod）
10 分钟从零做出第一个 mod(脚手架/L1 声明式内容 16 域/L2 脚本 API 总表/ 浏览器独有六接口/实战示例/发布):
node scripts/mod-cli.mjs init mods/my_mod --ts # TypeScript 入口(缺省=JavaScript)
node scripts/mod-cli.mjs validate mods/my_mod # 校验
node scripts/mod-cli.mjs build mods/my_mod # → mods/dist/my_mod.swmod- 接口类型签名(IDE):templates/mod-api.d.ts
- Boss mod 工作流:docs/howto-boss-mod.md
- 城镇 NPC mod 工作流:docs/howto-town-npc-mod.md
- 平台设计定谳:docs/mod-loader-design.md
| 域 | 文档 |
|---|---|
| Mod 开发(入口) | docs/mod-dev-guide.md |
| 迭代方法论 | docs/methodology/campaign-playbook.md |
| 架构定谳史 | docs/(按域归档;战役实录见各 recon/wave 文档) |
工程代码以 MIT 授权;仓库内的游戏资产(贴图/音效/BGM)与 反编译数据表属 © Re-Logic,不在 MIT 范围内,仅供个人学习与研究—— 边界详见 ASSETS.md。
TypeScript · Canvas 2D · WebGL2 · Vite · vitest · Web Assembly · Web Worker