凡人恩赐

Mortal Boons 为 Minecraft 添加了一种类 Roguelike 的恩赐机制。在命运之石（Fatestone）处消耗经验等级和物品祭品，以随机获取一种恩赐：生命值、速度或攻击伤害等属性加成，每种都有随机的品阶。你最多可以同时持有三个恩赐。然而，一旦死亡，你将失去全部恩赐。掷出骰子获得强力加成，然后务必牢牢守住它们。

这个模组几乎一切内容都可以通过配置文件或数据包进行自定义。你可以根据自己的需求调整，包括死亡时完全不移除恩赐（或只移除 1 或 2 个），使其更像一个可配置的玩家附魔系统。模组自带一个默认的原版数据包，方便你直接上手使用。

访问网站获取更多信息，了解如何为此模组构建数据包或 json 文件，或查看我的其他一些模组。

为什么选择 Mortal Boons

大多数进度都是永久性的。一旦你拥有了装备、附魔和效果，死亡就只是一种不便。Mortal Boons 增加了一层真正需要冒险投入的力量。你投入经验和物品，获得力量，然后努力保持住它。它适用于任何死亡应有代价的整合包，并且配置文件可以让你调整死亡的严苛程度。
以下是关于如何使用和升级命运之石的快速指南。更多细节请继续阅读下文。

合成命运之石

所有操作都在命运之石处进行。使用深板岩砖、金锭和末影之眼合成它。

放置它并右键点击以打开菜单。一个全新的命运之石只有一个恩赐槽位。

为其充能

命运之石有三个能量等级，每个等级都会额外提供一个恩赐槽位。能量来自其周围环境：

• 在其背面和两侧放置点燃的蜡烛（正面留空）可获得 +1 能量。
• 将其直接放置在信标顶部可获得 +1 能量。

这两种方式相互独立。仅用蜡烛或仅用信标可获得能量等级 2，两者兼具可获得能量等级 3。在能量等级 2 时，石头开始苏醒。

在能量等级 3 时，它的眼睛会睁开并发出光芒。

能量等级还限制了更深层的操作。默认情况下，重铸在能量等级 2 时解锁，重塑在能量等级 3 时解锁。破坏这种布置永远不会移除你已经拥有的恩赐，它只会锁定槽位和操作，直到你恢复它。

赌上命运

打开菜单，将祭品放入槽位，然后点击“赌上命运”。每次掷骰都会消耗经验等级和祭品物品。如果有任何条件缺失，按钮会明确告诉你无法掷骰的原因。

悬停空白的祭品槽位可以查看命运之石接受哪些物品。

掷骰首先选择品阶（铁、金、钻石或下界合金），然后从该品阶中选择一种恩赐。你的祭品会影响几率（这些祭品包含在默认的原版数据包中）：

• 铁锭：一份朴素的礼物，完全由命运决定。
• 金锭：将获得金品阶掷骰的几率翻倍。
• 钻石：将获得钻石品阶掷骰的几率提高 1.5 倍。
• 蜜脾、幻翼膜、兔子脚、烈焰粉、末影珍珠：每种物品都将五个徽记之一的恩赐出现几率提高至三倍。

没有任何祭品能影响下界合金品阶。最好的掷骰结果总是纯粹靠运气。

恩赐与五大徽记

每种恩赐都是一种随品阶提升的属性加成，在菜单中显示为一张卡片。卡片显示恩赐的图标、名称、徽记，以及它在掷出的品阶下实际提供的效果。

悬停卡片以查看完整详细信息和一些说明文字。

模组内置了跨越五大徽记的 19 种恩赐：

• 巨熊：耐力。生命值、护甲值、护甲韧性和击退抗性。
• 巨狼：暴力。攻击伤害、攻击速度、击退和横扫。
• 野兔：速度。移动速度、跳跃、安全坠落和崎岖地形适应。
• 巨龙：火焰、岩石和深水。抗火、抗爆炸、氧气和挖掘。
• 渡鸦：视野和幸运。触及距离、潜行速度和幸运。

有些恩赐只会在更高品阶出现。幸运之眼只回应钻石和下界合金品阶。

重掷、重塑与舍弃

悬停已持有恩赐的卡片以查看其操作。每次操作都需要消耗经验，并且使用次数越多，消耗越高。

• 重掷：将该恩赐替换为另一个随机品阶的恩赐。在能量等级 2 且持有 2 个恩赐时解锁。
• 重塑：仅重新掷定品阶。品阶可能下降也可能上升。在能量等级 3 且持有 3 个恩赐时解锁。
• 舍弃：将恩赐抛弃并清空该槽位。默认关闭，可在配置中启用。

所有操作共享一个冷却时间，该冷却时间会随你持有的恩赐数量而增长（默认分别为 10、20 或 30 分钟）。当你无法承担某项操作的消耗或石头仍在冷却时，按钮会变灰，并且工具提示会说明原因。

死亡

