File	Date	Author	Commit
lib	2012-03-06	sverik	[bb6074] ticket #5 Support Anvil
resources	2012-03-11	sverik	[8dfeaf] a bit of cleanup, and add a README file
src	2012-03-11	sverik	[63b6f7] yeah, update version string...
.hgignore	2012-02-11	sverik	[4ff81e] initial
.hgtags	2012-03-11	sverik	[e97d0c] Added tag 0.1 for changeset 63b6f7da0dca
COPYING	2012-03-04	sverik	[43fe95] ticket #10 Release properly under GPL
COPYING-jcommander	2012-03-04	sverik	[43fe95] ticket #10 Release properly under GPL
README	2012-03-11	sverik	[8dfeaf] a bit of cleanup, and add a README file

Read Me

block2brick


About
-----

block2brick converts a part of Minecraft world to a LEGO Digital Designer file.
Why? Because they share the feeling of creating big things from small parts.
And because Minecraft just looks good as LEGO. The project is hosted at
https://sourceforge.net/projects/block2brick/


Requirements
------------

* Java runtime aka jre - version 7 is recommended, although there is also a
	build compatible with Java 5. It does not require any fancy stuff so all
	kinds of Java implementations should work (Oracle's Java, OpenJDK etc).
	
Optional:

* Minecraft - you have to create the world first, otherwise there is nothing to
	convert. Alternatively just use a world/save someone else created. Get
	Minecraft from here: http://www.minecraft.net/
	
* LEGO Digital Designer - the conversion does not require that you have LDD
	installed, but if you want to see the result or modify the default
	dictionary then this is what you need, get if from here:
	http://ldd.lego.com/


Usage
-----

block2brick expects a number of arguments, running the following will list all
possible arguments and their descriptions:

java -jar block2brick-0.1.jar -h

Here is an example run (using Linux/bash style paths):

java -jar block2brick-0.1.jar -i ~/.minecraft/saves/world01/ -o world01.lxf -d dictionary_2x2x4.lxf -x -450:-420 -z 118:148 -y 55:80


Dictionary
----------

The dictionary file describes how Minecraft blocks should be converted to LEGO
bricks. Basically it is a 16 times 16 grid with a total of 256 positions. Each
position is marked with a plate of specific colour and style. Positions
correspond to Minecraft block IDs, e.g. the dandelion block has ID 37, or more
conveniently 0x25 in hex. This refers to the 2nd row and 5th column in the
dictionary (provided air 0x00 is at the top left hand corner). And remember,
counting rows and cols starts from zero! If you want to edit the dictionary
then feel free to change anything except the purple 2x2 plates and the bricks
near the 0th position (this is marked by two 2x2 plates, one 1x1 plate and one
2x2 grey brick). Also it is not wise to extend the limits of one block, that is
2x2 and the height of 4 plates. Otherwise LDD will complain and remove the
overlapping bricks. 


License
-------
block2brick is released under GPLv3, see COPYING for more information. The source code can be
retrieved from https://sourceforge.net/projects/block2brick/