这是一个真在做的游戏。玩家手下有一个村子:村民是匿名劳动力,派去砍树、挖矿、钓鱼、采集,再把原料烧成煤炭、炼成金属锭、做成料理和药水。每个动作都可以加人减人,几个岗位同时干,上下游互相供料。战斗者另算,各自选职业、组成小队打怪下副本,吃的是村民做出来的料理和药水。装备在工坊里打造、强化、精炼,家园建筑升级加速度和经验,村中心升级加人手。金币只用于玩家之间交易。
主界面是一张大地图。村民走到树旁边挥斧子,战斗者站在战斗区域前和溜达的怪物对打,主角可以在地图上跑来跑去。点建筑打开对应的页面,右侧状态栏随时看着每个村民和小队的血量。
方案一句话
规则只写一份,服务器算真账、客户端拿同一段代码做预测。 放置游戏的状态不是「每秒跑一帧攒出来」的,而是「从存档和时间算出来」的。服务器平时什么都不用跑,有人来问才结算;客户端在两次同步之间用同一个函数把进度条推着走。
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 和代码对不上的地方,以代码为准。