Javascript Examples

Here are some Javascript examples, to show you how some tasks can be done.

Put them in a text file, then run:

/minebot js /path/to/file

or on windows:

/minebot js C:\path\to\file.txt

You don't know javascript?

Simply put the simple script lines in a file in the order you want them. If you want to loop indefinitely, use this:

while (true) {
    // Replace this with the commands you want to be repeated
}

You can also loop 10 times. The variable index is the loop counter. If you have multiple loops, use a counter for each loop.

for (var index = 0; index < 10; index++) {
    // Replace this with the commands you want to be repeated
}

Simple script (lines)

Mine

minescript.doStrategy(minescript.strategy("minebot", "mine"));

Mine iron ore

minescript.doStrategy(minescript.strategy("minebot", "mine", "iron_ore"));

Tunnel for 100 Blocks in the direction you are looking

minescript.doStrategy(minescript.strategy("minebot", "tunnel", "100"));

Of course this works with any other command the bot understands (minebot + minebuild).

Walk to a given position (x, z)

minescript.doStrategy(minescript.strategyWalkTowards(250, 110));

Align to grid:

minescript.doStrategy(minescript.strategyWalkTowards(
       Math.round(minescript.getPlayer().x),
       Math.round(minescript.getPlayer().z)));

Walk 10 Blocks in x direction:

minescript.doStrategy(minescript.strategyWalkTowards(minescript.getPlayer().x + 10, minescript.getPlayer().z));

Do multiple things at once: eat when hungry, lumberjack any tree in range and replant it, collect items, harvest/replant any crops and feed cows as long as there are fedable cows nearby, in that order (Hint: There might be times in which none of this is possible, you should put this in a while loop to avoid the bot to stop.)

minescript.doStrategy(minescript.stack(
      minescript.strategy("minebot", "eat"),
      minescript.strategy("minebot", "lumberjack", "replant"),
      minescript.strategy("minebot", "kill", "0"),
      minescript.strategy("minebot", "plant"),
      minescript.strategy("minebot", "feed", "cow")
));

Utility functions

Copy these functions to the top of your file if you want to use them.

// The same as a good old linux sleep(time). Pauses your bot 'time' seconds.
function pause(time) {
  minescript.doStrategy(minescript.strategy(
          "minebot", "pause", (time * 1) + ""));
}

// Teleports home.
function home(name) {
  minescript.serverCommand("/home " + name);
  // Wait 2 seconds. Increase this if your server is slower.
  pause(2);
}

If you want to get sure that you really teleported away. Good if you want to send your bot mining and do not want it to destroy your home. Mind that it will trigger a false alert if you are already at the right point. This function pauses the game loop on exit.

function awayToHome(name) {
  var pos = minescript.getPlayer();
  home(name);
  if (pos.distance(minescript.getPlayer()) < 100) {
    throw "Distance to old position too small."
  }
}

// Adjust this to your base center position.
var BASE_X = 1200.5;
var BASE_Z = -1199.5;

// Goes to a position relative to your base.
function gotoRelative(x, z) {
  minescript.doStrategy(minescript.strategyWalkTowards(BASE_X + x, BASE_Z + z));
}

Respawn if required (just in case you were killed...):

    if (!minescript.isAlive()) {
      minescript.doStrategy(minescript.strategy(
           "minebot", "respawn"));
      pause(1);
      home("my-work-home");
    }

Scanning the chat

// This simple script displays all chat messages with format codes.
// This is good if you want to see the format codes your server uses.

var messageCount = minescript.getChatMessages().length;

while (true) {
	minescript.doNothing();
	var messages = minescript.getChatMessages();
	for (; messageCount < messages.length; messageCount++) {
		// replace § by % so that it gets printed.
		minescript.displayChat(messageCount + ": " + messages[messageCount].textFormatted.replace(/\u00a7/g, "%"))
		// You can do something useful here, like reacting on chat messages.
	}
}

Custom strategies

You need to use the nashorn JS engine (Java 8 or above) for this to work. All current java versions should be fine.

Custom stop condition.

