craft

An HTML5 crafting API.

craft

An HTML5 crafting API.

example

View this example.

It loads up most (not all) of the Minecraft recipes and items. The textures are completely themeable using existing Minecraft texture packs too.

// create a crafter 
var crafter = require('craft')();
 
// add a recipe for a torch 
crafter.recipe({
  have: [
    ['coal'],
    ['stick'],
  ],
  give: ['torch', 4],
});
 
// craft your item 
var item = crafter.craft([
  ['coal'],
  ['stick'],
]);
console.log('You get ' + item.give[1] + '' + item.give[0] + '!');
 
// item is now a normalized recipe 

If you specify more than one argument to crafter.recipe() it will assume you're entering a recipe in a Minecraft-like format:

// turn a box of dirt into 2 diamonds 
crafter.recipe(['diamond', 2], [
  'DDD',
  'D D',
  'DDD',
], ['D', 'dirt', 2]);
  • The first argument is what the recipe will give and how much.
  • The second argument is a map of the recipe.
  • The following arguments indicate what each of the characters within the map are equivalent to and how much are required.

crafter.recipe() also accepts a shorthand popular mod format. Enter as strings, a single recipe per line:

crafter.recipe([
  // recipe for a ladder 
  'shaped ( log+null+log / log+log+log / log+null+log ) > ( ladder,16 )',
  // planks 
  'shaped stick+stick ; stick+stick > planks',
].join('\n'));

Also included is a web user interface.

var webui = require('craft/webui')({
  container: document.getElementById('crafting')
});

View the example for a more in depth example.

api

Returns a new craft instance.

Add a new recipe to the crafter.

Input have into the crafter and it will search for a matching recipe then return the matching recipe.

Returns a crafting web UI instance. Specify a container option that contains your crafting grids.

Events emitted as an item is picked up and dropped:

webui.on('pickup', function(itemSlotquantityPickedUp) {});
webui.on('drop', function(itemSlotquantityDropped) {});

install

With npm do:

npm install craft

Use browserify to require('craft').

  • 0.1.0 - initial release

Copyright (c) 2013 Kyle Robinson Young
Licensed under the MIT license.

Minecraft is property of Mojang AB