跳到正文
11 道工序

联机放置游戏

村民分工采集加工、小队打怪、玩家市场——一张 HD-2D 大地图上看着他们干活

4/5 难度更新于 2026-11-16

IdleHD:freerush-framework 工作区里的一个联机放置游戏。村民分工砍树挖矿、烧煤炼锭,战斗者组小队打怪,金币只从炼金和打怪来、只用于玩家之间交易。规则写在一份 TypeScript core 里,服务器和客户端各跑一遍、逐位一致;服务器 Node 24 + SQLite、零第三方依赖。客户端是 Cocos Creator 3.8.8,大地图是程序化生成、离线烘焙的 HD-2D 场景。

指标

技能
9 个生活技能 + 战斗
砍树、挖矿、钓鱼、采集、制作、烹饪、锻造、炼药、炼金;手写 74 个动作,炼金按物品表另生成 77 个
人手
村民 5→10 · 战斗者 2→4
村中心升级加人;技能等级归村子,战斗等级与装备跟着每个战斗者走
离线收益
12 小时
从最后一次在线算起;超过就自动停,回来时一次结算
服务器依赖
0 个
Node 24 直接跑 TypeScript,SQLite 用 node:sqlite;镜像构建时跑完全部测试

工序

  1. 01 系统架构:一份规则两端跑四层各管什么;放置游戏为什么要「懒结算」;为什么结算必须两端逐位一致、种子为什么只在服务器;推送、市场、配表、资源的总体取舍。 ~8 min
  2. 02 工作区与源码:freerush 框架里的一个游戏freerush-framework 是什么、怎么组装游戏与引擎;idle-hd 仓库每个目录管什么;引擎分支怎么改;加东西时改哪里;提交前跑什么。 ~6 min
  3. 03 村民与经济:技能、时间线结算、炼金与市场九个生活技能、手写 74 个动作;村民是匿名劳动力、技能等级归村子;几个岗位按全局时间顺序合并结算、缺料时「等料」;经验曲线与速度加成;金币只从炼金和打怪来;限价单撮合与托管。 ~6 min
  4. 04 战斗:职业、克制、小队与副本战斗者与村民分开;七个职业对着同一个目标平衡;整数伤害公式与双向克制;小队怎么打、怪物每第三下群攻、倒下不复活;按目标反推的怪物;难度、单人副本;消耗品按劳动生成、按「几个村民」锚定消耗。 ~7 min
  5. 05 工坊与家园:装备、建筑与村中心六个部位、六个档位;打造出来一律白色带一条固有词条;强化有匠心保底、迁移、精炼升品质随机加词条;家园 12 座建筑最高 20 级、只花材料;村中心升级加村民和战斗者;外观每 5 级换模型、每级多一件摆设。 ~5 min
  6. 06 配表:CSV 唯一源与配表工具32 张表各管什么;构建时查什么;哪些表是生成的、用哪条命令生成;命令行与网页配表编辑器;改一张表的流程。 ~4 min
  7. 07 服务器与安全:零依赖、两种登录、长轮询Node 24 + node:sqlite + 零依赖;全部接口;网页 cookie 与原生设备码两条登录;Gitea 与独立身份服务两种提供方;会话、限流、Origin 校验与 CSP;长轮询推送;GM 指令、管理后台与全服看板。 ~7 min
  8. 08 客户端:Cocos 工程、页面与资源加载没装 Creator 也能检查的 Cocos 工程;界面布局、dock 与右侧状态栏;资源键与资源类型;图片包、Worker 拼时装、后台解码,加载不卡主线程;加载画面与字体;摸鱼小窗与画中画。 ~6 min
  9. 09 大地图:程序化布局、离线烘焙与斜看的镜头为什么烘焙式 2.5D 而不是实时 3D;按噪声地貌和路网生成街村;同一台相机、同一套像素化把 3D 场景烘成地面块与贴片;透视倾角、景深与调色;可走格子与 A* 寻路;工作点、村民走去干活、小队打溜达的怪;建筑阶段与摆设。 ~6 min
  10. 10 美术管线:美术工、模型工与 3D 纸娃娃源图与资源键的目录约定、导入时缩放与量化;需求方与美术工 / 模型工只靠文件协作、文件事件叫醒;角色从 3D 素体烘成像素图:动作库重定向、时装分层带深度;建筑走「原画 + 四视图 → Tripo」;手绘地面与植被;许可证。 ~6 min
  11. 11 打包与部署:同一个提交才上线build.json 两个目标;cnb 流水线由框架生成;版本号与更新公告;服务器镜像构建时跑测试;部署脚本只在网页包和镜像出自同一个提交时动手、先换服务器再切网页;全部资源走 CDN;上线后才发群通知。 ~4 min

