Wand of Enlivingment

赋生法杖

灵感：基于 Erebus 的动画法杖这一创意，但代码完全从头编写。
用途：将方块变成活着的“赋生”生物，其行为与普通 Minecraft 实体相同——非常适合专家向/自动化整合包，可在游戏后期通过生物农场复制方块。

1.21 更新：新增物品等级、每级配置（允许/禁止）以及仅限创造模式使用的版本。现在会显示在创造模式物品栏中，方便快速测试。

工作原理

• 手持法杖对方块右键 → 方块会变成一个赋生方块实体。
• 其他模组可以捕获/复制赋生实体（例如：将 exactCopy = true 的 Industrial Foregoing 生物复制机），从而可再生地获得对应方块——具体取决于你的规则。注意：如果刷怪器不复制 NBT，则此功能无法使用。
• 移动/动画效果轻量且适合刷怪场景（表现较为克制，避免产生过多视觉干扰）。

等级（1.21+）

• 脆弱赋生法杖 – 入门等级。默认耐久度较低，适合设置进度门槛。
• 赋生法杖（普通） – 标准耐久度。
• 强效赋生法杖 – 更高耐久度。
• 创造模式赋生法杖 – 不会损坏，始终带有附魔光效，外观更加炫目。

耐久度和允许使用的方块均可通过整合包配置按等级分别设置。

配置（按等级设置允许/禁止）

你可以通过 config/wandofenlivingment-common.toml 中支持正则表达式的禁止列表，控制哪些方块可以赋生。

示例：

禁止所有非 Create 模组的内容

blockDenylist = ["^(?!create:).*$"]

禁止所有原版方块

blockDenylist = ["^minecraft:.*$"]

仅允许矿石方块，禁止其他所有内容（同时使用时，允许列表优先）

blockDenylist = ["^(?!minecraft:.*_ore)$", "^(?!myaddon:rich_ore)$"]

• 匹配模式是完整字符串正则表达式。
• 使用 ^ / $ 指定匹配起止位置，或使用 ^modid:.* 这样的简单通配模式。
• 提示：建议使用注册表 ID（例如 minecraft:stone、create:shaft）——本模组使用方块的注册表键，而非显示名称。

允许列表旨在允许动画特定方块实体，而不必启用所有方块实体。此处不支持正则表达式，必须使用完整的资源位置名称。注意：只有完整方块才能被赋予动画。

示例：

允许动画原版熔炉

blockAllowlist = ["minecraft:furnace"]

原版箱子不是完整方块，因此无法被赋予动画，所以这样设置不会生效

blockAllowlist = ["minecraft:chest"]

启动配置（按等级设置耐久度）

耐久度通过 config/wandofenlivingment-startup.toml 设置。

[General]
    #number of uses per fragile wand
    fragileWandDurability = 4
    #number of uses per wand
    wandDurability = 24
    #number of uses per greater wand
    greaterWandDurability = 64

注意：创造模式法杖始终不会损坏

合成配方与整合包适配

本模组面向专家向/进度类整合包。默认情况下：

• 不提供生存模式配方。整合包作者应通过数据包/KubeJS/CraftTweaker 等添加配方或进度门槛。
• 1.21 版本提供创造模式标签页，方便快速测试。

配方示例见此处：https://github.com/arketec/wandofenlivingment/tree/master/examples

由 MuggleOrWizard 制作的优秀整合包使用了这个模组（1.21.1）：
Ozone Skyblock Reborn 2

备注与兼容性

• 加载器 / Minecraft 版本：NeoForge 1.21（当前版本）。旧版 Forge 1.20.1 构建也可用，但 1.21 的渲染内部机制有所变化——请为你的整合包选择对应文件。
• 性能：专为适合建造刷怪农场而设计。动画效果经过限制且开销低；实体的行为与原版生物一致，便于与其他模组兼容。
• 鸣谢：概念灵感来自 Erebus 的 Wand of Animation；本模组的实现完全使用原创代码。

常见问题

问：可以按等级添加/移除方块吗？答：可以——使用各等级的允许/拒绝列表即可。大多数整合包会先广泛拒绝，再添加经过筛选的列表。默认情况下，普通魔杖和强效魔杖允许除方块实体以外的所有方块；脆弱魔杖则只允许 Minecraft 原版方块。

问：这会复制带有数据的 Tile/BlockEntities 吗？答：模组支持按需将方块实体方块加入白名单；由整合包作者决定哪些方块适合赋予生命。

问：我捕获了一个方块生物，但我的刷怪笼只会生成石头生物。答：用于复制的刷怪器也必须支持复制 NBT 数据。Industrial Foregoing 的 Mob Duplicator 可以通过在其配置中设置 exactCopy = true 来实现：

# config/industrialforegoing/machine-agriculture-husbandry.toml
[MachineAgricultureHusbandryConfig.MobDuplicatorConfig]

  #Exact Copy to spawn - Default: [false]
  exactCopy = true

问：可以用于整合包吗？答：可以——欢迎将其加入整合包。若能附上返回此页面的链接，我们将不胜感激。