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 或更高版本 |
| Mod ID |
clonebang |
| 当前版本 |
1.0.0 |
安装
- 安装 Fabric Loader 和 Fabric API。
- 从发布文件中下载
clonebang-1.0.0.jar。
- 将 jar 文件放入你的 Minecraft
mods 文件夹中。
- 启动游戏并运行
/CloneTool 以获取克隆工具。
构建生成的模组 jar 包位于 build/libs/clonebang-1.0.0.jar。
使用方法
- 运行
/CloneTool 获取克隆工具。
- 手持工具并对第一个位置进行左键点击。
- 通过 Shift+左键点击或右键点击设置第二个位置。
- 按
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 将设置和保存的结构元数据存储在游戏目录下的 moddata 文件夹中。
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 许可证。
CloneBang
CloneBang is a Minecraft Fabric mod that makes the /clone command easier to use. It provides a dedicated blaze rod selection tool, lets you mark two corners of an area, and helps you copy, run, save, and reload clone selections without manually typing coordinates.
Features
- Get the dedicated clone tool with the
/CloneTool command
- Select two positions with left click, Shift+left click, or right click
- Generate, copy, and run
/clone commands from the selected area
- Render selections with particles or the mod's native line renderer
- Save selected structures by name and load recent saved structures
- Preview placement before running the clone command
- Configure selection behavior, render mode, excluded blocks, and local data from an in-game settings screen
- Includes multilingual resources, including English and Korean
- Includes a reserved network bridge for future Paper plugin integration
Requirements
| Item |
Version |
| Minecraft |
26.1.2 |
| Fabric Loader |
0.19.2 or newer |
| Fabric API |
0.147.0+26.1.2 |
| Java |
25 or newer |
| Mod ID |
clonebang |
| Current Version |
1.0.0 |
Installation
- Install Fabric Loader and Fabric API.
- Download
clonebang-1.0.0.jar from the release files.
- Place the jar file in your Minecraft
mods folder.
- Launch the game and run
/CloneTool to receive the clone tool.
The built mod jar is generated at build/libs/clonebang-1.0.0.jar.
Usage
- Run
/CloneTool to receive the clone tool.
- Hold the tool and left click the first position.
- Set the second position with Shift+left click or right click.
- Press
Ctrl + C to copy the generated /clone command, or press Ctrl + V to run it at the block you are looking at.
Default Shortcuts
| Shortcut |
Action |
Shift + Alt |
Open settings |
Shift + H |
Open help |
Shift + S |
Save the current selection |
Shift + E |
Load a saved structure |
Alt + E |
Preview placement |
Ctrl + C |
Copy the /clone command |
Ctrl + V |
Run the /clone command |
Alt + D |
Clear the selection |
Ctrl + Z / Ctrl + Y |
Reserved undo/redo hooks for placement history |
Local Data
CloneBang stores settings and saved structure metadata under the Minecraft game directory.
moddata/clonebang/
moddata/clonebang/config.properties
moddata/clonebang/structures/*.properties
The settings screen can open the data folder, reset the config, and clear saved structure data.
Building
Windows:
.\gradlew.bat build
macOS/Linux:
./gradlew build
After a successful build, the distributable jar and sources jar are created in build/libs/.
build/libs/clonebang-1.0.0.jar
build/libs/clonebang-1.0.0-sources.jar
CI
This repository includes a GitHub Actions workflow that runs on pushes and pull requests. It builds the project with Java 25 and uploads the generated files from build/libs/ as workflow artifacts.
Paper Plugin Bridge
CloneBang includes a reserved protocol for future Paper server plugin integration. The mod does not require the plugin; when no compatible plugin is detected, it continues to use its local/client-side fallback behavior.
See docs/plugin-bridge.md for protocol details.
License
This project is licensed under CC0-1.0.
评论 0
登录后参与评分
还没有评论,来抢沙发吧