返回提交历史
Added
README.md
+83
-0
Added
docs/PLAY_GUIDE.md
+178
-0
XFEstudio/DeathMod
docs: add README and gameplay guide
f2a8e03
代码差异
2 个文件
+261
-0
@@ -0,0 +1,83 @@
1
# Soul Harvest
2
3
4
5
Soul Harvest（内部模组名：`DeathMod`）是一款面向 Terraria tModLoader 的死神镰刀成长模组。玩家使用本模组的镰刀收割灵魂，将灵魂凝聚为灵魂精华，再通过死神祭坛把一柄普通镰刀逐步改造成最终的死神镰刀。
6
7
当前版本：`2.0`
8
9
作者：XFEstudio
10
11
## 主要内容
12
13
- 五个镰刀阶段，每次进阶都会改变投射物行为。
14
- 灵魂保存在人物存档中，并通过屏幕右上角的灵魂罐显示。
15
- 每个新人物拥有 100 个初始灵魂。
16
- 只有本模组的镰刀能够登记并收割灵魂。
17
- 可在死神祭坛提升攻击、弹幕数量、穿甲和吸血。
18
- 镰刀进阶时会继承已有的祭坛改造和物品前缀。
19
- 支持单人和多人游戏；Boss 奖励按参与玩家分别结算。
20
21
## 快速开始
22
23
1. 使用 `10 木材 + 5 铁锭/铅锭`，在铁砧处制作基础镰刀。
24
2. 用本模组镰刀命中敌人并击败它们，积累人物灵魂。
25
3. 右键屏幕右上角的灵魂罐，每消耗 100 灵魂提取 1 个灵魂精华。
26
4. 在工作台使用 `20 石块 + 8 骨头 + 1 坠落之星`制作死神祭坛。
27
5. 放置祭坛，手持需要改造的镰刀，右键祭坛打开改造界面。
28
6. 第一份灵魂精华推荐用于进阶，让基础镰刀变成能够发射投射物的骷髅镰刀。
29
30
骨头通常需要在击败骷髅王后进入地牢获取，因此当前版本的祭坛主要从骷髅王后开始使用。此前获得的灵魂不会丢失，可以提前积攒。
31
32
完整流程、费用曲线和多人规则请参阅[游玩教程](docs/PLAY_GUIDE.md)。
33
34
## 核心数值
35
36
| 项目 | 数值 |
37
| --- | ---: |
38
| 新人物初始灵魂 | 100 |
39
| 提取 1 个灵魂精华 | 100 灵魂 |
40
| 普通敌人奖励 | 1 灵魂 |
41
| Boss 参与奖励 | 每位有效参与者 150 灵魂 |
42
| 镰刀阶段 | 普通 → 骷髅 → 恶魔 → 灵魂 → 死神 |
43
| 最大弹幕数量 | 7 |
44
| 最大攻击等级 | 25 |
45
| 最大穿甲等级 | 20 |
46
| 最大吸血等级 | 5 |
47
48
## 安装
49
50
### 使用已构建模组
51
52
将 `DeathMod.tmod` 放入 tModLoader 的本地模组目录，然后在“模组管理”中启用并重新加载：
53
54
```text
55
Documents/My Games/Terraria/tModLoader/Mods
56
```
57
58
### 从源码构建
59
60
需要已安装 tModLoader 和 .NET 8 SDK。克隆仓库后，可以将项目放进 tModLoader 的 `ModSources` 目录进行构建，也可以通过 `TML_HOME` 指定 tModLoader 安装路径：
61
62
```powershell
63
dotnet build .\DeathMod.sln -p:TML_HOME="G:\SteamLibrary\steamapps\common\tModLoader" --configuration Release
64
```
65
66
请按实际安装位置修改 `TML_HOME`。直接构建前应关闭 tModLoader，或先在游戏中禁用本模组，否则正在使用的 `DeathMod.tmod` 可能无法被覆盖。
67
68
## 项目结构
69
70
| 目录 | 内容 |
71
| --- | --- |
72
| `Common/` | 人物灵魂、NPC 奖励、升级服务与联机同步 |
73
| `Items/` | 镰刀、灵魂精华和祭坛物品 |
74
| `Projectiles/` | 高阶镰刀投射物行为 |
75
| `Tiles/` | 死神祭坛物块 |
76
| `UI/` | 灵魂罐和祭坛改造界面 |
77
| `Localization/` | 简体中文和英文文本 |
78
79
## 链接
80
81
- [游玩教程](docs/PLAY_GUIDE.md)
82
- [项目仓库](https://git.xfe.studio/XFEstudio/DeathMod.git)
83
- [XFEstudio](https://www.xfegzs.com/)
@@ -0,0 +1,178 @@
1
# Soul Harvest 游玩教程
2
3
[返回 README](../README.md)
4
5
本教程基于 Soul Harvest 2.0 的当前实现，介绍从新人物开局到获得死神镰刀的完整流程。
6
7
## 一、人物开局
8
9
新人物进入游戏时不会直接获得镰刀或灵魂精华，但会拥有 100 个初始灵魂。灵魂属于人物存档，不属于当前世界；更换世界不会清空灵魂，不同人物之间也不会共享灵魂。
10
11
屏幕右上角会出现灵魂罐，其中显示当前人物拥有的灵魂数量。把鼠标移到灵魂罐上，可以看到提取提示。
12
13
## 二、制作第一把镰刀
14
15
基础镰刀是整个模组成长线的起点，也是唯一能够直接合成的镰刀。
16
17
| 材料 | 数量 |
18
| --- | ---: |
19
| 任意木材 | 10 |
20
| 铁锭或铅锭 | 5 |
21
| 制作站 | 铁砧或铅砧 |
22
23
基础镰刀只有近战攻击，没有投射物。它的初始攻击较低，主要用于开启灵魂收割和后续改造系统。
24
25
## 三、收割灵魂
26
27
只有 Soul Harvest 的镰刀可以为敌人登记灵魂收割参与。
28
29
### 普通敌人
30
31
普通敌人死亡时，最近一位使用本模组镰刀命中过它的有效玩家获得 1 个灵魂。面对生命较高的敌人时，可以先用镰刀命中，再换用其他武器完成击杀。
32
33
### Boss
34
35
Boss 死亡时，每位曾使用本模组镰刀命中过该 Boss 的有效参与玩家获得 150 个灵魂。多人游戏中，奖励分别发给符合条件的玩家，不需要平分。
36
37
为了确保获得奖励，建议每位玩家在 Boss 战中至少用镰刀命中一次。对于双子魔眼、世界吞噬者等复合 Boss，模组会合并记录其组成部分的参与情况。
38
39
## 四、提取灵魂精华
40
41
右键屏幕右上角的灵魂罐，即可尝试提取灵魂精华：
42
43
```text
44
100 灵魂 = 1 灵魂精华
45
```
46
47
提取成功后，灵魂精华会进入人物物品栏。灵魂精华是祭坛所有改造的唯一消耗品；它本身不再由 Boss 掉落。
48
49
新人物的 100 个初始灵魂正好可以提取第一份灵魂精华。建议保留这份精华，用于首次镰刀进阶。
50
51
## 五、制作并放置死神祭坛
52
53
| 材料 | 数量 |
54
| --- | ---: |
55
| 石块 | 20 |
56
| 骨头 | 8 |
57
| 坠落之星 | 1 |
58
| 制作站 | 工作台 |
59
60
骨头通常需要击败骷髅王并进入地牢后获取。因此在正常流程中，可以在骷髅王之前制作基础镰刀并积攒灵魂，在骷髅王之后建立第一个死神祭坛。
61
62
祭坛需要足够的放置空间。放置成功后，站在祭坛附近、手持需要改造的镰刀并右键祭坛，即可打开改造界面。提交升级时，人物与祭坛的距离不能超过约 12 格。
63
64
## 六、镰刀进阶路线
65
66
“进阶改造”会把当前镰刀变成下一阶段，并保留攻击等级、弹幕数量、穿甲等级、吸血等级、前缀和收藏状态。
67
68
| 当前镰刀 | 攻击特征 | 下一阶段 | 进阶费用 |
69
| --- | --- | --- | ---: |
70
| 普通镰刀 | 纯近战挥击 | 骷髅镰刀 | 1 灵魂精华 |
71
| 骷髅镰刀 | 发射追踪骷髅 | 恶魔镰刀 | 2 灵魂精华 |
72
| 恶魔镰刀 | 发射恶魔镰刀弹幕 | 灵魂镰刀 | 4 灵魂精华 |
73
| 灵魂镰刀 | 发射主动追猎敌人的灵魂刀刃 | 死神镰刀 | 8 灵魂精华 |
74
| 死神镰刀 | 发射沿死亡螺旋追猎敌人的不灭刀刃 | 最终阶段 | 无法继续进阶 |
75
76
从普通镰刀一路进阶到死神镰刀，总计需要 15 个灵魂精华，也就是 1500 个灵魂。
77
78
## 七、属性改造
79
80
每柄新获得的镰刀默认拥有 1 级攻击、1 个投射物、1 级穿甲和 0 级吸血。通过进阶得到下一把镰刀时，当前改造会完整继承。
81
82
费用公式中的 `L` 表示当前属性等级，`N` 表示当前投射物数量。公式计算结果均以整数为准。
83
84
| 改造 | 效果 | 上限 | 下一次费用 |
85
| --- | --- | ---: | --- |
86
| 攻击 | 每级增加 2 点基础伤害 | 25 级 | `1 + floor(L² / 4)` |
87
| 弹幕数量 | 每级增加 1 个投射物 | 7 个 | `2^N` |
88
| 穿甲 | 每级增加 1 点穿甲 | 20 级 | `1 + floor(L / 2)` |
89
| 吸血 | 每级增加 1% 吸血系数 | 5 级 | `(L + 1) × 3` |
90
91
### 攻击费用示例
92
93
| 升级 | 费用 |
94
| --- | ---: |
95
| 1 → 2 | 1 灵魂精华 |
96
| 2 → 3 | 2 灵魂精华 |
97
| 3 → 4 | 3 灵魂精华 |
98
| 4 → 5 | 5 灵魂精华 |
99
| 5 → 6 | 7 灵魂精华 |
100
101
### 弹幕数量费用
102
103
| 升级 | 费用 |
104
| --- | ---: |
105
| 1 → 2 | 2 灵魂精华 |
106
| 2 → 3 | 4 灵魂精华 |
107
| 3 → 4 | 8 灵魂精华 |
108
| 4 → 5 | 16 灵魂精华 |
109
| 5 → 6 | 32 灵魂精华 |
110
| 6 → 7 | 64 灵魂精华 |
111
112
基础镰刀没有投射物，因此无法进行弹幕数量改造。首次进阶为骷髅镰刀后，该选项才会开放。
113
114
### 穿甲费用
115
116
穿甲从 1 级开始，费用缓慢递增。例如 `1 → 2` 需要 1 个灵魂精华，`2 → 3` 和 `3 → 4` 均需要 2 个灵魂精华。
117
118
### 吸血费用
119
120
五次吸血改造依次需要 `3、6、9、12、15` 个灵魂精华。吸血触发后存在短暂冷却，单次回复量也受到等级上限约束，因此它更适合作为中后期生存属性。
121
122
## 八、推荐成长顺序
123
124
### 骷髅王之前
125
126
1. 制作基础镰刀。
127
2. 用镰刀标记普通敌人，再使用合适的武器完成击杀。
128
3. 积攒灵魂，不必急着反复提取精华。
129
4. Boss 战中至少使用镰刀命中一次，获取 150 灵魂参与奖励。
130
131
### 建立第一个祭坛后
132
133
1. 使用初始的第一份灵魂精华完成首次进阶。
134
2. 花费 1 个灵魂精华把攻击从 1 级提升到 2 级。
135
3. 根据敌人防御选择第一次穿甲升级。
136
4. 积攒 2 个灵魂精华，将弹幕数量从 1 提升到 2。
137
5. 优先继续进阶，或根据当前流程补充攻击和穿甲。
138
6. 当输出已经稳定后，再投资费用较高的吸血与多重弹幕。
139
140
如果目标是尽快解锁不同攻击模式，应该优先进阶；如果当前阶段生存和输出压力较大，可以暂缓进阶，先提升攻击与穿甲。
141
142
## 九、多人游戏规则
143
144
- 灵魂余额保存在各自的人物存档中。
145
- 普通敌人的 1 个灵魂只会授予最近用本模组镰刀命中过它的有效玩家。
146
- 每位用本模组镰刀参与 Boss 战的玩家都可获得 150 灵魂。
147
- 祭坛会在服务端检查手持物品、灵魂精华数量、祭坛是否存在以及人物距离。
148
- 灵魂精华必须放在人物物品栏中，放在箱子里的精华不会被祭坛消耗。
149
150
## 十、常见问题
151
152
### 为什么开局没有镰刀？
153
154
当前版本只给予新人物 100 个初始灵魂。基础镰刀需要在铁砧处自行制作。
155
156
### 为什么没有获得普通敌人的灵魂？
157
158
必须先用 Soul Harvest 的镰刀命中过该敌人。原版武器和其他模组武器不能登记灵魂收割。
159
160
### 为什么击败 Boss 后没有获得 150 灵魂？
161
162
该人物必须在这次 Boss 战中用本模组镰刀命中过 Boss，并在奖励结算时处于有效游戏状态。
163
164
### 为什么弹幕数量按钮不可用？
165
166
基础镰刀没有投射物。先执行一次进阶改造，获得骷髅镰刀。
167
168
### 为什么祭坛提示需要手持镰刀？
169
170
祭坛只改造当前选中的物品栏槽位。请把需要改造的镰刀放到快捷栏并选中它。
171
172
### 为什么点击升级没有反应？
173
174
确认人物手持本模组镰刀、物品栏中有足够的灵魂精华，并且距离原祭坛不超过约 12 格。祭坛被拆除后，已经打开的界面也不能继续提交升级。
175
176
### 镰刀进阶后，之前的升级会消失吗？
177
178
不会。攻击、弹幕数量、穿甲、吸血、物品前缀和收藏状态都会继承。