这是一个真在做的游戏。玩家手下有一个村子:村民是匿名劳动力,派去砍树、挖矿、钓鱼、采集,再把原料烧成煤炭、炼成金属锭、做成料理和药水。每个动作都可以加人减人,几个岗位同时干,上下游互相供料。战斗者另算,各自选职业、组成小队打怪下副本,吃的是村民做出来的料理和药水。装备在工坊里打造、强化、精炼,家园建筑升级加速度和经验,村中心升级加人手。金币只用于玩家之间交易。

主界面是一张大地图。村民走到树旁边挥斧子,战斗者站在战斗区域前和溜达的怪物对打,主角可以在地图上跑来跑去。点建筑打开对应的页面,右侧状态栏随时看着每个村民和小队的血量。

方案一句话

规则只写一份,服务器算真账、客户端拿同一段代码做预测。 放置游戏的状态不是「每秒跑一帧攒出来」的,而是「从存档和时间算出来」的。服务器平时什么都不用跑,有人来问才结算;客户端在两次同步之间用同一个函数把进度条推着走。

flowchart LR
  subgraph game[idle-hd 仓库]
    core[packages/core<br/>结算·战斗·工坊·市场·GM]
    cl[packages/client-logic<br/>网络·预测·推送·寻路]
    vis[client/ Cocos 表现层<br/>大地图 + 页面 + 状态栏]
    srv[server/<br/>Node 24 · SQLite]
    cfg[config/tables/*.csv]
  end
  core --> srv
  core -->|拷贝| vis
  cl -->|拷贝| vis
  cfg --> srv
  srv -->|下发配表| vis
  eng[(框架引擎仓<br/>game/idlehd/v3.8.8)] --> vis
  srv <-->|OIDC| idp[身份服务]

在哪

要什么去哪
玩(网页版)游戏 · IdleHD → 开始游戏(/idle/)
管理后台、全服看板只有超级管理员看得到入口,权限由游戏服务器验
源码freerush-framework 工作区的 freerush/games/idle-hd(远端在 cnb),见 工作区与源码

这几章

章讲什么
01 系统架构四层分工、懒结算、为什么两端必须逐位一致
02 工作区与源码freerush 框架、仓库目录、引擎分支、提交前检查
03 村民与经济技能与动作、村民时间线结算、炼金、市场
04 战斗七个职业、整数伤害公式、克制、小队、副本、消耗锚点
05 工坊与家园装备打造 / 强化 / 精炼 / 词条,家园建筑与村中心
06 配表32 张 CSV、配表命令行、网页配表编辑器
07 服务器与安全接口、两种登录、长轮询、管理后台、GM
08 客户端Cocos 工程、页面与状态栏、资源与图片包、摸鱼小窗
09 大地图程序化布局、烘焙、透视镜头、寻路、工作点
10 美术管线美术工 / 模型工协作、3D 纸娃娃烘焙、建筑与时装
11 打包与部署build.json、cnb 流水线、同提交才上线、CDN

现在到哪了(2026-11-13)

  • 玩法:生产链、村民分工、炼金、小队战斗(含难度与单人副本)、工坊、家园与村中心升级、物品市场与装备寄售、时装商城都已上线。
  • 画面:大地图整张换成 HD-2D 烘焙图。斜看的透视镜头加景深,村民和战斗者都有 8 方向动作;12 座家园建筑每 5 级换一次模型,每升一级旁边多一件摆设。时装分部件自由搭配,主角可选男女。
  • 加载:网页版的全部资源走 CDN,图片按用途合包,时装在 Worker 里拼,进地图不卡主线程。
  • 还没做 / 没验证:职业技能(如治疗带复活)、多人副本、六只 Boss 的专属动作;真实玩家的料理消耗、金币产出与回收只有模拟数据。

这份文档怎么来的

2026-10-30 之前,这几章由 IdleHD 仓 docs/ 自动同步过来。IdleHD 迁进 freerush-framework 之后不再维护 docs/,说明只写在仓库自己的 README 里。现在这几章是对照 idle-hd 的代码、配表、README 和更新公告手动整理的,frontmatter 的 synced 记着最后对照的提交。各章写的是「现在是什么样、为什么这样做」;README 和代码对不上的地方,以代码为准。