# 灵魂收割（Soul Harvest）

[English](README.md) · [完整中文玩法指南](docs/PLAY_GUIDE.zh-Hans.md)

![Soul Harvest](icon.png)

Soul Harvest（内部模组名 `SoulHarvest`）是一款围绕人物灵魂、收魂镰六形态成长与死神祭坛构建的 tModLoader 成长模组。镰刀本身现在只是一把通用的“收魂镰外壳”；六条形态分支、阶段、技能和通用强化全部保存在人物身上，不再依附于某一把物品。

当前版本：`3.0`

作者：XFEstudio

## 核心内容

- 一把通用收魂镰，可在亡骨、血契、炼狱、霜魂、灵魂、虚空六种形态间成长和切换。
- 每个分支都有三个阶段、三个可升级的独特技能、独立左键连段、特殊技、大招与能量规则。
- 死神祭坛把人物绑定的“收魂镰”“死亡领域”与死神长袍、死亡之翼、死亡项链统一放入左侧装备列表。
- 灵魂、死亡领域斩击成长、形态进度、技能等级、通用节点和魂印账本均跟随人物存档。
- 普通敌人需要先被收魂镰施加死亡标记；Boss 灵魂奖励和阶段魂印采用服务端参与校验。
- 形态设计以近战刀光、定点斩击、残切和领域效果为主，严格控制常态飞行弹幕数量。

## 开局与合成

每个新人物拥有 **150 灵魂**。右上角灵魂图标支持双向转换：

- **右键灵魂图标：** 消耗 100 灵魂，提取 1 个灵魂精华。
- **左键灵魂图标：** 消耗 1 个灵魂精华，增加 100 灵魂。

| 物品 | 材料 | 制作站 |
| --- | --- | --- |
| 收魂镰 | 10 木材 + 5 铁锭或铅锭 | 铁砧/铅砧 |
| 死神祭坛 | 1 灵魂精华 | 工作台 |
| 死神长袍 | 20 丝绸 + 1 灵魂精华 | 死神祭坛 |
| 死亡之翼 | 20 飞翔之魂 + 1 灵魂精华 | 死神祭坛 |
| 死亡项链 | 恐慌项链 + 黑曜石玫瑰 + 3 灵魂精华 | 死神祭坛 |
| 死亡（旧版遗物） | 收魂镰 + 999 灵魂精华；需人物已解锁死神形态 | 死神祭坛 |

放置并右键祭坛后，从左侧装备列表选择要查看的项目：

- **收魂镰（人物绑定）：** 中央显示可拖动浏览的六分支全景技能树。点击节点只会选中并查看详情，需使用右侧详情栏按钮确认阶段点亮或技能升级。
- **死亡领域（人物绑定）：** 初始即存在，可升级斩击间隔、斩击伤害、多重斩击、领域吸血与“灵魂提炼”；武器或翅膀划开的领域裂隙也读取这套成长。
- **死神长袍、死亡之翼、死亡项链：** 位于同一装备列表中，并使用相同的可拖动画布和右侧详情栏显示各自完整的物品绑定升级树。

选择节点本身不会消耗资源；每个装备页都必须通过右侧详情栏按钮确认升级。收魂镰与死亡领域的成长写入人物存档；长袍、翅膀与项链的升级仍写入对应物品。

多人模式下，购买请求由服务端校验人物资源、世界进度、魂印账本、物品栏凭证、祭坛和距离。

## 六分支与三个阶段

六个分支互相平行，可以同时培养；点亮不会销毁或替换收魂镰。每次点亮阶段都会自动把该阶段对应的独特技能解锁为 Lv.1。

| 阶段 | 世界进度 | 魂印 | 精华费用 |
| --- | --- | --- | ---: |
| I · 形态初醒 | 击败骷髅王后 | 初醒魂印 ×1 | 1 |
| II · 能力蜕变 | 击败肉山、世界进入困难模式后 | 破界魂印 ×1 | 2 |
| III · 终极解放 | 新三王全部击败后 | 统御魂印 ×1 | 3 |

阶段门槛开放后，参与击杀任意 Boss 并造成有效伤害，会让当前最高阶段及之前所有阶段的魂印同时 `+1`：骷髅王后获得初醒；困难模式后同时获得初醒与破界；新三王全部击败后同时获得初醒、破界与统御。每个阶段最多签发 6 枚，刚好足够点亮六个分支；满额阶段不会阻止其他阶段继续增加。背包中的魂印物品只是人物账本的可见凭证，复制、丢弃或交易物品不能复制进度。背包已满时，凭证会在有空间后补发。

每个独特技能上限为 Lv.3：阶段解锁时免费获得 Lv.1，升级至 Lv.2 消耗 50 人物灵魂，升级至 Lv.3 消耗 100 人物灵魂。

## 形态定位

