ExampleMod — 深度提示引擎、便携工坊与神化集成

ExampleMod —— 深度提示框引擎、便携工作台与 Apotheosis 集成

一个为大型整合包打造的生活质量与集成模组 —— 深度提示框、便携合成站、Apotheosis + Iron's Spells + L2Hostility 桥接，以及一系列原版平衡调整。

---

✨ 它能做什么？

🔍 深度提示框引擎

核心功能。每个物品的提示框都会变成一个实时的、由数据驱动的信息面板。

• 可视化耐久条，带有平滑的颜色渐变
• 食物预览 —— 真实的饥饿值与饱和度图标
• 药水 / 炖菜效果面板，显示持续时间与效果等级
• 燃料计 —— 燃烧刻数以及“能烧炼多少个物品”
• 堆肥概率、冷却计时器、工具挖掘速度倍率
• 容器与收纳袋网格预览 —— 一眼看清潜影盒、背包和收纳袋里的东西
• 地图预览 —— 在提示框中渲染实际的地图图像
• 盔甲纹饰预览、旗帜图层、染色颜色色块
• 磁石指南针 —— 显示维度、坐标与当前距离
• 成书 / 书与笔摘要 —— 页数、作者、首页片段
• 冒险模式 CanPlaceOn / CanDestroy 方块网格
• 蜜蜂与被捕获的实体 —— 内联渲染刷怪蛋图标
• 唱片机唱片信息、不祥之瓶效果等级、附魔等级
• 服务端权威信息 隐藏在组件中，并被清晰地呈现出来

🗿 模型展示台

悬停物品时，提示框旁边会出现一个旋转的 3D 模型 —— 盔甲套装显示在完整的玩家模型上，饰品珠宝通过 Curios API 显示，狼 / 马铠显示在真正的动物身上，刷怪蛋显示在真实的生物上。对于会导致崩溃的物品会自动禁用，且可完全切换开关。

📌 固定提示框

中键点击提示框可将其固定到屏幕角落。使用滚轮翻页。非常适合对比装备，或无需一直停住光标就能阅读长书。

📦 JSON 提示框规则

通过数据包为任意物品添加你自己的提示框文本 —— 无需编写代码：

{
  "item": "minecraft:diamond_sword",
  "lines": ["Forged in the void.", "Only the worthy may wield it."]
}

将文件放入 data/<namespace>/tooltips/。

---

🎒 便携工作台

随时随地合成，再也不用打开 GUI 方块：

物品	功能
便携熔炉	完整的烧炼功能，状态持久保存于物品上（NBT 同步）
便携酿造台	在背包中酿造，即使 GUI 关闭也能进行
便携铁砧	完整的铁砧机制
便携切石机	完整的切石机配方

熔炉与酿造台在携带时仍会继续工作，其进度保存到一个自定义数据组件中。

---

🧙 Iron's Spells 新增内容

两个全新的召唤法术，与魔法学派系统完全集成：

• 召唤洞穴蜘蛛 —— 数量、生命值与伤害随法术等级提升。再次施放会召唤一群。命中时附加中毒。
• 召唤支援龙 —— 一条悬浮的末影龙，会跟随你并向附近的敌人降下火球。持续时间随等级提升（最长可达 15 分钟以上）。

两者都与 L2Hostility 完全兼容 —— 每个已注册的 Iron's 法术都会自动生成一个对应的敌对特性，因此生物可以通过 spelltrait gen 命令向你施放这些法术。

---

⚔️ Apotheosis 集成

• 未鉴定宝石与卷轴 —— 战利品箱现在会掉落未鉴定版本，右键点击后才会揭示其稀有度。为战利品发现增添了真正的分量。
• 饰品拟态类别 —— 饰品物品会随机抽取一个 Apotheosis 战利品类别，使其能够获得来自任意装备栏位的词缀。
• L2Artifacts 插槽上限 —— 基于等级的插槽限制（5 级 → 3 个插槽，4 级 → 2 个，以此类推）
• 所有宝石加成缩放为 25% —— 一项平衡补丁，适用于 Apotheosis 宝石主导装备成长路线的整合包。
• 世界层级门槛 —— Apotheosis 世界层级的解锁现在需要 L2Hostility 难度等级 + 玩家经验等级，将两个系统关联起来。
• /apoth_dump 与 /apoth_studio export —— 将所有词缀、宝石和战利品类别导出为 markdown 表格或 JSON 数据包，便于整合包开发。