You can extend the stop strategy to stop on custom conditions

function generateStopStrategy(whenToStop, force, description) {
	var StopOnConditionStrategy = Java.type("net.famzangl.minecraft.minebot.ai.strategy.StopOnConditionStrategy");
	var StopCondition = Java.type("net.famzangl.minecraft.minebot.ai.strategy.StopOnConditionStrategy$StopCondition");
	var cond = Java.extend(StopCondition, {
		shouldStop: whenToStop
	});
	return new StopOnConditionStrategy(new cond(), force, description);
}

function stopWhenFallenDown() {
	// This stops as soon as we moved downwards.
	var oldY = -1;
	var movedDown = false;
	return generateStopStrategy(function(h) {
			var player = minescript.getPlayer();
			movedDown |= player.y < oldY - .000001;
			oldY = player.y;
			return movedDown;
		}, true, "Stop when moving down.");
}

function stopOnChatMessage() {
	// This should work with the essentials /msg command
	// This matches messages sent from myUserName containing stop.
	// You can replace \u00a7 with § but make sure to change the encoding to UTF-8 in 
	// your text editor (should only be a problem for windows users)
	var re = /^\u00a76\[\u00a7c(myUserName)\u00a76 -> \u00a7c(me)\u00a76] \u00a7r.*stop.*$/;

	// Alternatives to this regexp:
	//   Match server shutting down:
	//      /^\u00a76.*shut.*down/
	//              ^ Replace this with the color code your server uses.
	//   Stop as soon as that person is mentioned (join message, ...)
	//      /supUserName/


	// we ignore old messages
	var messageCount = minescript.getChatMessages().length;
	// we should not just return false once, so we need to store the status.
	var stopReceived = false;
	return generateStopStrategy(function(h) {
			var messages = minescript.getChatMessages();
			// this goes through all new messages
			for (; messageCount < messages.length; messageCount++) {
				stopReceived |= (messages[messageCount].textFormatted + "").matches(re);
			}
			return stopReceived;
		}, false, "Stop when moving down.");
}

Examples on how to use these:

function stopWhenBelow(minY) {
	return generateStopStrategy(function(h) {
			var player = minescript.getPlayer();
			return player.y < minY;
		}, true, "Stop when moving down.");
}

// Walk and stop as soon as we fell down.
minescript.doStrategy(minescript.stack(
		stopWhenFallenDown(),
		minescript.strategy("minebot", "walk", 0, 0)));


// Fish until our friend tells us to stop.
minescript.doStrategy(minescript.stack(
		stopOnChatMessage(),
		minescript.strategy("minebot", "fish")));

List sheep colors

This advanced example shows how to list all sheep in range and then kill them in a way that leaves 20 sheep per color.

	var colors = {};
	var totalSheep = 0;
	var sheepToLeave = 20; // Total of 320 sheep. Brings you to level 30 by feeding once.
	minescript.getEntities(net.minecraft.entity.passive.EntitySheep, 100).forEach(function(sheep) {
	  if (sheep.getColor() in colors)
	    colors[sheep.getColor()]++;
	  else
	    colors[sheep.getColor()] = 1;
	  totalSheep++;
	});

	// Print a list of sheep
	minescript.displayChat("Sheep around you: " + totalSheep);
	sorted = [];
	for (color in colors) {
		sorted.push(color);
	}
	sorted.sort(function(a, b) {return -colors[a] + colors[b];});
	for (var i = 0; i < sorted.length; i++) {
	  minescript.displayChat(sorted[i] + ": " + colors[sorted[i]] + " (" + Math.round(100 * colors[sorted[i]] / totalSheep) + "%)");
	}

	// Now kill those that are too much
	for (color in colors) {
	  var toKill = colors[color] - sheepToLeave;
	  minescript.setDescription("Killing " + toKill + " " + color + " sheep");
	  if (toKill > 0) {
	    minescript.doStrategy(minescript.stack(
	      minescript.strategy("minebot", "eat"),
	      minescript.strategy("minebot", "kill", "sheep", color, toKill + "")));
	  }
	}