| 形态 | 左键与特殊技定位 | 独特技能 | 大招 / 主要能量来源 |
| --- | --- | --- | --- |
| 亡骨镰 | 三段近身骨斩，叠满骨印后定点碎裂；特殊技逐阶段加入落铡与交叉拘束 | 骨裂回响、幽骸拘束、亡者合唱 | **万骸葬场**；通过触发骨印碎裂积攒“骸鸣” |
| 血契镰 | 近身血斩与献血处决；仅阶段 III 连段终结生成 1 枚回旋血刃 | 饮血、血性狂热、凝血护命 | **绯月血祭**；通过承伤、献血和有效吸血积攒“血潮” |
| 炼狱镰 | 攻击带位移的近战连段，阶段提升后增加折返和三闪；地面留下定点熔痕 | 燎原步、灼骨、超燃回路 | **焚天·炼狱行刑**；通过连续命中和冲刺连段积攒“焚势” |
| 霜魂镰 | 三段冰斩、霜印和蓄力交叉斩；阶段 II 起每个三段循环最多生成 1 枚折射晶刃 | 霜蚀刻印、折光冰魂、零度处刑 | **绝对零界·万物凝止**；通过霜印碎裂积攒“寒潮” |
| 灵魂镰刀 | 近战动作留下原地魂影，阶段 II 起召出最多 1 名魂侍协同 | 魂影复唱、魂侍契约、命定刻写 | **亡者长河·百魂归葬**；通过左键与特殊技的有效命中积攒“魂归” |
| 虚空镰刀 | 纯近战空间切线、错位残切与断界仪式；不发射飞行弹幕，也不吸附敌人 | 断界锋、错位残切、终末坐标 | **虚无天断·世界两分**；让不同角度的空间切线交汇以积攒“维度应力” |

最终的**死神镰刀**不是第七条普通分支：必须将六分支全部点亮至阶段 III，并把 18 个独特技能全部升至 Lv.3 才会自动解锁。其左键按六相循环，完整循环最多产生 1 枚不灭死刃；大招为 **终焉安魂曲·六道归一**。

人物死神形态解锁后，还可选择在祭坛用一把通用收魂镰与 999 灵魂精华制作怀旧遗物“死亡”；它不是收魂镰成长的进阶前置。

## 通用节点、切换与大招

收魂镰全景树还提供六项对所有形态生效的通用节点：攻击伤害、攻击速度、暴击、护甲穿透、特殊技冷却和大招能量获取。攻击伤害上限为 10 级，其余节点上限均为 5 级；更高等级会要求任意一个分支达到对应阶段，具体费用会显示在所选节点的右侧详情栏。

- 按住形态轮盘键（默认 `V`），指向已点亮形态并松开即可**免费切换**；使用的是该分支已解锁的最高阶段。
- 攻击动作尚未结束时，切换请求由战斗层排队，在当前动作收束后生效，避免中途改写攻击快照。
- 特殊技默认 `Mouse2`，大招默认 `Mouse3`；两者和形态轮盘均可在按键绑定中修改。
- 只有阶段 III 形态可以积攒并释放对应大招。六个分支各自保存一条 0—100 能量槽，当前生命内切换不会清空；死亡或重新进入世界会清空临时能量与战斗冷却。
- 释放任意形态大招后会获得 8 秒“魂竭”，期间所有形态的大招都被锁定；各形态自身的大招冷却仍独立计算。

## 弹幕控制原则

本轮形态不是“换皮弹幕树”：亡骨 0 常态飞行弹幕、炼狱 0、虚空 0 且取消吸附；血契只在阶段 III 终结时出现 1 枚回旋刃；霜魂阶段 II 起每三段最多 1 枚晶刃；灵魂场上最多 1 名魂侍；死神六相完整循环最多 1 枚不灭死刃。其余表现主要由挥砍轨迹、定点斩、残切、交叉刀光和领域特效完成。

## 3.0 旧存档迁移

人物首次载入 3.0 时会扫描背包、猪猪存钱罐、保险箱、护卫熔炉和虚空袋，不扫描世界箱子。旧镰刀路线取并集，属性取最高值；旧死神镰刀直接保留完整死神资格并退款 85 精华。其余退款只按最高阶段、同阶段投入最高的一把计算，避免复制多把重复退款。旧形态物品会原地变为通用收魂镰并保留前缀；背包满时退款进入待领取记录。公开版 2.7 没有保存路线历史；后期支持退阶的存档即使把武器降阶也会保留历史槽。迁移会据此推导曾经确实到达的最高层，并在无法确定具体形态的层级授予所有合法形态的最小并集；不会信任可能随 Mod 加载顺序漂移的旧物品数字 ID，也不会剥夺已经走过的路线。迁移版本与快照会阻止重复领取。

## 灵魂、祭坛装备与多人规则

- 普通敌人必须先被收魂镰命中并获得死亡标记；奖励随最大生命增长，最多 50 灵魂。
- 每位在 Boss 战中用收魂镰留下有效命中的玩家都可获得完整的灵魂奖励，最多 500，不会在队伍间平分。
- 人物绑定的死亡领域初始即有；“灵魂提炼”每级使实际收割灵魂增加 10%，最高增加 50%。
- 阶段魂印的参与判定只要求在当前世界阶段开放后对任意 Boss 造成有效伤害，不限定最后一击；死亡但仍在线的参与者依然可领取当前阶段及之前各 1 点。
- 灵魂精华不会作为 Boss 的普通掉落；它由人物灵魂通过右侧灵魂图标凝聚，或来自已有的精华物品。
- 死亡之翼可培养飞行时间、水平速度、加速度和垂直能力，四项圆满后解锁无限飞行。
- 死神长袍拥有防御、生命、回复、机动、召唤与多项功能/减益免疫分支。
- 死亡项链仍是完整领域的开关：短按默认 `O` 展开或收回有限领域。项链只培养领域范围与“吸取万物”，二者圆满后解锁“死亡降临”；长按该键才会令整个领域降临现实并释放全屏斩击。

## 文档与链接

- [完整中文玩法指南](docs/PLAY_GUIDE.zh-Hans.md)
- [中文调试命令文档](docs/DEBUG_COMMANDS.zh-Hans.md)
- [English debug command reference](docs/DEBUG_COMMANDS.md)
- [English gameplay guide](docs/PLAY_GUIDE.md)
- [项目仓库](https://git.xfe.studio/XFEstudio/DeathMod)
- [XFEstudio](https://www.xfe.studio/)