视觉铁砧

视觉铁砧 让 Minecraft 的铁砧感觉像真正的物理工作台，而不是临时的菜单界面。

放入铁砧的物品在 GUI 关闭后仍会保留，并会以可见的方式渲染在方块顶部。计算结果也可以显示在铁砧上方，使铁砧真正成为工坊、工厂、附魔室和多人游戏建筑的一部分。

视觉铁砧还包含一个广泛的可选配置系统，用于更改铁砧机制、附魔、修复、自动化、渲染、经验消耗、命名等功能。

几乎所有改变游戏玩法的功能在默认情况下都是禁用的。 您可以仅为了持久化和可见的铁砧而安装视觉铁砧，而不会改变原版的平衡性。

配置文件存储于：

config/visualanvil-server.toml
config/visualanvil-client.toml

服务器/通用配置控制游戏玩法和自动化。客户端配置仅控制视觉呈现和附魔等级显示。

核心功能

放入铁砧的物品在关闭菜单后仍会存储在其中。

两个输入物品都可以物理渲染在铁砧顶部，当前计算出的结果可以显示在它们上方。

多个玩家可以使用同一个铁砧，同时其物品栏和结果保持同步。

存储的物品在铁砧的普通、开裂和损坏状态变化中都能保留。

下落的铁砧会保留其存储的内容，如果下落的铁砧碎裂，其行为是可配置的。

漏斗和兼容的自动化系统可以将物品存入铁砧。

许多通常硬编码的铁砧机制可以选择性地自定义。

完整配置参考

