建筑手杖 1.12

建筑魔杖（Forge 1.12.2）

这是 ThetaDev 的建筑魔杖（版本 2.12，原本为 Minecraft 1.20.2 制作）的 Forge 1.12.2 移植版。

使用建筑魔杖，你可以一次性放置多个方块（最多 1024 个），在你所面对的方向上延伸你的建筑。你可以用额外的核心升级魔杖，从而能够穿透墙壁放置方块、在空中凭空创造方块，或者快速破坏大量方块。

功能特性

• 4 种魔杖：石制、铁制、钻石制、无尽（耐久度/限制与原版一致）
• 3 种魔杖核心：建筑（默认）、天使、破坏
• 完整的选项系统：方向锁定、放置方向、替换、匹配模式、随机模式和核心切换，每个魔杖独立存储在 NBT 中
• 撤销：按住潜行 + Ctrl 并右键点击以撤销上一次操作
• 方块放置预览
• 选项界面：潜行 + Ctrl + 右键点击（在空中）打开
• 容器支持：潜影盒以及任何具有 Forge 物品处理器能力的物品都可以提供建筑方块
• 副手优先：副手中的方块会优先放置
• JEI 集成（当安装了 1.12.2 版本的 JEI 时生效）
• 自定义统计："使用魔杖放置的方块"
• 9 种语言（包括中文）

额外选项（原版没有）：强制放置

选项界面包含一个额外的开关 "忽略碰撞 & 强制放置"（默认关闭）。启用后，魔杖甚至可以在地面上有生物的地方放置方块：

• 挡路的怪物/动物会被移除，但不会掉落战利品或经验值；
• 挡路的玩家（包括你自己）会被向上推一格。

使用方法

操作	输入
延伸建筑	右键点击墙面（需要背包中有匹配的方块）
打开选项界面	潜行 + Ctrl + 右键点击（在空中）
更改方向锁定	Ctrl + 鼠标滚轮
切换魔杖核心	潜行 + Ctrl + 左键点击（在空中）
撤销上一次操作	潜行 + Ctrl + 右键点击一个已放置的方块（绿色预览框）
安装核心	将核心与魔杖一起放入合成网格

配置

配置文件生成在 config/ 文件夹中：

• constructionwand-server.cfg — 每种魔杖的耐久度/限制、天使/破坏范围、创造模式限制、最大范围、撤销历史、相似方块、方块实体黑/白名单
• constructionwand-client.cfg — OPTKEY（默认 29 = 左 Ctrl，LWJGL2 按键代码）、潜行+OPT 模式和潜行+OPT 界面开关

与原版 2.12 的差异

• 移除：捆绑包（该物品在 1.12.2 中不存在）、抗熔岩无尽魔杖（在 1.12.2 中无法实现）
• Botania 集成通过反射实现（适用于 1.12.2 版本的 Botania）
• 新增："忽略碰撞 & 强制放置"选项（见上文）
• 在计数/取用物资时按物品 ID 匹配物品，因此带有元数据/NBT 的模组方块可以正常工作

构建

要求：

• JDK 17+（Gradle 8.14.3）
• JDK 8 工具链（自动配置，或在 gradle.properties 中设置 org.gradle.java.installations.paths 指向本地 JDK 8）

./gradlew build

编译好的模组 jar 文件位于 build/libs/ConstructionWand-1.12.2-1.12.2-2.12.jar。将其放入 Forge 1.12.2 安装的 mods/ 文件夹中。

鸣谢

• 原版模组：ThetaDev/ConstructionWand， Copyright (c) 2021 ThetaDev，采用 MIT 许可证
• 1.12.2 移植版：见 LICENSE 文件

许可证

MIT 许可证 — 见 LICENSE。