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

1. Install Fabric Loader and Fabric API.
2. Download clonebang-1.0.0.jar from the release files.
3. Place the jar file in your Minecraft mods folder.
4. 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

1. Run /CloneTool to receive the clone tool.
2. Hold the tool and left click the first position.
3. Set the second position with Shift+left click or right click.
4. 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.