EnchantWorks

English

Enchant Works combines configurable anvil rules with five custom enchantments and extensions to selected vanilla enchantments. It is intended for modpacks that need control over repair costs, enchantment combinations, and equipment progression.

Requirements

Install Enchant Works and its dependencies on both client and server. These requirements apply to the Minecraft 1.20.1 branch.

Anvil and experience rules

• Remove the Too Expensive cap and accumulated prior-work penalty for selected items.
• Choose whitelist mode to unlock only matching items, or blacklist mode to preserve vanilla limits for the exceptions.
• Match an item by registry ID, an item tag prefixed with #, or an entire mod prefixed with @.
• Enable fixed-base XP calculation for anvil/enchanting costs. With the default base of 30, a three-level cost uses the XP difference between levels 30 and 27 instead of charging the much larger difference at a high player level.
• Enable cheap renaming so a rename-only anvil operation has a one-level cost.

These are configurable mechanics. Installing the mod can change the cost of existing repair and enchantment workflows, so check the generated defaults when balancing a pack.

Enchantment filtering

The allowlist permits specified item/enchantment combinations beyond vanilla compatibility. The denylist rejects prohibited combinations, including clearing an invalid anvil output. A separate list disables enchantments globally for application through the anvil and enchanting table.

Combination rules use target ; enchantment IDs:

minecraft:stick ; minecraft:knockback, minecraft:sharpness
#minecraft:pickaxes ; minecraft:mending
@create ; minecraft:mending
minecraft:stick ; *

Place each rule in the appropriate allowlist or denylist. * and ALL match all enchantments; the examples are syntax examples, not commands to run. Disabling one of this mod's own registered enchantments is also subject to the restart requirements below.

Custom enchantments

Smelter multiplier entries accept rules such as 2x #forge:ores and 3x minecraft:raw_iron; the first matching rule supplies the multiplier. The default ore/raw-material rules double eligible output.

Omni Tool can appear in the third enchanting-table offer when its displayed level is at least 30, with a configurable chance (default 10%). The included shapeless recipe also creates its enchanted book from a netherite pickaxe, netherite axe, netherite shovel, shears, and a book. The recipe produces no usable result when Omni Tool is disabled.

Vanilla enchantment extensions

• Infinity bows: can be drawn and fired without carrying an arrow.
• Infinity buckets: preserve their state when used. A filled bucket can repeatedly place its fluid; an empty bucket can remove fluid while remaining empty. The mod also handles Forge bucket fluid operations.
• Channeling II: with Better Channeling enabled, removes the thunderstorm requirement in the trident lightning check. Other trident hit conditions still apply; this is not unconditional lightning from every attack.

Getting started

1. Launch with the dependencies and enter a world.
2. Press F6 to open KineticCore's configuration center, then select Enchant Works. Key bindings can be changed in Controls.
3. Configure the server-side anvil/enchantment page for costs, filters, enchantment registration, and balancing values.
4. Use the separate client-side Sixth Sense page for outline colors and scanning preferences.
5. Try an anvil combination or enchanted tool against the intended items before distributing the pack configuration.

The main file is config/kineticcore/anvilenchantments.toml. Its generated comments document individual fields and rule syntax.

Saving and multiplayer behavior

• Saving the configuration page refreshes the applicable values and rule caches.
• Enchantment registration switches and registration-level exclusions require a full game/server restart. Use matching registration settings on client and server.
• Server-authoritative settings are not ordinary client preferences. When connected to a remote server without a supported secure editing path, that page cannot be edited from the client; maintain the configuration on the server.
• Sixth Sense display preferences remain locally editable when connected to a server.

简体中文

Enchant Works（附魔工坊）整合铁砧规则、五种自定义附魔和部分原版附魔扩展，适合需要统一维修成本、附魔搭配与装备成长的整合包。

运行环境

客户端和服务端均应安装附魔工坊及前置；本文列出的版本范围针对 Minecraft 1.20.1，不表示已适配更新版本。

铁砧与经验规则

• 对指定物品解除“过于昂贵”限制，移除反复维修累积的惩罚。
• 白名单模式只为匹配物品解除限制；黑名单模式为名单内物品保留原版限制，其余解除。
• 支持按物品 ID、#物品标签、@模组ID 选择目标。
• 可启用固定基准等级的经验点数计费。默认基准为 30：标价 3 级时，按 30 级降至 27 级的经验差计算，避免高等级玩家被扣除过多经验。
• 可启用廉价重命名，使只修改名称的铁砧操作按 1 级计费。

这些机制都有对应配置。安装后可能改变已有装备的维修和附魔成本，整合包作者应先核对生成的默认设置。

附魔允许与禁止规则

白名单可允许原版通常不接受的物品与附魔组合；黑名单用于禁止组合，并会清空不符合规则的铁砧产物。另有全局禁用列表，限制指定附魔通过铁砧和附魔台添加。

组合规则格式为 目标 ; 附魔ID：

minecraft:stick ; minecraft:knockback, minecraft:sharpness
#minecraft:pickaxes ; minecraft:mending
@create ; minecraft:mending
minecraft:stick ; *

把规则填入对应的白名单或黑名单即可；以上是配置语法示例，不是聊天命令。多个附魔用英文逗号分隔，* 和 ALL 表示全部附魔。禁用本模组自己的注册附魔时，还需遵守下方的重启要求。

五种自定义附魔

熔炼产出规则支持 2x #forge:ores、3x minecraft:raw_iron 等写法，采用第一条匹配规则的倍率；默认矿石与粗矿材料规则为双倍产出。

万能工具可在附魔台第三档显示等级至少为 30 时按概率出现，默认概率为 10%。模组还提供无序合成：下界合金镐、下界合金斧、下界合金锹、剪刀和书合成万能工具附魔书。禁用该附魔后，配方不再产出有效成品。

原版附魔扩展

• 无限弓： 背包没有箭矢时也能拉弓射击。
• 无限桶： 使用后保持原状态；装有液体的桶可重复放置液体，空桶可吸取液体并继续保持为空桶，也处理 Forge 桶流体接口的操作。
• 引雷 II： 开启强化引雷后，三叉戟召雷判定不再要求雷暴天气；其他命中条件仍然存在，并非任意攻击都无条件产生闪电。

上手流程

1. 安装前置并进入世界。
2. 默认按 F6 打开 KineticCore 配置中心，选择附魔工坊；快捷键可在控制设置中修改。
3. 在服务端铁砧与附魔页面设置费用、组合过滤、附魔注册开关及数值。
4. 在独立的客户端第六感页面调整扫描参数与轮廓颜色。
5. 用实际装备检查铁砧成品与附魔效果，再将配置用于整合包。

主配置文件为 config/kineticcore/anvilenchantments.toml，自动生成的注释包含字段解释和语法示例。

保存与多人游戏

• 配置页面保存后会刷新相应数值和规则缓存。
• 附魔注册开关、注册级禁用项需要完整重启游戏或服务器；客户端与服务端应使用一致的注册设置。
• 服务端规则不是普通客户端偏好。连接远程服务器而没有可用的安全编辑通道时，客户端不能修改该页面，应在服务端维护配置。
• 第六感显示偏好在连接服务器时仍可本地调整。