Jianghu · 作品总览
Jianghu · 作品总览
武侠挂机 · 整体Design Docs —— 一篇看懂整个作品
2026-10-09 · 依据 server/ 各模块实现整理(后端权威,数值以后端代码为准)
一、这是一款什么作品
放置挂机 + 山门经营 + 队伍养成的武侠题材作品。玩家是掌门:
- 挂机线:门人在「Jianghu游历」大地图的 71 个关卡里自动战斗,打怪 → 拿经验 / 金币 / 装备 / 材料 / 功法,一路往深处推进。
- 经营线:回到 3D 山门(六边形山峰),建筑开局已全部建好,靠Upgrade buildings等级提升产能与名额,招门人、养门人,扩声望。
- 养成线:人物属性 + 装备 8 槽 + 功法 7 格 + 技能招式,三层养成叠加出战力。
核心原则:后端权威 —— 所有状态存服务器(server/worlds/<userId>/),前端只负责展示;掉落、升级、结算全部在后端算,刷新页面不丢进度。
二、核心循环
Idle progression71 关自动战斗 打怪结算经验金币
→
Loot to storage装备 / 材料 / 功法 后端 roll · 入仓库
→
Grow stronger穿装备 · 学功法 人物升级
→
Recruit and expand大殿刷候选 厢房招新门人
→
Upgrade buildings三材升级 1→5 级 产能 / 名额提升
↺
推动循环的两大引擎:关卡推进(解锁更强的怪与掉落档位、解锁招募资质档)与声望积累(决定建筑能升到几级 —— 关卡进度是同一把尺子)。
三、系统地图
🗺️ Jianghu游历(挂机主玩法)
- 12 regions × 71 stages:青石村 → 落霞镇 → 黑风岭 → 雁回关 → 苍梧山 → 碧云涧 → 赤沙泽 → 铁佛寺 → 落星谷 → 孤云城 → 玄冰崖 → 黄泉道
- 每关刷小怪,杀满后可挑战 Boss;Boss 败则本关 Boss 记为已败,可进下一关
- 区域最后一关是关底头目:必掉 4 件装备、必出金以上品质
- 自动进关 / 团灭锁(bossLocked)防卡死
详见 敌人图鉴与关卡生态设计
🏯 山门建筑(3D 经营)
- 六边形山峰 20×20 格,8 类建筑开局即全部就位(1 级),不再需要点选建造
- 建筑:大殿(招募)/ 武器铺(加工)/ 仓库(囤积)+ 四种资源田 + 厢房
- 每类建筑可升 1 → 5 级:田产 10 → 18 / 周期、仓顶 100 → 180、厢房名额 1 → 21 人(每级 +5)
- 能升到几级由关卡进度(声望)决定:0 / 260 / 980 / 2350 / 4800 → 1 / 2 / 3 / 4 / 5 级
详见 建筑与等级声望系统设计
🧑🤝🧑 门人(人物养成)
- 18 职业 × 男女,6 种定位(近战/敏捷/坦/控/远程/辅助)
- 资质 8 档(甲→辛)决定属性点池;招募价辛 120 金 → 甲 10 万金(2026-10-15 高档位下调)
- 等级上限 99,经验来自挂机战果平分
- 口粮:每人每天 50 粮(作品天 = 真实 24 分钟)
详见 人物养成厢房系统设计
⚔️ 装备(8 槽收集养成)
- 槽位:武器 / 头 / 衣 / 裤 / 鞋 / 双戒 / 项链
- 品质白→绿→蓝→金→传奇;掉落有词条 / 套装 / 传奇威能
- 加工(+1~+10)· 鉴定 · 铭刻 · 萃取 · 销毁回收
- 仓库容量 300 件
详见 装备强化与加工装备系统设计
📜 功法(7 格战斗技能)
- 三系:内功 2 格 + 外功 2 格 + 武器功法 3 格
- 总量 240 条:18 职业 × 12 式 + 内外功各 12 册
- 五品阶:凡品 ×1.00 → 传奇 ×3.20;升级上限 12 级 ×2.32
- 小怪掉凡品、精英到良品、Boss 出蓝以上、金/传奇 Boss 专属
详见 功法收集与升级功法系统设计
💰 资源与经济
- 顶栏 5 种:铁 / 石 / 木 / 粮(田产)+ 金币(战斗掉)
- 仓库材料 4 种:纸 / 玄铁 / 玄晶碎片 / 灵玉(只从战斗掉落)
- 用途:加工 / 鉴定 / 铭刻 / 招募 / 口粮
详见 建筑与等级
四、声望:成长的总闸门
总声望 = 历练声望(每关 10 + 5×区域序号,全通 2635)+ 门派声望(每名门人保底 20 + 每级 4)。声望到档永久生效(不是消耗品)。
2026-10-10 改制后,声望只决定一件事:建筑能升到几级。
| 等级上限 | 所需总声望 | 大致进度 |
|---|---|---|
| 1 级(开局) | 0 | 青石村起步 |
| 2 级 | 260 | 黑风岭全通 |
| 3 级 | 980 | 碧云涧全通 |
| 4 级 | 2350 | 落星谷全通 |
| 5 级(满级) | 4800 | 黄泉道全通 + 门派声望 |
旧的 13 档「数量上限」表(厢房 3→15 间、每种田 1→5 块)随建造机制一并退役:数据保留、前端仍在展示,但不再限制任何玩法。
五、一局的标准节奏
- 开局:注册登录 → 创建主角(名字 + 职业 + 性别)→ 送本命白武器 + 本门起手功法 → 主角自动上阵;山门 8 类建筑已全部就位(1 级)
- 前期(青石村~黑风岭):挂机攒三材、金币和纸/玄铁,仓库蓝装挑着穿,功法有啥学啥,招门人住进厢房
- 中期(雁回关~孤云城):声望破 980 后建筑可升 3 级,装备加工上 +4~+6,Boss 功法(蓝品)集齐三系
- 后期(玄冰崖~黄泉道):冲金装 +10、铭刻传奇威能、萃取换魂,建筑满 5 级,甲/乙档门人成队,全通 71 关
六、时间与挂机节奏
- 时间倍率 ×60:1 真实秒 = 1 作品分钟,24 真实分钟 = 1 作品天(开局清晨 07:30)
- 资源田每作品小时产 10(1 级;随田等级升到 18),囤满停产(1 级 100;随仓库等级升到 180),满仓自动收
- 候选自动刷新:每作品 3 小时(= 真实 3 分钟)一批 5 人(2026-10-11 起,此前 3 人);手动刷新 60 金不限次
- 离线收益:资源田最多补 24 真实分钟;挂机战斗不自动跑(要开页面)
七、文档导航
全部文档在作品内「作品文档」按钮的索引页按类目浏览。分类:
- 玩法系统:建筑与等级 / 声望 / 厢房 / 大殿招募 / 关卡敌人生态
- 升级与收集:功法收集与升级 / 装备强化与加工 / 人物养成
- 美术资产:敌人动作检查 / 设定图检查 / 十八职业形象
- 技术方案:技术架构总览 / 本地生图方案
- 规格契约:equip-impl-spec.md(前后端并行开发的字段契约)