恐怖的灯笼

恐怖灯笼

🏮 特点概览

恐怖灯笼是一个适用于 Minecraft 1.20.1（Forge）版本的模组，为你的世界引入了被诅咒且强大的灯笼。它们不仅仅是光源，更是神秘的 artifacts，赋予持有者可怕的能力，但代价是与其黑暗能量绑定。

• 动态照明：灯笼在主手或副手时即可发光。
• 独特能力：每个灯笼拥有两种不同的主动能力（血月：爆发与汲取 | 暗夜：召唤与天怒）。
• 自定义音效与事件：仆从新增氛围音效，包括空闲时的呼吸声和攻击时的尖叫声。还包括黑暗之心事件，每 60 秒玩家会听到不祥的低语和消息。
• 海量本地化：原生支持全球 20 多种不同语言！
• 归属系统：灯笼会自动绑定给第一个使用者。只有绑定的主人才能切换其开关或使用其能力。
• 黑暗之仆：当玩家丢弃自己拥有的灯笼且背包已满时，会根据丢弃的灯笼数量动态生成忠诚、无敌的幽灵仆从。它们会优先寻找丢弃灯笼最多的玩家，将其取回并跟随玩家，直到背包有空间。
• 仆从结盟：仆从（如仆从和暗影）严格与主人结盟。它们不会互相攻击，主人也无法误伤它们。
• 苦力怕驱逐：点燃的灯笼的恐怖光环会自动吓跑任何靠得太近的苦力怕。
• 自动熄灭：为了保持平衡，任何点燃的灯笼在连续使用 10 个游戏分钟后会自动熄灭，并警告玩家快速重新点燃。
• 自定义动画：持有灯笼的玩家和仆从会呈现独特的“僵尸式”手臂姿势。
• 氛围效果：彩色粒子和音效增强了恐怖体验。
• 附加 API：内置 API 提供了物品、能力、实体和渲染器的基类，方便其他模组制作者轻松创建自己的自定义灯笼。

---

🕯️ 灯笼介绍

🔴 血月灯笼

一盏以周围生命精华为食的被诅咒灯笼。它散发着深红色的光芒。

• 鲜血爆发（按键：V）：触发一股红色能量爆发，让玩家获得 30 秒的隐身效果，并召唤出 8 只蝙蝠围绕玩家旋转。
• 生命汲取（按键：B）：吸取半径 5 格内所有附近生物（不包括玩家）的生命值。每次命中都会治疗玩家，并永久提升玩家的最大生命值（上限为 50 总生命值）。
• 合成配方：黑石、墨囊、红石块、玻璃、烈焰粉。

🔵 暗夜灯笼

一盏驾驭黑暗深渊与风暴力量的灯笼。它散发着深蓝色的光芒。

• 召唤（按键：V）：召唤 4 只暗影（忠诚的暗影实体），追踪你当前注视的生物。如果未找到目标，它们会守护你。你一次只能激活一组暗影。
• 天怒（按键：B）：向目标位置（最远 32 格）降下一道深渊闪电，对命中者造成魔法伤害。
• 合成配方：黑石、墨囊、紫水晶块、玻璃、烈焰粉。

🟢 毒牙灯笼

一盏散发着病态绿光的被诅咒灯笼，channel 毒蛇的精华。

• 剧毒范围（按键：V）：释放一团毒云，对半径 8 格内所有附近生物施加 10 秒的中毒 II 效果。
• 蜘蛛安抚（按键：B）：镇定蛛形纲生物的心智，安抚半径 16 格内的所有蜘蛛，消除其攻击性，使其恐惧地四散奔逃。
• 合成配方：黑石、墨囊、绿宝石块、玻璃、烈焰粉、蜘蛛眼。

---

⚙️ 配置

该模组可通过游戏内配置界面（在模组列表中找到）或 horrifyinglanterns-common.toml 文件进行高度配置。

• 光照等级：调整灯笼的光照亮度（0-15）。
• 自动熄灭时间：配置点燃的灯笼自动关闭前的游戏分钟数（1-60），默认为 10。
• 能力：每个灯笼都有两种独特的能力，并配有独立的冷却时间。
• 反馈：所有能力状态和冷却消息都会清晰地显示在动作条上。
• 照明系统：自定义的基于方块的系统在玩家脚边提供真实光照。
• 氛围色调：彩色粒子为地面和实体提供沉浸式光效。

---

🏆 进度

• 血月发现：获得一个血月灯笼。
• 深渊发现：获得一个暗夜灯笼。
• 毒液发现：获得一个毒牙灯笼。
• 恐怖灯笼大师：获得全部三个灯笼，以解锁一个特殊挑战进度，并带有自定义恐怖主题背景。

---

🛠️ 面向开发者：附加 API

恐怖灯笼为附加模组制作者提供了一个公共 API。你可以通过继承 me.axlerogue.horrifyinglanterns.api.LanternBaseItem 来创建自己的自定义灯笼。

API 提供的功能：

• 手持时自动动态照明。
• 自动自定义手臂持有动画。
• 通过 lightColor 轻松自定义颜色。
• 内置开关机制（标准按键绑定‘L’）。
• 完全访问按键映射、能力、实体和处理器。

有关完整教程和代码示例，请查看模组文件中的 API_GUIDE.md。有关报告错误或建议新功能的信息，请查看 ISSUE_TRACKER.md。

---

📜 许可证与鸣谢

• 许可证：本项目基于 GNU Affero General Public License v3.0 (AGPL-3.0) 许可。
• 作者：AxleRogue
• 开发环境：Minecraft Forge 1.20.1
• 实体音效制作者：Xvslife，感谢您为让模组中的实体更加生动所做出的贡献。