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% 的概率出现铜材质,其余部分则为铁等级)。
附魔 → 匠魂修饰符
预附魔的原版物品会将其附魔转换为匠魂修饰符。
- 预算: 求和原版附魔等级,取
ceil(sqrt(totalLevels × 4)),上限为 7。锋利 V、耐久 III、经验修补 I 的预算约为 6。
- 修饰符池: 基于你安装的匠魂配方构建,因此附加组件的修饰符会自动包含。不满足前置条件的修饰符会被过滤。
- 专业权重: 专业修饰符(专门应用于某种“类型”的工具,例如锋利)的概率是通用修饰符的约 8 倍。可调。
- 消耗预算: 每一步,要么升级现有修饰符(默认 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 问题追踪器 上提交。
需求与兼容性
在发布时已与几乎所有匠造附加组件测试兼容!任何使用标准标签并通过 TC 配方系统注册其修饰符的其他 TC 附加组件都友好兼容。
模组物品(如果你有兴趣替换来自其他模组的工具,如 epic-fight、simply-swords 等):默认情况下不会替换任何模组物品,但你可以添加简单的 mod:mytool, minecraft:vanillaItem 来进行替换(参见特性 #5)!旨在对所有用户保持极高的兼容性 :) 如果在这方面遇到任何问题,请告诉我!
致谢与许可
Tinkers' Construct 和 Mantle 由 SlimeKnights 开发。没有他们,这个模组将无法整合任何东西。
许可:保留所有权利。 简短版本:
- 可免费包含在任何公开或私有的整合包中。署名是好的但不是必需的。
- 可免费用于个人用途。
- 未经书面许可,禁止修改、分支、重新上传或移植。
完整条款见 LICENSE.md。如需申请许可,请提交一个 GitHub Issue。
Tinkers' Devotion
Tinkers' Devotion: true tinkers integration and immersion! Vanilla tools, weapons and armor all replaced by their TC counterparts in recipes, loot, mob equipment, and villager trades. There are no bounds to your tinkering, and the world should reflect that!
This mod is designed to be extensible, so the replacements system should work automatically with most mods! Most replacement systems can be toggled, scoped per item type, or blacklisted per mod. See Configuration further down.
Features
1. Mob Equipment
Mobs spawning with vanilla tools or armor spawn with the TC equivalent instead, rolled fresh per mob with materials biased toward the same tier. This affects armour, melee and ranged weapons.
2. Loot Tables
Vanilla tools, weapons, and armor in chest loot, fishing pools, and mob drops get replaced with TC same-tier equivalents at the same tier. Pre-enchanted items have their enchantments converted to weighted-random TC modifiers as part of the swap.
3. Crafting Recipes
Crafting vanilla tools, armor, and ranged weapons as outputs is disabled (via Mantle). Recipes that take vanilla tools as inputs (e.g: a dispenser requiring a bow) are rewritten to accept a TC equivalent at the same tier. This is designed to work for ALL modded recipes which require vanilla items as recipe inputs.
I highly suggest you use JEI, as it shows candidate TC tools per slot with tier hints in the tooltip.
4. Villager Trades
All villager trades involving such items (e.g: armorer, toolsmith, fisherman) have these trades replaced with a deterministic trade on spawn (e.g: iron-sword from a toolsmith will be replaced with a tier-2 TC sword equivalent). Wandering traders are also handled in the same way.
5. Custom Modded Item Support
The 4 systems above trigger on vanilla items & DON'T TOUCH MODDED ITEMS BY DEFAULT since mods build their tools differently. I support including ANY modded item, just add to config/tinkersdevotion/item_aliases.json with a vanilla counterpart, e.g: "twilightforest:steeleaf_pickaxe": "minecraft:iron_pickaxe". Now steeleaf pickaxes are replaced by TC iron-pickaxe equivalents, and will be replaced in loot, mobs, trade and recipes! Their own recipe gets disabled too, same as vanilla's. Only Tinkers items can't be aliased.
Nerdy Stuff
Skip to Configuration if you just want to play.
Spoiler
The general flow
The core of the mod is a shared tryReplace() function: vanilla item in, TC equivalent out (matched category, weighted materials, enchantments converted to modifiers). Everything else is just hooks that pass items into it.
Four entry points feed tryReplace():
- First world load: scan all loaded recipes, write a generated datapack with TC-aware replacements, auto-reload.
- Mob spawn: an
EntityJoinLevelEvent handler swaps any vanilla item in the mob's slots.
- Loot generation: a Forge Global Loot Modifier runs the same swap on result lists.
- Villager trade roll: trade listings are wrapped at registration time, so trade results pass through the same swap.
Because every hook converges on the same tryReplace(), a mob's diamond axe and a chest's diamond axe roll the same way.
Picking materials: the 80 / 10 / 10 split (configurable)
We pick a TC tool matching the vanilla item's category (sword / pickaxe type, etc.), then rolls materials per part using a weighted split:
- 80% canonical: the hand-picked TC material for that tier, chosen so the result feels natural.
- 10% same-tier random: variety within the tier.
- 10% any-tier random: cross-tier variance, capped at a configurable max tier (default diamond) so you don't get random hepatizon zombies in early game.
The full canonical mappings:
| Vanilla tier |
Tool canonical |
Armor canonical |
| 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 |
Copper has no TC tool-tier of its own, so it keeps tconstruct:copper as canonical, and is matched as iron (i.e copper-replacements will have ~80% copper show up, while the rest is iron-tier).
Enchantments → TC modifiers
Pre-enchanted vanilla items get their enchantments converted to TC modifiers.
- Budget: sum vanilla enchantment levels, take
ceil(sqrt(totalLevels × 4)), cap at 7. Sharpness V Unbreaking III Mending I gets a budget of about 6.
- Modifier pool: built from your installed TC recipes, so addon modifiers are auto-included. Modifiers with unmet prerequisites are filtered.
- Specialty weighting: specialist modifiers (apply specifically to one "type" of tool, e.g: sharp) are ~8× more likely than universals. Tunable.
- Spending the budget: at each step, either level up an existing modifier (default 65% chance) or pick a new one. Bonus-slot modifiers added if budget overflows.
A skip list in the config keeps unwanted modifiers out (defaults include netherite, creative_slot, draconic, etc.).
Compatibility & extensibility
- TC addons: picked up automatically via standard tags and Forge tool actions. Tested with Tinkers' Things, TCIntegrations, Tinkers Levelling Addon, and Tinkers' Thinking.
- Addon materials: read live from
MaterialRegistry. New material drops in, it's eligible. Custom-tier materials work for armor and ranged; tools need a vanilla-tier mapping.
- Modded recipes: caught by the same scan as vanilla. Datapack recipes should be automatically handled.
- Modded loot, mob equipment, villager professions: all hit the same hooks as vanilla. No allowlist.
- JEI: integrated. Replacement ingredient cycles through valid TC tools per slot. Recipe transfer works on the vanilla 3×3, player inventory grid, TC crafting station, and any container declared in the user-extensible config.
- NOTE: Other crafting interfaces may need special handling which I haven't specifically accounted for! Please let me know if there are any issues.
Configuration
Drop the jar in your mods folder and load a world.
The defaults are quite sensible but if you want to tune, four files appear under config/ after first launch:
| File |
Format |
What it controls |
tinkersdevotion-common.toml |
TOML |
Main toggles. Independently disable vanilla-crafting removal, mob, loot, or villager replacement. Tune the parts-match threshold, loot variance, modifier specialization weight. |
tinkersdevotion/tool_exclusions.json |
JSON |
Blacklist specific TC tools per slot or action. Stops dagger from substituting for cleaver in recipes, stops slimesuit from rolling as armor loot, etc. Defaults pre-populated. |
tinkersdevotion/modifier_skip_list.json |
JSON |
TC modifier IDs that should never appear in the random enchantment pool. Defaults pre-populated. |
tinkersdevotion/item_aliases.json |
JSON |
Treat a modded item as a vanilla one (Refer to Feature #5). |
Commands
/tinkersdevotion generate re-runs the recipe scan and rewrites the generated datapack. Useful after installing or removing mods. OP level 2.
/tinkersdevotion generate reset resets the two JSON config files to defaults and regenerates. The TOML config is untouched.
The recipe datapack auto-generates on first world load, so the command is only needed if you change your mod list.
Issues & Feedback
Leave a comment or hop in the Discord to chat or ask a question. If you've found a bug or have a specific request, flag it on the GitHub issue tracker.
- I am just one guy!!
- FAQ COMING SOON.
Requirements & Compatibility
- Minecraft 1.20.1, Forge 47.4+
- Tinkers' Construct 3.11+
- Mantle 1.11+ (Tinkers' dependency, you'll have it)
- JEI 15.20+ (optional, used for recipe display and shift-click transfer)
Tested with almost all tinker's addons (at time of release here)! Friendly to any other TC addon that uses standard tags and registers its modifiers via TC's recipe system.
Modded items (if you are interested in replacing tools from other mods like epic-fight, simply-swords etc): No modded items are replaced by default, but you can add a simple mod:mytool, minecraft:vanillaItem to replace them (see Feature #5)! Built to be super friendly to everyone :) Please lmk if any issues with this!
Credits & License
Tinkers' Construct and Mantle by SlimeKnights. Without them this mod would have nothing to integrate.
License: All Rights Reserved. Short version:
- Free to include in any public or private modpack. Credit would be nice but not required.
- Free for personal use.
- Not allowed: modification, forks, re-uploads, or porting without written permission.
Full terms in LICENSE.md. For permission requests, open a GitHub issue.
评论 0
登录后参与评分
还没有评论,来抢沙发吧