死亡会清除你持有的所有恩赐。这是模组的核心机制：恩赐让你强大，但这份力量并非真正属于你。你逐渐增加的掷骰消耗也会在死亡后重置，因此重新攀升比之前下降时更为廉价。冷却时间在死亡后依然保留，你无法通过死亡来规避等待时间。

配置

所有内容都保存在 mortal_boons-common.toml 中，可在游戏内通过模组配置界面进行编辑。

类别	可调项
掷骰成本	基础经验消耗、每次掷骰的额外消耗、最大消耗
重掷 / 重塑 / 舍弃成本	每种操作的基础、每次使用、最大值，以及可选的共享重掷和重塑计数器选项
冷却时间	持有 1、2、3 个恩赐时的分钟数
操作限制	允许重掷 / 重塑 / 舍弃，每个操作所需的命运之石能量和持有恩赐数
祭品	必需、可选或完全禁用
品阶几率	铁、金、钻石、下界合金的权重

此外还有一个客户端选项，可以隐藏卡片上的徽记名称。

数据包

恩赐、徽记和祭品都是数据包 JSON。名称、描述、颜色、权重、品阶限制和祭品效果都保存在数据文件中，因此你可以在不接触代码或附带资源包的情况下重新调整或替换所有内容。

内置内容以一个名为“Mortal Boons Default Boons”的可移除数据包形式提供。禁用它，你就拥有了一块白板，可以构建自己的内容。

关于按品阶列出的列表说明：任何接受数字的地方，你可以提供一个单一值（对所有品阶生效）或一个从铁到下界合金索引的 4 个值列表。

添加恩赐

恩赐文件位于 data/<your_namespace>/mortal_boons/boons/<boon_name>.json。以下是默认数据包中的“跃进之步”（Springstep）：

{
  "weight": 10,
  "types": ["mortal_boons:hare"],
  "icon": "minecraft:textures/item/rabbit_foot.png",
  "name": "Springstep",
  "description": "Up comes easy. Down comes kind.",
  "attribute_grants": [
    {
      "attribute": "minecraft:generic.jump_strength",
      "amount": [0.2, 0.35, 0.5, 0.7],
      "operation": "add_value"
    },
    {
      "attribute": "minecraft:generic.safe_fall_distance",
      "amount": [1.0, 1.0, 2.0, 3.0],
      "operation": "add_value"
    }
  ]
}

• weight 控制该恩赐在其品阶被掷出后的出现概率。使用列表来控制品阶限制：[0, 0, 10, 10] 表示该恩赐只存在于钻石和下界合金品阶。数值越高越常见。
• types 列出该恩赐所属的徽记。
• icon 可以是任意纹理路径，也可以是包含 4 个不同品阶图标的列表。
• name 和 description 显示在卡片及其工具提示中。两者都是可选的。如果没有名称，模组会回退到语言键 boon.<namespace>.<boon_name>。
• attribute_grants 是实际效果：任意属性、平坦或百分比的 operation（add_value、add_multiplied_base、add_multiplied_total），以及每个品阶的数值。

如果你安装了 Player Abilities，恩赐还可以授予主动、被动和触发式能力：

"ability_grants": [
  { "ability": "your_mod:some_ability", "level": [1, 1, 2, 3] }
]

当未安装 Player Abilities 时，仅授予能力的恩赐会自动从奖池中移除。

添加徽记

徽记文件位于 data/<your_namespace>/mortal_boons/boon_types/<sign_name>.json，仅包含标题和颜色：

{
  "title": "The Hare",
  "color": "#3E7C44"
}

标题在卡片上显示在恩赐名称下方，并使用该徽记的颜色。

添加祭品

祭品文件位于 data/<your_namespace>/mortal_boons/offerings/<offering_name>.json。以下是一个能使野兔恩赐出现几率提高至三倍的祭品：

{
  "item": { "item": "minecraft:rabbit_foot" },
  "count": 1,
  "type_weight_multiplier": { "mortal_boons:hare": 3.0 },
  "description": "Draws the eye of The Hare."
}

以下是一个转而影响品阶掷骰的祭品：

{
  "item": { "item": "minecraft:gold_ingot" },
  "count": 1,
  "tier_weight_multiplier": [1.0, 2.0, 1.0, 1.0],
  "description": "Favors a Gold turn of fate."
}

• item 接受一个物品或一个标签（{ "tag": "c:gems/diamond" }），count 是每次掷骰消耗的数量。
• tier_weight_multiplier 会乘算品阶几率。设为 0 可完全将该品阶从掷骰中移除。
• type_weight_multiplier 会乘算属于这些徽记的恩赐的出现几率。
• min_tier 为品阶掷骰设置下限，适用于承诺钻石或更高品阶的高价值祭品。
• description 显示在工具提示中。如果省略，模组会自动描述该祭品的作用。

如果祭品的要求无法满足（例如设置了 min_tier 但已无可掷骰的更高品阶），掷骰会拒绝进行，且不会消耗任何物品。

命令

适用于服务器管理员和调试：

/mortalboons list     - 列出你持有的恩赐及其品阶
/mortalboons clear    - 清除你的恩赐并重置冷却时间