---

🩸 L2Hostility 桥接

• 法术转特性生成器，通过 /spelltrait gen —— 为白名单中的每个法术自动生成平衡的特性数据映射
• 生物敌对等级每级给予玩家 +0.1 幸运值（服务端，同步正常）
• 物品难度修正由 l2hostility:extra_difficulty 属性驱动，每个物品实例 UUID 对应一个可叠加的修正值

---

⚖️ 原版平衡调整（均可通过 Mixin 配置）

一份精心挑选的调整列表，专为那些认为原版机制过于极端的整合包设计：

功能	改动
苦力怕爆炸	半径随苦力怕剩余生命值缩放
生命恢复	每刻治疗 最大生命值 的 5%，而非固定 1 点生命值
饱和度 / 自然恢复	每刻治疗最大生命值的 5%
中毒	每刻造成最大生命值 0.5% 的伤害（最低 1 点）
凋零	每刻造成最大生命值 1% 的伤害（最低 1 点）
力量药水	每级 +12.5% 乘算加成（而非固定 +3）
虚弱	-16.6% 乘算（而非固定 -4）
治疗 / 伤害 vs 亡灵	现在会遵循 healing_received 属性
食物上限	饥饿值可以超过 20（无上限，+18 恢复阈值会相应调整）
玩家死亡	仅损失 1 级经验，而非整条经验条；死亡时不掉落经验
夜视	在结束前 240 刻逐渐淡出，而非闪烁
属性上限	提高了模组属性的上限（最大生命值等）
箱子音效	音量降低 50%，与低噪音整合包相匹配
箭矢暴击粒子	已抑制（更简洁的战斗视觉效果）
床上的指南针	像磁石一样将指南针绑定到任意床上
战利品表堆叠	更智能的分组 —— 部分堆叠会与相同组件合并

---

🖥️ 客户端生活质量

• 背包按钮 —— 直接从背包打开 ViScriptShop 选择器或睡过夜晚
• 对任意物品按 Ctrl+C 复制其注册 ID 并在聊天栏中打印（在容器中同样有效）
• 箱子插槽叠加层 —— Apotheosis 稀有度物品上的稀有度标记、卷轴稀有度标记、宝石的纯度指示器
• 配置界面 —— 每个功能都可通过内置的 NeoForge 配置 UI 切换

---

🔧 配置

一切都存放在单个客户端配置文件中（config/examplemod-client.toml）：

• 切换提示框引擎、模型展示台、容器预览、自定义规则
• 调整最大提示框宽度、背景 / 边框颜色、固定页面大小
• 稀有度主题（边框采用物品的稀有度颜色）
• 供整合包开发者使用的插槽调试叠加层

---

📦 前置需求

• NeoForge，用于 Minecraft 1.21.1
• Iron's Spells 'n Spellbooks（法术内容所必需）
• Apotheosis + Apothic Attributes（宝石 / 词缀功能所必需）
• L2Hostility、L2Artifacts（可选 —— 仅当存在时才会激活桥接功能）
• Curios API（可选 —— 用于饰品模型预览与拟态类别）

提示框引擎、便携工具或原版平衡调整没有硬性依赖 —— 它们可以独立工作。

---

🎯 这是为谁准备的？

整合包作者，运营着一个包含 Apotheosis + Iron's + L2Hostility 的“大杂烩”成长路线整合包。本模组中的每个系统都旨在让这三个模组彼此干净地沟通，同时为玩家提供一层真正能传达当前状况的提示框信息。

如果你正在构建一个原版机制太弱、玩家认知太隐晦的整合包，本模组可以同时填补这两处空白。

---

📝 许可证与源代码

• 可自由包含在任何整合包中
• 配置驱动 —— 没有强制功能
• 源代码可应要求提供

---

发现了 bug 或想要新的集成？留下评论 —— 每一条我都会看。