核心模式

Heartcore 模式

一个为 Minecraft NeoForge 打造的 Roguelike Heartcore 游戏模式。 每次死亡都会永久削减最大生命值。在地牢箱子中发现“心”来恢复失去的生命力，将你的生命上限从默认的 20 HP 提升至 40 HP（20 颗心），并为你的庇护所制作保护性的生命之源灯。

---

主要特性

• 🎮 真正的游戏模式：“Heartcore”可与其他模式（生存、极限、创造）一起，在“创建新世界”界面中直接选择。
• 💔 高风险死亡：每次死亡都会永久损失 1 颗心（2.0 最大 HP）。你的生命值永远不会低于 3 颗心（6.0 HP）——不会立即游戏结束，但生存会变得更具挑战性。
• ❤️ 心之物：可在结构箱子中找到（地牢、废弃矿井、要塞、远古城市、堡垒遗迹、林地府邸、末地城），或作为村民的极稀有掉落物。食用可恢复 1 颗心；若生命值已满，则会将生命上限提高至最多 40 HP（20 颗心）。同时赋予附魔金苹果的强大效果。
• 🏮 生命之源灯：一种神秘灯笼，由 8 颗心环绕 1 个火把合成。为 64 格半径内的所有玩家持续提供生命恢复和伤害吸收增益。
• ⚖️ 干净的兼容性：使用专用的 AttributeModifier，保留其他模组（饰品、配件、盔甲和药水）的生命加成，不会出现数值裁剪问题。
• ⚙️ 完全可配置：所有生命惩罚、恢复值、战利品几率和信标参数均可通过配置自定义。

---

生命机制

事件	结果	默认值
玩家死亡	最大 HP 永久降低	-2.0 HP（1 颗心）
下限	生命值永不低于	6.0 HP（3 颗心）
食用一颗心	恢复失去的最大 HP	+2.0 HP（1 颗心）
满上限时食用一颗心	扩展最大 HP 上限	+2.0 HP（最高 40 HP / 20 颗心）

Current Health Cap = Base_HP + Hearts (up to 40 HP)

---

心

食物 / 神器 | 稀有结构战利品

• 食用效果：生命恢复 II、抗性提升、抗火、伤害吸收 IV（即使满生命值也可以随时食用）。
• 获取地点：
  • 结构箱子（地牢、远古城市、堡垒遗迹、府邸）——15% 几率
  • 末地城箱子——35% 几率
  • 村民——死亡时 1% 几率
• 整合包与数据包支持：通过添加到 heartcore:restores_max_health 物品标签，或者通过配置中的 extra_restoring_items 来添加更多可恢复生命值的食物（例如附魔金苹果、金苹果）。

---

生命之源灯

功能方块 / 防御信标

在合成台上合成：8 颗心围绕 1 个火把摆成环形。

[Heart] [Heart] [Heart]
[Heart] [Torch] [Heart]  ===>  Life Source Lamp
[Heart] [Heart] [Heart]

• 照亮周围区域（光照等级 15）。
• 可放置在地面上，也可悬挂在天花板上。
• 为 64 格内的所有非旁观模式玩家提供 生命恢复 和 伤害吸收，每 4 秒刷新一次。
• 你的主基地或前哨站的终极核心装饰。

---

配置（config/heartcore-common.toml）

• [gamemode] —— 默认世界选择，以及隐藏标准生存模式的能力。
• [health] —— 初始 HP（20）、最小 HP（6）、死亡惩罚（2）、心增益（2）。
• [ceiling] —— 上限成长开关和步长（最高 40 HP）。
• [loot] —— 结构箱子生成、几率倍率、村民掉落率。
• [life_source] —— 信标光环开关、半径（64 格）、药水效果等级。