Tinkers' Devotion

模组

· 作者 pwazta

真正的匠魂模组集成!生物将生成时携带匠魂装备,掉落物/配方/交易全部替换

0 本站下载 0 关注 更新于 4 周前

最新 1.3.0 · 1.20.1 · Forge

一键开服(送7天)

Tinkers' Devotion

Tinkers' Devotion:真正的匠魂整合与沉浸体验!原版工具、武器和护甲在配方、战利品、生物装备及村民交易中全部替换为对应的匠魂物品。让你的 tinkering 无拘无束,世界也应当随之改变!

本模组旨在具备可扩展性,因此替换系统应能自动与大多数模组配合工作!大部分替换系统均可切换开关、按物品类型限定范围,或针对特定模组加入黑名单。请参阅下方的配置。


功能特性

1. 生物装备

生成时携带原版工具或护甲的生物将改为生成对应的匠魂物品,每次生成均为独立掷骰,且材质偏向于相同的等级。这适用于护甲、近战武器和远程武器。

2. 战利品表

箱子战利品、钓鱼池以及生物掉落物中的原版工具、武器和护甲将被替换为相同等级的同阶匠魂物品。预附魔的物品会在替换过程中将其附魔转换为加权随机的匠魂修饰符(Modifiers)。

3. 合成配方

禁用以原版工具、护甲和远程武器为产出的合成配方(通过 Mantle 实现)。将以原版工具作为输入原料的配方(例如:需要弓的发射器)被重写,以接受同等级的匠魂等效物品。此设计旨在兼容所有需要原版物品作为输入原料的模组配方。

强烈建议使用 JEI,因为它会在工具提示中显示每个槽位可选的匠魂工具及其等级提示。

4. 村民交易

所有涉及此类物品的村民交易(例如:盔甲商、工具匠、渔夫)都会在生成时替换为确定性交易(例如:工具匠出售的铁剑将替换为 2 级匠魂剑等效物)。流浪商人也会以相同方式处理。

5. 自定义模组物品支持

上述 4 个系统默认仅对原版物品触发,不会触碰模组物品,因为模组构建其工具的方式各不相同。我支持包含任何模组物品,只需在 config/tinkersdevotion/item_aliases.json 中添加具有原版对应物的模组物品即可,例如:"twilightforest:steeleaf_pickaxe": "minecraft:iron_pickaxe"。现在钢叶镐会被替换为匠魂铁镐等效物,并在战利品、生物、交易和配方中进行替换!它们自身的配方也会被禁用,与原版的处理方式相同。只有匠魂物品无法进行别名映射。


硬核细节

如果你只想玩游戏,请直接跳到配置。

剧透

基本流程

模组的核心是一个共享的 tryReplace() 函数:输入原版物品,输出匠魂等效物(匹配类别、加权材质、附魔转换为修饰符)。其他一切只是将物品传递进去的钩子。

四个入口点向 tryReplace() 提供数据:

  • 首次世界加载: 扫描所有已加载的配方,编写带有匠魂感知替换功能的生成数据包,并自动重新加载。
  • 生物生成: EntityJoinLevelEvent 处理器会交换生物槽位中的任何原版物品。
  • 战利品生成: Forge 全局战利品修改器对结果列表执行相同的替换操作。
  • 村民交易掷骰: 交易列表在注册时被包装,因此交易结果会通过相同的替换流程。

由于所有钩子都汇聚到同一个 tryReplace(),生物手中的钻石斧和箱子中的钻石斧会以相同的方式掷骰。

材质选择:80 / 10 / 10 分配比例 (可配置)

我们选择一个与原版物品类别匹配的匠魂工具(剑/镐类型等),然后使用加权分配为每个部件掷骰材质:

  • 80% 标准材质: 为该等级手工选择的匠魂材质,确保结果感觉自然。
  • 10% 同阶随机: 同一等级内的多样性。
  • 10% 任意阶随机: 跨等级差异,上限为可配置的最高等级(默认为钻石),以防止你在游戏早期遇到随机的肝铜僵尸。

完整的标准映射如下:

原版等级 工具标准材质 护甲标准材质
wooden tconstruct:wood -
stone tconstruct:rock -
leather - tconstruct:copper
copper tconstruct:copper tconstruct:copper
iron / chainmail tconstruct:iron tconstruct:iron
golden tconstruct:rose_gold tconstruct:gold
diamond tconstruct:cobalt tconstruct:cobalt
netherite tconstruct:hepatizon tconstruct:hepatizon

铜没有自己的匠魂工具等级,因此它保持 tconstruct:copper 为标准材质,并被匹配为铁(即铜替代品将约有 80% 的概率出现铜材质,其余部分则为铁等级)。

