Ett litet minispel skrivet i ScriptCraft
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


A minigame written in ScriptCraft for

2014-01-26_22 07 43-638x300

In this guide we'll create a target to shoot to get different scores, depending on what target block is hit. Keep in mind that it's really useful to have had a look at the JavaScript guides before diving into this.

Creating a target

First we want to build the target – I thought a path leading to the target might be cool. Start by creating a file named target.js in ScriptCraft's plugin folder. Then we'll create a function accepting one parameter telling how long the path leading up to the target should be. The path is made with the boxfunction and the target with arc. The target consists of wool in various colors.

var Drone = require('drone');

// Creates a path with a target at the far end
// Invoke by typing "/js target(20)" in the chat
function target(leng) {
  leng = leng || 20;
  var drone = this, // We're extending a drone

  // Create the starting point to shoot from, 3, 1, 1);

  // Create the path to the target, 3, 1, leng - 1);
  drone.fwd(leng - 1);

  // Now let's make the target. It's a bit more involved
  // Start by listing which colors it should consist of
  colors = [blocks.wool.yellow,, blocks.wool.white,];
  for (i = 0; i < colors.length; i += 1) {
    bm = drone.getBlockIdAndMeta(colors[i]);
      blockType: bm[0],
      meta: bm[1],
      radius: 3 - i,
      strokeWidth: 1,
      quadrants: {topright: true,
                  topleft: true,
                  bottomright: true,
                  bottomleft: true},
      orientation: 'vertical'


When the script has been added, it is possible to create the target by calling the target function from within Minecraft. This is done by typing /js target(20) in the chat.

Exploring the target

2015-03-07_10 09 36

Walk up to the target.

Press F3 in the chat to see the debug screen which includes your coordinates, both where you are standing (XYZ) and what you are looking at. In the screenshot, I am standing at 222.320, 63, 100.599 ("XYZ"), looking at 219, 64, 100 ("Looking at")

Typing /js var,64,100) gives me a variable b with the block I'm looking at. There will be no printout.

/js b shows details of the block. Try it on your own!

/js b.typeId gives "35", which is blocks.wool.white. But, since wool has a color we also need to check /js which gives us "14". This is, which you can verify by typing /js

To turn off the debug screen, press F3 again.

An arrow hits the target

Now we'll use events send between functions in a program. This is often used in Scratch. Taking this example,

croppercapture 11

Here, space is an event sent by Scratch when you press the space bar. In addition, I have created my own event called an event which is sent when the space bar is pressed. That's how events work; they can be sent and anyone can catch them.

We will no create a function to find out which block is hit by an arrow and if it is one of the blocks in target, the shooter of the arrow should get a score. When a block is hit by an arrow, ScriptCraft sends an event called projectileHit. Using that, we will find out which block was hit and it i was one of the blocks in our target. This can be done in the same file as you created efore, however, I chose to put it in a new file called arrow_event.js.

Which block was hit?

We start by creating the function finding which block was hit.

function isWoolly(block) {
  return block.typeId === blocks.wool.white; // This is the main type, according to blocks.js

// Function to find out which block was hit. Far from good, but good enough for now. We need to find a better solution.
// This is needed since the block returned by the projectileHit event is the block containing the arrow
// and that is usually air, but we want the color of the wool
var findHitBlock = function (location) {
  var x = Math.floor(location.x),
    y = Math.floor(location.y),
    z = Math.floor(location.z),
    block =, y, z),

  // First, try the block reported as hit
  if (isWoolly(block)) {
    return block;

  for (i = 1; i <= 3; i += 1) {
    block = + i, location.y, location.z);
    if (isWoolly(block)) {
      return block;

    block = - i, location.y, location.z);
    if (isWoolly(block)) {
      return block;

    block =, location.y + i, location.z);
    if (isWoolly(block)) {
      return block;

    block =, location.y - i, location.z);
    if (isWoolly(block)) {
      return block;

    block =, location.y, location.z + i);
    if (isWoolly(block)) {
      return block;

    block =, location.y, location.z - i);
    if (isWoolly(block)) {
      return block;
}; // findHitBlock

Keeping a tab on the scores

To save the players' scores, we need a variable. This variable will store players in this fashion:

spelare1 -> 3
spelare2 -> 6

This is what the code looks like.

  // This is our score keeping variable
  var scores = {};

Find the block hit and award points

Now it's finally time for the code called when the projectileHit event is sent. We use the function we wrote before to find the block hit and the scores variable to save the score if the player hit the right block.

// This is the code called when an arrow hits a block.
// We want to find out which block was hit and award points to the player firing the arrow.
events.projectileHit(function (event) {
  var projectile = event.projectile,
    shooter = projectile.owner,
    loc = projectile.location,
    blockHit = findHitBlock(loc),

  if (blockHit === undefined) {

  // The color that was hit is in the "data" attribute (see the BlockType API for details)
  dataValue = blockHit.typeId;
  if ( !== 0) {
    dataValue += ':' +; // for example, 35:14

  // Add the player to the scores list if it's not already in there
  if (scores[] === undefined) {
    scores[] = 0;

  // Here, we find out what color was hit and score accordingly
  if (dataValue === blocks.wool.yellow) {
    scores[] += 1;
  } else if (dataValue === {
    scores[] += 2;
  } else if (dataValue === blocks.wool.white) {
    scores[] += 4;
  } else if (dataValue === {
    scores[] += 8;
  echo(shooter, "New score: " + scores[]);

dartScores is a function for printing all scores in the chat. echo prints a line in the chat and we call it in a loop for each player saved in the scores variable.