死人信件

Dead Letters

---

将战利品箱变成散落的遗言档案。每张便条都属于一个故事；每个玩家按顺序收集各故事的部分，而多个故事会并行推进——没有清单式的刷取，只有你穿行于世界追寻的碎片。

---

你可以不构建数据包就添加自定义故事： 在 config/deadletters/stories/ 中放入文件夹，内含 story.json 和 part_1.txt、part_2.txt、…… 或 part_N.json（简单 .txt 模式：第一行是标题；其余非空行是正文）。重启或运行 /reload。 默认根目录为 config/deadletters/stories（如果你想在 config/ 下使用其他文件夹，请在通用配置中更改 customStories.path）。 为整合包作者提供的额外故事：在 data/<命名空间>/deadletters/stories/<story_id>/ 中添加 story.json 和 notes/part_N.json，或使用相同的文件夹结构放在 config 下供玩家使用。

---

运作方式： Dead Letters 会在重载时加载内置 jar 故事以及数据包和配置故事，将它们合并到一个注册表中，并在战利品应用时进行加权便条掉落判定。如果启用了进度系统，阅读一部分后故事顺序会推进；战利品获取资格会跟随该进度（并遵循重复规则）。箱子便条注入在剪贴簿解锁后运行——通常你打开的第一个箱子会放入起始书（可配置）。选项涵盖生成概率、箱子数量上限、重复规则、多故事判定、首个 Lootr 箱子与起始剪贴簿行为、部分权重调整、自定义故事路径以及调试工具。

Lootr 适配：便条作为普通战利品行为；Lootr 箱子保持每个玩家独立，因此掉落物会尊重每个倾听者自身的进度。Lootr Liaison 确保了结构容器在 Lootr 整合包中的最终化稳定——若想获得预期效果，请同时运行两者。

---

如何使用： 解锁剪贴簿（从箱子中拾取它或放在物品栏中——参见 config 中的默认设置）。然后搜索战利品箱以获得便条掉落，使用 Dead Letters 创意标签页获取任何已加载的部分，右键点击便条打开羊皮纸阅读器，将便条放置在世界中或讲台上，并使用便条上的“添加到笔记本”来存档副本。长篇便条会分页；点击羊皮纸旁的箭头按钮翻页（当没有上一页或下一页时箭头会隐藏）。

更多选项：config/dead_letters-common.toml —— general.spawnChance、maxNotesPerChest、useProgression、allowDuplicates、partOneDropWeight、finalPartDropWeight、guaranteeFirstLootrChest、guaranteeStarterScrapbookFirstChest；stories.enableMultipleStories；customStories.*；debug.*

---

服务器命令（作弊 / 管理员）： /deadletters debug stories —— 列出已加载的故事和便条数量 /deadletters debug state —— 显示对调用者可见的进度快照 /deadletters debug reset —— 清除已保存的进度和容器标记（测试用） /deadletters debug roll —— 针对当前池模拟加权随机判定（1–5000） /deadletters debug give —— 通过 ID 给予一张便条（例如 code_zero_01）

---

依赖项： 必需：Lootr、Lootr Liaison、AzureLib

Dead Letters 不替代 Lootr——它是在每个玩家的箱子战利品之上，添加了叙事碎片、每个玩家的故事顺序、剪贴簿存档流程和可读的便条界面。