icon	hand-wave
description	A Paper plugin of building blocks for custom items, tools and abilities
layout	width title description tableOfContents outline pagination default visible true visible true visible true visible true visible true

Welcome

CommandUtils adds around 130 commands that fill the gaps between vanilla commands and what a custom item, block or ability actually needs — breaking a 3×3 of blocks, running commands on a timer, stealing a potion effect, giving a player a fake health bar.

Every command works from command blocks, datapacks, the console, and plugins such as ExecutableItems and ExecutableBlocks. Nothing here needs a Java plugin of your own.

Jump right in

Quickstart	Install the plugin and run your first command	quickstart.md
Commands	The full command reference, by category	commands
Config	Enable, rename and tune commands	config.md

What it's for

You want	Use
A hammer that breaks a 3×3	Break In Facing
A vein-mining pickaxe	Break In Vein
A harvester hoe that replants	Select Blocks
An ability on a cooldown	Cooldown Command
A channelled effect over several seconds	Loop
A weighted loot table	Weighted Random
Buffs that don't overwrite each other	Effect
Values read back into other plugins	Placeholders

Requirements

• Paper 1.20 or newer, Java 21
• No hard dependencies. A handful of commands need an extra plugin and are simply not registered without it — PlaceholderAPI, CoreProtect and ProtocolLib are each used by one or two
• Claim and region protection is respected automatically when GriefPrevention, Factions or WorldGuard is installed