> For the complete documentation index, see [llms.txt](https://sivils.gitbook.io/sivils/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sivils.gitbook.io/sivils/commandutils/commands.md).

# Commands

All of the commands provided by the plugin

{% hint style="info" %}
Arguments in \<arrows> are required; arguments in \[\<brackets>] are optional. When a page lists more than one **Usage** line, each line is a separate valid form of the command.
{% endhint %}

Every command can be enabled, disabled or aliased in [config.yml](/sivils/commandutils/config.md), and every one of them is built to be run from command blocks, datapacks, the console, and plugins such as ExecutableItems and ExecutableBlocks.

## Things worth knowing

* Arguments that appear everywhere — worlds, locations, slots, block whitelists, durations — are documented once under [Arguments](/sivils/commandutils/arguments.md).
* Commands that take a **Player** run their protection checks against that player, so claims and regions are respected.
* Several commands run **as the sender** rather than taking a player argument. Call those with `/execute as <player> run ...`.
* State kept in memory — loops, cooldowns, variables, multipliers — does not survive a restart. Pages say so where it matters.

## Breaking blocks

| Command                                                                                                                                       | Shape                                  |
| --------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------- |
| [Break In Radius](/sivils/commandutils/commands/break-in-radius.md)                                                                           | A cube around a point                  |
| [Break In Facing](/sivils/commandutils/commands/break-in-facing.md)                                                                           | A wall in front of the player          |
| [Break In XYZ](/sivils/commandutils/commands/break-in-xyz.md)                                                                                 | A cuboid oriented to the player's view |
| [Break In Vein](/sivils/commandutils/commands/break-in-vein.md)                                                                               | A connected vein of the same block     |
| [Break And Replant](/sivils/commandutils/commands/break-and-replant.md)                                                                       | Crops, harvested and replanted         |
| [Break Block Multiply Drops](/sivils/commandutils/commands/break-block-multiply-drops.md)                                                     | One block, multiplied loot             |
| [Break In Facing Log CoreProtect](/sivils/commandutils/commands/break-in-facing-log-coreprotect.md)                                           | Break In Facing, logged to CoreProtect |
| [Remove In Radius](/sivils/commandutils/commands/remove-in-radius.md) / [Remove In Facing](/sivils/commandutils/commands/remove-in-facing.md) | The same shapes, with no drops         |
| [Spawn Block Breaker](/sivils/commandutils/commands/spawn-block-breaker.md)                                                                   | A projectile that tunnels as it flies  |

## Changing blocks

| Command                                                                                                                                                                                                                                                                                 | Purpose                                  |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------- |
| [Replace In Radius](/sivils/commandutils/commands/replace-in-radius.md) / [Replace In Facing](/sivils/commandutils/commands/replace-in-facing.md) / [Replace In XYZ](/sivils/commandutils/commands/replace-in-xyz.md) / [Replace In XZ](/sivils/commandutils/commands/replace-in-xz.md) | Swap blocks in an area                   |
| [Replace In Radius If Block Relative](/sivils/commandutils/commands/replace-in-radius-if-block-relative.md)                                                                                                                                                                             | Swap only where the neighbours match     |
| [Set Temp Block](/sivils/commandutils/commands/set-temp-block.md)                                                                                                                                                                                                                       | Place a block that reverts itself        |
| [Block Prison](/sivils/commandutils/commands/block-prison.md)                                                                                                                                                                                                                           | Cage a player in temporary blocks        |
| [Block Cycle](/sivils/commandutils/commands/block-cycle.md)                                                                                                                                                                                                                             | Oxidise or wax copper                    |
| [Block Gravity](/sivils/commandutils/commands/block-gravity.md)                                                                                                                                                                                                                         | Stop blocks falling                      |
| [Waterlog](/sivils/commandutils/commands/waterlog.md)                                                                                                                                                                                                                                   | Add or remove water inside blocks        |
| [Bone Meal Block](/sivils/commandutils/commands/bone-meal-block.md)                                                                                                                                                                                                                     | Bone meal an area                        |
| [Place Block From Inv](/sivils/commandutils/commands/place-block-from-inv.md) / [Place Block From Slot](/sivils/commandutils/commands/place-block-from-slot.md)                                                                                                                         | Place a block a player pays for          |
| [Highlight Blocks](/sivils/commandutils/commands/highlight-blocks.md)                                                                                                                                                                                                                   | Mark matching blocks with particles      |
| [Glow Blocks](/sivils/commandutils/commands/glow-blocks.md)                                                                                                                                                                                                                             | Make matching blocks glow for a set time |

## Custom tools

| Command                                                                       | Purpose                                         |
| ----------------------------------------------------------------------------- | ----------------------------------------------- |
| [Select Blocks](/sivils/commandutils/commands/select-blocks.md)               | Run a list of functions on each block in a cube |
| [Select Blocks Facing](/sivils/commandutils/commands/select-blocks-facing.md) | The same, on the wall in front of the player    |
| [Select Items](/sivils/commandutils/commands/select-items.md)                 | Run functions on dropped items                  |
| [Smelt Item](/sivils/commandutils/commands/smelt-item.md)                     | Cook dropped items where they lie               |

## Control flow

| Command                                                                                                                                       | Purpose                                 |
| --------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------- |
| [If](/sivils/commandutils/commands/if.md) / [Precise If](/sivils/commandutils/commands/precise-if.md)                                         | Run commands when a condition holds     |
| [While](/sivils/commandutils/commands/while.md)                                                                                               | Repeat for as long as a condition holds |
| [Loop](/sivils/commandutils/commands/loop.md)                                                                                                 | Repeat a set number of times            |
| [Run Command Later](/sivils/commandutils/commands/run-command-later.md)                                                                       | Run after a delay                       |
| [Run Command When](/sivils/commandutils/commands/run-command-when.md)                                                                         | Wait for a condition, then run once     |
| [Run Command For](/sivils/commandutils/commands/run-command-for.md)                                                                           | Run once per player                     |
| [Cooldown Command](/sivils/commandutils/commands/cooldown-command.md)                                                                         | Run only if a cooldown has expired      |
| [Weighted Random](/sivils/commandutils/commands/weighted-random.md) / [Chance Random Run](/sivils/commandutils/commands/chance-random-run.md) | Run by chance                           |
| [Temp Var](/sivils/commandutils/commands/temp-var.md) / [Temp Player Var](/sivils/commandutils/commands/temp-player-var.md)                   | Store values between commands           |
| [Parse Placeholder](/sivils/commandutils/commands/parse-placeholder.md) / [Trim Command](/sivils/commandutils/commands/trim-command.md)       | Placeholder and command helpers         |

## Players

| Command                                                                                                                                                                                                                                                                         | Purpose                           |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------- |
| [Health](/sivils/commandutils/commands/health.md) / [Food](/sivils/commandutils/commands/food.md) / [Saturation](/sivils/commandutils/commands/saturation.md) / [Oxygen](/sivils/commandutils/commands/oxygen.md)                                                               | Vitals                            |
| [Set Visual Hearts](/sivils/commandutils/commands/set-visual-hearts.md)                                                                                                                                                                                                         | Show a fake health bar            |
| [Set Flight](/sivils/commandutils/commands/set-flight.md) / [Flight Speed](/sivils/commandutils/commands/flight-speed.md) / [Set Gliding](/sivils/commandutils/commands/set-gliding.md)                                                                                         | Movement in the air               |
| [Stun](/sivils/commandutils/commands/stun.md) / [Disable Jump](/sivils/commandutils/commands/disable-jump.md) / [Disable Sprint](/sivils/commandutils/commands/disable-sprint.md) / [Disable Shield](/sivils/commandutils/commands/disable-shield.md)                           | Restrict a player                 |
| [Set Water Walk](/sivils/commandutils/commands/set-water-walk.md) / [Set Water Float](/sivils/commandutils/commands/set-water-float.md)                                                                                                                                         | Movement in water                 |
| [Set Held Slot](/sivils/commandutils/commands/set-held-slot.md) / [Lock Held Slot](/sivils/commandutils/commands/lock-held-slot.md)                                                                                                                                             | Control the hotbar                |
| [Mix Inventory](/sivils/commandutils/commands/mix-inventory.md) / [Prevent Mix Inventory](/sivils/commandutils/commands/prevent-mix-inventory.md)                                                                                                                               | Scramble an inventory, or ward it |
| [Send Message](/sivils/commandutils/commands/send-message.md) / [Broadcast Message](/sivils/commandutils/commands/broadcast-message.md) / [Send Action Bar](/sivils/commandutils/commands/send-action-bar.md) / [Send Boss Bar](/sivils/commandutils/commands/send-boss-bar.md) | Talk to players                   |

## Entities

| Command                                                                                                                                                                                                                                                                                                 | Purpose                     |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------- |
| [Set AI](/sivils/commandutils/commands/set-ai.md) / [Set Mob Target](/sivils/commandutils/commands/set-mob-target.md) / [Mob Target](/sivils/commandutils/commands/mob-target.md) / [Mob Target Team](/sivils/commandutils/commands/mob-target-team.md)                                                 | Mob behaviour               |
| [Set Fire Ticks](/sivils/commandutils/commands/set-fire-ticks.md) / [Set Freeze Ticks](/sivils/commandutils/commands/set-freeze-ticks.md) / [Set Arrows In Body](/sivils/commandutils/commands/set-arrows-in-body.md)                                                                                   | Entity state                |
| [Push Entity](/sivils/commandutils/commands/push-entity.md) / [Modify Velocity](/sivils/commandutils/commands/modify-velocity.md) / [Multiply Velocity](/sivils/commandutils/commands/multiply-velocity.md)                                                                                             | Movement                    |
| [Mount](/sivils/commandutils/commands/mount.md) / [Swap Positions](/sivils/commandutils/commands/swap-positions.md) / [Leash](/sivils/commandutils/commands/leash.md) / [Shear Entity](/sivils/commandutils/commands/shear-entity.md) / [Remove Entity](/sivils/commandutils/commands/remove-entity.md) | Handling entities           |
| [Mob Drops](/sivils/commandutils/commands/mob-drops.md) / [Mob Drop Multiplier](/sivils/commandutils/commands/mob-drop-multiplier.md) / [Xp Drop Multiplier](/sivils/commandutils/commands/xp-drop-multiplier.md)                                                                                       | Loot                        |
| [Meta Data](/sivils/commandutils/commands/meta-data.md)                                                                                                                                                                                                                                                 | Tag an entity               |
| [Life Steal](/sivils/commandutils/commands/life-steal.md)                                                                                                                                                                                                                                               | Damage and heal in one step |

## Villagers

[Change Villager Profession](/sivils/commandutils/commands/change-villager-profession.md) · [Set Villager Trade](/sivils/commandutils/commands/set-villager-trade.md) · [Refresh Villager Trades](/sivils/commandutils/commands/refresh-villager-trades.md) · [Cure Villager](/sivils/commandutils/commands/cure-villager.md) · [Zombify Villager](/sivils/commandutils/commands/zombify-villager.md)

## Items

| Command                                                                                                                                                                                                                                                             | Purpose                  |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------ |
| [Give](/sivils/commandutils/commands/give.md) / [Remove Item](/sivils/commandutils/commands/remove-item.md) / [Set Cursor Item](/sivils/commandutils/commands/set-cursor-item.md)                                                                                   | Move items around        |
| [Item Name](/sivils/commandutils/commands/item-name.md) / [Item Lore](/sivils/commandutils/commands/item-lore.md) / [Replace Lore](/sivils/commandutils/commands/replace-lore.md) / [Replace Lore Regex](/sivils/commandutils/commands/replace-lore-regex.md)       | Text on items            |
| [Set Item](/sivils/commandutils/commands/set-item.md) / [Item Attribute](/sivils/commandutils/commands/item-attribute.md) / [Set Enchantment](/sivils/commandutils/commands/set-enchantment.md) / [Set Armor Trim](/sivils/commandutils/commands/set-armor-trim.md) | Item properties          |
| [Item Damage](/sivils/commandutils/commands/item-damage.md) / [Item Cooldown](/sivils/commandutils/commands/item-cooldown.md) / [Load Crossbow](/sivils/commandutils/commands/load-crossbow.md)                                                                     | Item state               |
| [Set Item NBT](/sivils/commandutils/commands/set-item-nbt.md) / [Add Item NBT](/sivils/commandutils/commands/add-item-nbt.md) / [Unset Item NBT](/sivils/commandutils/commands/unset-item-nbt.md)                                                                   | Custom data              |
| [Remove NBT Item](/sivils/commandutils/commands/remove-nbt-item.md) / [Remove Custom Data Item](/sivils/commandutils/commands/remove-custom-data-item.md)                                                                                                           | Take items by their data |
| [Get Player Head](/sivils/commandutils/commands/get-player-head.md) / [Set Compass Tracking](/sivils/commandutils/commands/set-compass-tracking.md)                                                                                                                 | Special items            |

## Effects and visuals

| Command                                                                                                                                                                                                                                                     | Purpose                 |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------- |
| [Effect](/sivils/commandutils/commands/effect.md) / [Precise Effect](/sivils/commandutils/commands/precise-effect.md) / [Override Effect](/sivils/commandutils/commands/override-effect.md) / [Copy Effects](/sivils/commandutils/commands/copy-effects.md) | Potion effects          |
| [Silent Particle](/sivils/commandutils/commands/silent-particle.md) / [Ray Trace Particle](/sivils/commandutils/commands/ray-trace-particle.md) / [Spawn Guardian Beam](/sivils/commandutils/commands/spawn-guardian-beam.md)                               | Particles and beams     |
| [Launch Firework](/sivils/commandutils/commands/launch-firework.md) / [Spawn No Damage Firework](/sivils/commandutils/commands/spawn-no-damage-firework.md)                                                                                                 | Fireworks               |
| [Spawn No Damage Lightning](/sivils/commandutils/commands/spawn-no-damage-lightning.md) / [Spawn No Damage Evoker Fang](/sivils/commandutils/commands/spawn-no-damage-evoker-fang.md)                                                                       | Harmless attack visuals |

## Projectiles and explosives

[Launch Projectile](/sivils/commandutils/commands/launch-projectile.md) · [Set Projectile Commands](/sivils/commandutils/commands/set-projectile-commands.md) · [Launch TNT](/sivils/commandutils/commands/launch-tnt.md) · [Set TNT Source](/sivils/commandutils/commands/set-tnt-source.md) · [Spawn Wither Skull](/sivils/commandutils/commands/spawn-wither-skull.md) · [Silent Summon](/sivils/commandutils/commands/silent-summon.md)
