Commander

ATTENTION: This mod is no longer being maintained by McHorse. However there are still going to be official updates by others and there have been task forces that are investigating on porting it. If you also want to contribute to official updates, or to the porting effort, please join the official McHorse's Discord server, so we can communicate with you. Check out the source code.

Planet Minecraft page – CurseForge page – GitHub

Commander is a Minecraft mod which allows enhances command usage experience.

I don't recommend using this mod on a server, since it's very easy to get the server lag, freeze or crash with the loop command. If you're going to use it on the public server, use it at your own risk.

Install

Install Minecraft Forge, download the latest stable version of jar file for available Minecraft version. Also install following mods: McLib. Put it in minecraft's mods folder, and launch the game.

After that, Commander mod should be installed and will appear in Minecraft's mods menu. If Commander didn't appear in the mods menu, then something went wrong.

How to use

At the moment, commander provides /forin command which allows executing commands in a loop. /forin command's syntax is following:

/forin <start> <end> <command>

Where <start> is first index, and <end> is the value that you want /forin to iterate between. Both of those arguments must be integers, and the step value is 1. Also, you can nest /forin command only three times.

<command> argument can be any valid commands, however, besides that, <command> accepts variables through @{...} construction. For example, if you want to spawn 5 creepers in a row across X axis, you can use this /forin like this:

/forin 0 4 summon minecraft:creeper ~@{i} ~ ~

This command will evaluate into this:

/summon Creeper ~0 ~ ~
/summon Creeper ~1 ~ ~
/summon Creeper ~2 ~ ~
/summon Creeper ~3 ~ ~
/summon Creeper ~4 ~ ~

As you can see, @{i} construction was replaced with the index. Within @{...} following variables are present when using /forin command:

Name	Description
i	Index of the /forin loop
j	Index of the /forin loop (second nesting)
k	Index of the /forin loop (third nesting)
i_c, j_c and k_c	Count of iteration for given iteration
i_s, j_s and k_s	<start> index you passed into /forin command for given iteration
x	X coordinate of command sender in the world
y	Y coordinate of command sender in the world
z	Z coordinate of command sender in the world

Besides supporting variables, you can also use mathematical expressions within @{...} construct. For example, if you want to spawn 10 creepers around you in the circle (within 10 block radius), you can use this command:

/forin 0 9 summon Creeper ~@{cos(i/i_c*PI*2)*10} ~ ~@{sin(i/i_c*PI*2)*10}

See this page for more information.

And finally, Commander mod supports multiple commands executed in one line by separating commands using || (mind the spaces) symbols:

/particle explode ~ ~ ~ 0.1 0.1 0.1 0.1 10 || setblock ~ ~ ~ minecraft:stone

The spaces between || are required. Command like this:

/particle explode ~ ~ ~ 0.1 0.1 0.1 0.1 10||setblock ~ ~ ~ minecraft:stone

Won't be treated as multiple!

Video

Here is also a short showcase video of some of the usages of this mod:

Bug reports

If you found a bug, or this mod crashed your game, make sure to check this compatibility table and incompatible mod list page. The most frequent issue people encounter is that they didn't install the compatible versions of my mods. Or updated only one mod while using older version of my other mods.

If the versions of the mod are correct, then you can report a bug or a crash to me either on issue tracker, or on my Discord server. Please, make sure to attach a crash log (pastebin please) and description of a bug or crash, and the way to reproduce it. Thanks!