• 游戏玩法

  * removeTooExpensive = false — 启用时彻底移除原版的 过于昂贵！ 机制。这移除了实际的限制，而不仅仅是文本。
  * maximumAnvilCost = 40 — 设置允许的最大铁砧等级费用。支持 1 到 100000 之间的值。当完全禁用过于昂贵时忽略此设置。
  * disableXpCost = false — 使铁砧操作消耗 0 个经验等级。
  * semiDisableXpCost = false — 玩家仍然需要达到通常所需的等级，但成功操作仅消耗 1 个等级。
  * anvilXpCostMultiplier = 1.0 — 乘以计算出的铁砧经验费用。范围 0.0–10.0。
  * disablePriorWorkPenalty = false — 移除 Minecraft 中反复加工物品带来的“先前工作”惩罚。
  * priorWorkPenaltyMultiplier = 1.0 — 乘以先前工作惩罚，而不是完全移除。范围 0.0–10.0。
  * 附魔

    * allowOverleveledEnchantments = false — 允许通过铁砧合并的附魔超过其正常的原版最高等级。
    * maxAnvilEnchantmentLevel = 255 — 通过铁砧超等级化可获得的最大附魔等级。范围 1–255。
    * allowVanillaLevelStacking = true — 保留原版的同级叠加，例如 锋利 IV + 锋利 IV = 锋利 V。
    * allowLevelStacking = false — 启用完全加成的附魔合并。例如，IV + IV = VIII 和 IV + III = VII。
    * 当启用加成堆叠时，它优先于原版堆叠。
    * allowIncompatibleEnchantments = false — 允许通常互斥的附魔共存。
    * allowTreasureEnchantmentCombining = false — 放宽通过附魔书提供的宝藏附魔的常规物品支持限制。
    * allowAnyEnchantOnAnyItem = false — 允许将附魔应用于通常不支持的物品上。
    * customNaturalEnchantmentLevels = false — 启用自定义的自然附魔等级范围。
    * naturalEnchantmentMinLevel = 1 — 自然生成附魔的最低等级。范围 1–255。
    * naturalEnchantmentMaxLevel = 255 — 自然生成附魔的最高等级。范围 1–255。
    * 自然等级自定义影响支持的自然附魔生成途径，同时保持附魔资格本身不变。
  * 物品修复与命名

    * repairPercentPerMaterial = 25 — 每块有效修复材料恢复物品最大耐久度的百分比。范围 1–100%。
    * singleMaterialFullRepair = false — 使一块有效的修复材料完全修复物品。
    * universalRepairMaterial = "" — 可选的物品注册 ID，可以修复任何可修复物品。默认为空，表示禁用。
    * 示例：minecraft:diamond。
    * consumeRepairMaterials = true — 控制是否消耗修复材料。禁用时，适用的材料可以重复使用。
    * freeRenaming = false — 使纯物品重命名操作不消耗经验。
    * renameXpCost = 1 — 当免费重命名禁用时，设置重命名的经验费用。范围 0–100000。
    * maxItemNameLength = 50 — 自定义物品名称的最大长度。范围 1–256。
    * allowFormattedNames = false — 允许使用 & 的旧式格式代码，启用彩色和格式化的自定义物品名称。
  * 物理铁砧

    * repairAnvilWithIronIngots = false — 允许通过使用配置的修复材料对损坏的铁砧方块进行潜行右键点击来修复它们自身。
    * anvilRepairItem = "minecraft:iron_ingot" — 用于物理修复铁砧的物品的注册 ID。
    * anvilRepairStagesPerItem = 1 — 每个物品修复的损伤阶段数。范围 1–2。
    * fullRepairWithOneRepairItem = false — 使一件修复物品立即将损坏/开裂的铁砧恢复为普通铁砧。
    * disableAnvilDamage = false — 防止铁砧因使用而损失耐久度/受到损伤。
    * anvilDamageChance = 0.12 — 铁砧在操作后变得损坏的总体几率。范围 0.0–1.0。
    * useOperationSpecificDamageChances = false — 为不同类型的操作启用单独的损坏概率。
    * repairDamageChance = 0.12 — 物品修复操作后的损坏几率。
    * enchantCombineDamageChance = 0.12 — 附魔合并操作后的损坏几率。
    * renameDamageChance = 0.12 — 重命名操作后的损坏几率。
    * disableAnvilUseSound = false — 禁用正常的铁砧使用声音，而不禁用无关的坠落/碎裂声音。
    * anvilUseSoundVolume = 1.0 — 控制铁砧使用声音的音量。范围 0.0–4.0。
    * fallingBrokenContentsMode = "DROP" — 控制当下落铁砧被摧毁而不是成功落地时，存储内容会发生什么。
    * 支持的选项有 DROP（掉落）、PRESERVE（保留）和 VOID（消失）。
  * 客户端渲染

    * renderInputs = true — 在铁砧上渲染两个存储的输入物品。
    * renderResult = true — 渲染计算出的输出结果。
    * bobResult = true — 使渲染的结果轻微上下浮动。
    * resultBobSpeed = 1.0 — 结果浮动速度。范围 0.0–20.0。
    * resultBobAmplitude = 0.04 — 结果浮动距离。范围 0.0–1.0。
    * resultRotationSpeed = 1.0 — 显示结果的旋转速度。范围 0.0–20.0。
    * resultScale = 1.0 — 结果物品的渲染比例。范围 0.05–5.0。
    * resultVerticalOffset = 0.0 — 结果的垂直位置调整。范围 -2.0–2.0。
    * resultFullbright = false — 以最大光照渲染结果。
    * resultDisplayDurationTicks = 0 — 已取走的结果继续显示的时间。0 表示它保持到输入改变为止。范围 0–72000 刻。
    * inputScale = 1.0 — 输入物品的渲染比例。范围 0.05–5.0。
    * inputLeftOffset = -0.19 — 左侧输入的位置调整。范围 -2.0–2.0。
    * inputRightOffset = 0.19 — 右侧输入的位置调整。范围 -2.0–2.0。
    * inputVerticalOffset = 0.0 — 两个输入的垂直位置调整。范围 -2.0–2.0。
    * inputRotationDegrees = 0.0 — 输入物品的旋转调整。范围 -360°–360°。
    * bobInputs = false — 为渲染的输入启用浮动效果。
    * inputBobSpeed = 1.0 — 输入浮动速度。范围 0.0–20.0。
    * inputBobAmplitude = 0.02 — 输入浮动距离。范围 0.0–1.0。
    * inputFullbright = false — 以最大光照渲染输入物品。
  * 客户端附魔显示

    * romanEnchantmentLevels = true — 使用罗马数字显示附魔等级，包括超出原版正常范围直至 255 / CCLV 的等级。禁用以使用常规阿拉伯数字，例如 锋利 25。

配置优先级

某些设置有意覆盖其他设置。

当 disableXpCost 启用时，它优先于 semiDisableXpCost。

当 allowLevelStacking 启用时，加成堆叠优先于 allowVanillaLevelStacking。

当加成堆叠禁用且原版堆叠启用时：

IV + IV = V
IV + III = IV

当加成堆叠启用时：

IV + IV = VIII
IV + III = VII

当两种堆叠系统都禁用时：

IV + IV = IV
IV + III = IV

结果随后受到附魔正常最高等级的限制，或者在启用超等级化时受 maxAnvilEnchantmentLevel 的限制。

注意：

视觉铁砧的设计旨在安装时不会自动改变原版铁砧的平衡性。

默认情况下，诸如移除过于昂贵、改变铁砧损伤和自定义自然附魔等级等机制都是禁用的。

视觉铁砧的主要功能：持久化内容、可见物品和多人同步，不需要这些游戏玩法的更改即可工作。

这意味着服务器所有者可以将视觉铁砧用作纯视觉/工作台改进，或者启用个别机制将其转变为更深度的铁砧大修。