附魔 → 匠魂修饰符

预附魔的原版物品会将其附魔转换为匠魂修饰符。

  1. 预算: 求和原版附魔等级,取 ceil(sqrt(totalLevels × 4)),上限为 7。锋利 V、耐久 III、经验修补 I 的预算约为 6。
  2. 修饰符池: 基于你安装的匠魂配方构建,因此附加组件的修饰符会自动包含。不满足前置条件的修饰符会被过滤。
  3. 专业权重: 专业修饰符(专门应用于某种“类型”的工具,例如锋利)的概率是通用修饰符的约 8 倍。可调。
  4. 消耗预算: 每一步,要么升级现有修饰符(默认 65% 概率),要么选择一个新的。如果预算溢出,则添加额外槽位的修饰符。

配置文件中的跳过列表会阻止不需要的修饰符出现(默认包括 netherite、creative_slot、draconic 等)。

兼容性与扩展性

  • TC 模组附加组件: 通过标准标签和 Forge 工具动作自动加载。已与 Tinkers' Things、TCIntegrations、Tinkers Levelling Addon 和 Tinkers' Thinking 测试兼容。
  • 附加组件材料: 从 MaterialRegistry 实时读取。新增材料即具备可用性。自定义等级的材料适用于护甲和远程武器;工具则需要映射至原版等级。
  • 模组配方: 与原版配方一同被扫描捕获。数据包配方应能自动处理。
  • 模组战利品、生物装备、村民职业: 均命中与原版相同的钩子。无需白名单。
  • JEI: 已集成。替换食材会在每个槽位中循环显示有效的 TC 工具。配方转移支持原版 3×3 合成台、玩家物品栏网格、TC 工作台以及用户可扩展配置中声明的任何容器。
    • 注意:其他合成界面可能需要特殊处理,我尚未专门针对这些情况做出考量!如有任何问题,请告知我。

配置

将 jar 文件放入你的 mods 文件夹并加载世界即可。

默认设置相当合理,但如果你想进行调整,首次启动后会在 config/ 目录下出现四个文件:

文件 格式 控制内容
tinkersdevotion-common.toml TOML 主要开关。可独立禁用原版合成移除、生物替换、战利品替换或村民职业替换。调整部件匹配阈值、战利品方差、修饰符专业化权重。
tinkersdevotion/tool_exclusions.json JSON 按槽位或动作对特定 TC 工具进行黑名单处理。防止匕首在配方中替代阔刀,防止粘液套装作为护甲战利品掉落等。默认值已预填充。
tinkersdevotion/modifier_skip_list.json JSON 不应出现在随机附魔池中的 TC 修饰符 ID。默认值已预填充。
tinkersdevotion/item_aliases.json JSON 将模组物品视为原版物品(参见特性 #5)。

命令

  • /tinkersdevotion generate 重新运行配方扫描并重写生成的数据包。在安装或移除模组后非常有用。需要 OP 等级 2。
  • /tinkersdevotion generate reset 将两个 JSON 配置文件重置为默认值并重新生成。TOML 配置文件不受影响。

配方数据包在世界首次加载时自动生成,因此仅在更改模组列表时才需要此命令。


问题与反馈

留下评论或加入 Discord 进行交流或提问。如果你发现了错误或有任何特定请求,请在 GitHub 问题追踪器 上提交。

  • 我只是一个人!!
  • FAQ 即将推出。

需求与兼容性

  • Minecraft 1.20.1,Forge 47.4+
  • Tinkers' Construct 3.11+
  • Mantle 1.11+(Tinkers' 的依赖项,你肯定已经有了)
  • JEI 15.20+ (可选,用于配方显示和 Shift+点击转移)

在发布时已与几乎所有匠造附加组件测试兼容!任何使用标准标签并通过 TC 配方系统注册其修饰符的其他 TC 附加组件都友好兼容。

模组物品(如果你有兴趣替换来自其他模组的工具,如 epic-fight、simply-swords 等):默认情况下不会替换任何模组物品,但你可以添加简单的 mod:mytool, minecraft:vanillaItem 来进行替换(参见特性 #5)!旨在对所有用户保持极高的兼容性 :) 如果在这方面遇到任何问题,请告诉我!


致谢与许可

Tinkers' Construct 和 Mantle 由 SlimeKnights 开发。没有他们,这个模组将无法整合任何东西。

许可:保留所有权利。 简短版本:

  • 可免费包含在任何公开或私有的整合包中。署名是好的但不是必需的。
  • 可免费用于个人用途。
  • 未经书面许可,禁止修改、分支、重新上传或移植。

完整条款见 LICENSE.md。如需申请许可,请提交一个 GitHub Issue。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源