CloneBang

CloneBang

CloneBang 是一款 Minecraft Fabric 模组，让 /clone 指令更易使用。它提供专用的烈焰棒选择工具，允许你标记区域的两个角落，并帮助你复制、执行、保存和重新加载克隆选区，无需手动输入坐标。

功能

• 使用 /CloneTool 指令获取专用克隆工具
• 通过左键、Shift+左键或右键选择两个位置
• 从选区生成、复制和执行 /clone 指令
• 使用粒子或模组原生线条渲染器渲染选区
• 按名称保存选中的结构并加载最近保存的结构
• 在执行克隆指令前预览放置位置
• 通过游戏内设置界面配置选择行为、渲染模式、排除方块和本地数据
• 包含多语言资源，包括英语和韩语
• 包含用于未来 Paper 插件集成的保留网络桥接

需求

项目	版本
Minecraft	26.1.2
Fabric Loader	0.19.2 或更新版本
Fabric API	0.147.0+26.1.2
Java	25 或更新版本
模组 ID	clonebang
当前版本	1.0.0

安装

1. 安装 Fabric Loader 和 Fabric API。
2. 从发布文件中下载 clonebang-1.0.0.jar。
3. 将 jar 文件放入 Minecraft mods 文件夹中。
4. 启动游戏并运行 /CloneTool 以获取克隆工具。

构建的模组 jar 生成于 build/libs/clonebang-1.0.0.jar。

用法

1. 运行 /CloneTool 以获取克隆工具。
2. 手持工具并左键点击第一个位置。
3. 使用 Shift+左键或右键设置第二个位置。
4. 按 Ctrl + C 复制生成的 /clone 指令，或按 Ctrl + V 在你注视的方块位置执行它。

默认快捷键

快捷键	操作
Shift + Alt	打开设置
Shift + H	打开帮助
Shift + S	保存当前选区
Shift + E	加载保存的结构
Alt + E	预览放置
Ctrl + C	复制 /clone 指令
Ctrl + V	执行 /clone 指令
Alt + D	清除选区
Ctrl + Z / Ctrl + Y	为放置历史预留的撤销/重做钩子

本地数据

CloneBang 在 Minecraft 游戏目录下存储设置和已保存的结构元数据。

moddata/clonebang/
moddata/clonebang/config.properties
moddata/clonebang/structures/*.properties

设置界面可以打开数据文件夹、重置配置以及清除已保存的结构数据。

构建

Windows：

.\gradlew.bat build

macOS/Linux：

./gradlew build

构建成功后，可分发的 jar 和源码 jar 会创建在 build/libs/ 中。

build/libs/clonebang-1.0.0.jar
build/libs/clonebang-1.0.0-sources.jar

CI

此仓库包含一个 GitHub Actions 工作流，在推送和拉取请求时运行。它使用 Java 25 构建项目，并将 build/libs/ 中生成的文件作为工作流产物上传。

Paper 插件桥接

CloneBang 包含一个为未来 Paper 服务器插件集成预留的协议。该模组不需要插件；当未检测到兼容插件时，它会继续使用本地/客户端回退行为。

协议详情请参见 docs/plugin-bridge.md。

许可证

本项目使用 CC0-1.0 许可证。