Tutorials

 

_________________________________________________________________________________________________________________________

Biomes          Blocks          Characters          Items          Tutorials          Quests

_________________________________________________________________________________________________________________________

 

Content

Starting out

Change Log

Character Editing

Crafting

Current Version

FAQ

File Format

File Locations

Recipe Editing

Seeds

Texture Packs

World Downloading

Modding

Tutorials Description

 

 

 

 

 

_____________________________________________________________________________________________________________________________

Getting Started 

_____________________________________________________________________________________________________________________________

 

Back to Top

_____________________________________________________________________________________________________________________________

Change Log

_____________________________________________________________________________________________________________________________

 

9.0

 

New terrain generator; villages, volcanoes, and sink holes. Improved color wheel for blocks. The ability to ride certain mobs and pets. Spawner blocks removed.

 

8.0

 

Miner helmet, Stone Stairs, Old Stone Stairs, Brick Stairs, Birch Fences, Palm Fences, Stone Fences, Old Stone Fences, Brick Fences, and Metal Fence Gate. Japanese and portuguese translation

 

7.0

 

Moga controller support. Teleport arrows and better fences. Pets:Perseus(cat), Slinky(dog), and Gontar(alien dog). Hardcore game mode.

 

6.0

 

Pets: Drako & Arachy. Angelic swords, replicators, destroyers, Electrite, 

 

5.0

 

Radar, trident, teleporting wands, wheat farming, goblin pickaxe, fire arrow, tnt arrow, magic arrow, poison arrow, and exploding arrow. Random character names. Creative game mode with infinite supplies. Quests give recipes as rewards. TNT now explodes, acid melts down, and trees grow. Bosses are stronger, and drop better items. Iron and gold blocks. Diving suit, jet pack, gravity boots, spring boots, and fuel. Atlantis.

 

4.0

 

Doors, ladders, trap doors, candles, fences, gates, 3d plants, fireflies, skulls, stairs, and wax. New game mode, Exploring. Level cap raised from 30 to 200. Paintable snow, sand, wax, and wood. The introduction of Ashkore!

 

3.0

 

New, rotating sky. Recipe book and crafting. Forgotten sky world added. Chests, boat, car, health potions, mana potions, torches, shields, flippers, buckets, armor, magic rings, necklaces, and my precious.  Earthquakes shake things up. 

 

2.0

 

The sky was improved, added fog, stars, and a planet to the sky. The first character and spawner blocks are added, introducing the Giggles. Magic powers and the ability to swim. Hades, deserts, jungles, forests, and swamps biomes. The first quests are added.

 

1.0

 

Blocksters Dies, but Block Story is born. Added tilt control, flying, seedable worlds, and the first multilingual support.

 

0.0

 

The World is made of blocks, infinite in all directions. Water, caves, floating islands, colored lights, trees, and clouds are added.

 

 

Back to Top

_____________________________________________________________________________________________________________________________

Character Editing

_____________________________________________________________________________________________________________________________

 

Back to Top

_____________________________________________________________________________________________________________________________

Crafting

_____________________________________________________________________________________________________________________________

 

6091

 

     Crafting in BlockStory is simple. If you do not already know how to craft certain things, there is a Recipe Book located under your 2x2 crafting table when you enter your inventory.  When you go into your Recipe Book, you are able to access some of the recipes for items, weapons, armor, and other things. Some recipes will unlock only after finishing certain quests. 

     Starting out the player only has access to a 2x2 crafting table. This is quite small and unable to craft most items. Therefore, the player must eventually make a 3x3 Crafting Table. The first step is to gather log blocks from trees, and dragging them into one slot in your 2x2 crafting table.

 6128

 

     The outcome of placing those log blocks in one slot is Wood Planks. Take the wood planks and put one in each slot of your 2x2 crafting table, and BAM! You have just created your first 3x3 crafting table!

 

6117

 

     Now you can craft anything you want, as long as you have the recipe unlocked. In case you need further explanation, here is a video showing you how to craft sticks by Paul: 

This video is slightly outdated but the basic concept is the same

 

Back to Top

_____________________________________________________________________________________________________________________________

Current Version

_____________________________________________________________________________________________________________________________

 

6136

8.1

6137

8.0.5

6138

8.0.4

6150

9.3

6148

7.0

 

6145

8.0.4

Back to Top

_____________________________________________________________________________________________________________________________

FAQ

_____________________________________________________________________________________________________________________________

Frequently Asked Questions Page

Pet FAQ 

 

Back to Top

_____________________________________________________________________________________________________________________________

File Format

_____________________________________________________________________________________________________________________________

 

So you want to modify the worlds manually outside the game?  make a world editor maybe? 

Well, you came to the right place. But before I get to the nitty-gritty details, some big picture explanations are in order.

How blocks are represented

In Block Story, a block is a structure that contains  fields:

  • Block type Id. A number between 0 and 255 that identifies what kind of block it is.  It is 1 byte
  • Block data. A number that provides additional information for the block.  The exact meaning of this depends on what type of block it is.  For spawners, it is a number between 0 and 255 that identify what mob it spawns. For glass, sand, wood, wax and candle it represents the color, and it is a number from 0 to 63 (the lower 6 bits in order of RRYYBB). For 3D models that have a specific direction (like Stairs and Doors), the upper 2 bits represent the direction you were facing when placing the block; it is 1 byte
  • Red Light.  How much red light the block has, from 0 to 15,  it is 1/2 a byte
  • Green Light. How much green light the block has, from 0 to 15, it is 1/2 a byte
  • Blue Light. how much blue light the block has, from 0 to 15, it is 1/2 a byte
  • Sun Light. How much sun light the block has.  Sunlight is white, but it is whiter during the day and darker during the night. from 0 to 15, it is 1/2 a byte

So a block is encoded into 4 bytes always,  it's behaviour is determined by its block type id and associated data.

The light information IS NOT stored in the files at all.  So when we go down to the files, each block is just 2 bytes.

Block Runs

Blocks are stored using a very simple compression algorithm called Run Length Encoding (RLE). Suppose you have 10 consecutive blocks have the same block id and data,  then instead of storing 10 blocks for a total of 20 bytes,  what is stored is the number 10 (2 bytes) and the block id and data (2 bytes) for a total of 4 bytes.

Each one of these segments are called a Run.

This algorithm, while not being particularly strong for general compression,  performs exceptionally well for voxel games, because most chunks have large areas of consecutive identical blocks.

Chunks

The blocks are not loaded one at a time. Instead, they are loaded in chunks.  A chunk is an area of 32x32x32 blocks.  So it is a cube with 32 blocks on each side for a total of 32768 blocks.

When the player is walking, only the chunks near him are loaded in memory.  You can see how many chunks are loaded by enabling the FPS counter  in settings -> Misc.

A chunk is identified by its coordinates divided down by 32.  For example,  a block at (100, 150, 100) is at chunk (100 / 32, 150 / 32, 100 / 32) = (3,4,3).  Note it is divided down which makes a different for negatives, so a block at (-100, -150, -100) is at chunk ( floor(-100 / 32), floor(-150/32), floor(-100/32)) =  (-4, -5, -4)

Each chunk is stored in a separate file.  It is only stored in a file if the user changes something in the chunk. 

A chunk file is stored in a specific location which is calculated from the chuck coordenates.

the location is always xd_yd_zd/x_y_z.chunk

where:

   xd = floor( x / 16 )

   yd = floor( y / 16 )

   zd = floor( z / 16 )

and (x,y,z) is the chunk coordinates

 

the chunk file contains the following data, in  little Endian:

2 bytes for the amount of runs in the chunk 

for each run:

  2 bytes for the length of the run 

  1 byte for the block id

  1 byte for the block data

 

Suppose you want to make a chunk that is solid gold, then the chunk file would contain:

01 00 00 80 0C 00

 To break it down:

  • 01 00  is 2 bytes, in little endian is 0x0001 which is hexadecimal for 1 which means there is only 1 run in this chunk file
  • 00 80  is 2 bytes, in little endian is 0x8000 which is hexadecimal for 32768, which is the size of the first run, and covers the whole chunk
  • 0C  is the block id for gold ore
  • 00  is the data (gold has no data associated, so this one does not matter)

 

Another example, with half the chunk with wood and the other half with glass, then the chunk file would contain:

02 00 00 40 0D 00 00 40 03 00

 To break it down:

  • 02 00  means there are 2 runs in the file
  • 00 40  is little endian hex for 16384, so half the chunk
  • 0D  is the block id for wood (or bark)
  • 00  is the data (wood has no data associated, so this one does not matter)
  • 00 40  is little endian hex for 16384, so half the chunk
  • 03  is the block id for glass
  • 00  is the color of glass.  00 is fully transparent,  change this value to get different colors

 

The runs go vertically, from bottom to top,  

There is a special block id 00 which means unknown.  An unknown block means that it has not been changed from whatever the generator produced. 

When there is no file for a chunk, the program simply assumes there is 1 run of all unknown blocks, meaning just use what the generator produces for the whole chunk.

 

Back to Top

_____________________________________________________________________________________________________________________________

File Locations

_____________________________________________________________________________________________________________________________

Device File Location
Android mnt/sdcard/BlockStory
Apple /var/mobile/Applicaions   Jailbreak Required
Nook ?
PC C:\Users\(Your User Name Goes Here)\AppData\LocalLow\MindBlocks\Block Story
 

_____________________________________________________________________________________________________________________________

Recipe Editing

_____________________________________________________________________________________________________________________________

 

You can create your own recipes which can be used to craft any item in the game. We encourage you to post your recipes in the forum. If your recipes are good, we will consider incorporating them in the game. Place each recipe you want in a separate xml file. Say you want to craft a pickaxe, then you would create an .xml file in: 

Mobile = mnt/sdcard/BlockStory/recipe/pickaxe.xml

PC = C:\Users\(Your User Name Goes Here)\AppData\LocalLow\MindBlocks\Block Story\ recipe\pickaxe.xml

If there is no BlockStory folder, create it. Also, if there is no recipe folder in BlockStory folder, create it. The name of the file does not matter, as long as it has a .xml extension. The easiest way to explain what the content is like, with an example. Here is the recipe for Fire:

<recipe name="Fire" mana="3" >
	<row>
		<item />
		<item name="Stick" />
		<item />
	</row>
	<row>
		<item />
		<item name="Coal Ore" />
		<item />
	</row>
	<row>
		<item name="Stone" />
		<item name="Stone" />
		<item name="Stone" />
	</row>
	<result name="Fire" />
	<description language="en">
		Very useful item for crafting and building other things.
		
		To use it, place it in the crafting table along with other items to make advanced objects.
	</description>
	<description language="ru">
		Огонь очень полезен. Его можно использовать для изготовления множества предметов.
	</description>
</recipe>

Each recipe will have up to 3 row elements. Each row can have up to 3 items. Make sure all rows have the same amount of items. If an item does not have name, then it will be an empty slot. Another thing to notice here is that the recipe has a mana="x" attribute which means that crafting this recipe will consume mana points. Then the result will contain the name of the item and count for the output of the recipe. Then any number of descriptions for each language. If a recipe does not need a 3x3 table, but less, then you should not have empty items. Here is the recipe for Clear Stone:

<recipe name="Clear Stone" category="Blocks">
	<row>
		<item name="Stone" />
	</row>
	<row>
		<item name="Fire" />
	</row>
	<result name="Clear Stone" />
	<description language="en">
		A stone useful for building and creating bricks.
	</description>
	<description language="ru">
		Каменный блок для строительства и создания кирпичей.
	</description>
</recipe>

In this example, only 2 items are needed, Fire and Stone. But notice it only specifies a 2x1 table. This allows the recipe to be done anywhere in the table as long as the Stone is above the Fire. Another thing to notice is that you can specify the category. This is useful for finding the recipe in the recipe book. Items and results can have counts. Here is an example:

<recipe name="Gold Ore">
	<row>
		<item name="water" />
	</row>
	<row>
		<item name="Sand" count="10" />
	</row>
	<row>
		<item name="Pan Tool" />
	</row>
	<result name="Gold Ore" />
	<description language="en">
		Useful item for trading with the natives
	</description>
	<description language="ru">
		Золото ценится в магазине у Shadow Hunter.
	</description>
</recipe>

This is the recipe for Gold Ore by panning it. This is a 3x1 recipe. You can see you can specify that the recipe needs 10 Sands. You can also have a count on the result. For spawner blocks, you also need to specify a data field, so that it knows what mob to spawn. Here is a recipe kotketa from 4pda made for crafting a Dragon Monster Spawner.

 
<recipe name="Dragon Spawner">
  <row>
    <item name="Dragon Heart" />
  </row>
  <row>
    <item name="Stone" />
  </row>
  <result name="Monster Spawner" data="48" />
  <description language="en">Spawner of dangerous mob - dragon</description>
  <description language="ru">Spawner of dangerous mob - dragon</description>
</recipe>

The data="48" attribute means to spawn mob ID 48, which is the dragon. The IDs for all the mobs is not documented yet. The data="xx" attribute can be used in the input items as well as the result.

 

Back to Top

_____________________________________________________________________________________________________________________________

Seeds

_____________________________________________________________________________________________________________________________

 

Seed names are case sensitive! These seeds are pre v 9.0.

 

Menu 3483

This is the seed used for development and for the menu screen, so it is very well tested.  

Most NPC can be found near the starting point.

Large flat beach near starting point with a desert nearby and a dragon

naruto 3484 A beautiful cliff above the water. In the water there is a cave in which you can find a lot of resources and shelter from spiders and worms
Spider Man 3485 Lots of sharks
hakunaMatata  3486 Lots of sharks.  Fly to the beach to see lots of trees and foliage
epic 3487 Flat terrain, great for building. It has a cave thats HUGE directly under the whole terrain.
skyhaven 3482 Big forest
manhattan 3488 manhattan has most of the things that beginners need. Most ores are on the outside of the mountain surfaces
Devil Rock 3489

Great cave directly below the spawn point and has lots of gold, coal, and green flourite

iRoN 3490

Megalodon shark in the lake next to the spawning point.

mello yello 3491

Forgotten Sky touches the sea at some point on the ice nearby

melly yello

3492

Forgotten sky touches the sea at some point on the ice nearby. TWO MEGALODON SHARKS DIRECTLY UNDERNEATH THIS LANDMARK!

moria 3493

travel up hill near spawn for a huge flat space

Smallworlds 3494

The cavern in the water near the spawn point gives an easy natural entrance to Moria

Catsfanj Dock 3495

Spawns you on a small island with the Source of Life 20 blocks away.

AngryAnt 3496

Iron and Red Crystals in the underwater cave to the bottom right of the spawn point in the pic http://www.blockstory.net/node/1414

recipe 3481 This spawns you in a swampy forest that contains approximately: 25 bat spawners (the red flowers) and 5 watermelons.
flattyflatflat 3497

perhaps the flattest seed u will ever see Tongue

HELL 3498

Spawns you near birch trees

MajoraMG 3500

You spawn on a floating island connected to a landmass. 2 megalodons can be found near the spawn too.

yomama 3501

12 Source of life spawers and 9 Paula spawers, also it has a great cliff with lots of coal/gold

Caves 3502

Spawn on a beach next to a large hill, top of the hill has a nice cave. Ted and Shadow Hunter are near starting point  

Mount Rushmore 3503

Spawns on the side of a huge hill, large tunnel somewhere above. tunnel has lots of green and blue crystals along the way. 

Glasglow   Spawns you on an island above the beach and all biomes are within 1000 blocks of the spawn.

 

Seed names are case sensitive! These seeds are after 9.0

Realm of Awesomity  N/A (yet)  This seed can only be obtained through modding, but it is very awesome, you spawn near a beach and there are a lot of caves and diverse biomes not far from spawn; it includes Tundra, Forest, Canyon, Caves, Ocean, Rivers, jungle, Grass Plains, Stone place, and a very intresting Volcanic Cave. Also the most rare generated structures are extremely common everywhere, 3 jungle temples, 2 Mayan pyramids, 10 wheat planters, a surface dungeon, all with in 1000 blocks from spawn.

Back to Top

_____________________________________________________________________________________________________________________________

Texture Packs

_____________________________________________________________________________________________________________________________

 

Installing Texture Packs

 

1.       Download the zip file of the texture pack that you would like to use from here: Block Story Textures

 

2.       Once the zip is downloaded you need to extract it to your Block Story Themes folder.

  • If you are using a mobile device then a file viewing app, such as ES Explorer, will be needed to extract the zip into the correct  folder

 

3.       The themes folder is located in either of these locations depending on what device you are using:

  • Android: mnt/SDCard/Blockstory/Themes
  • PC:  C:\Users\(your user name)\Documents\Block Story\Themes
  • Apple: /var/mobile/Applicaions   Jailbreak Required Texture Packs currently not working

 

4.      One of the biggest mistakes made when extracting new textures is placing them 2 folders deep in the themes folder. Make sure that the new texture pack images are in the first folder. Example:

  • Correct: Block Story\Themes\NewTexturePack\textures.png

  • Wrong: Block Story\Themes\NewTexturePack\NewTexturePack\textures.png

 

5.      Open Block Story, select options, select theme, choose your new texture pack from the list.

 

6.      The game will need to be restarted

 

7.      Once the game is restarted select options, select graphics, and turn the Terrain Quality slider to 2.

 

Your new texture pack should now work.

 

Back to Top

_____________________________________________________________________________________________________________________________

World Downloading/Uploading

_____________________________________________________________________________________________________________________________

 

Installing Downloaded Worlds

 

1.       Download the zip file of the world that you would like to use from here: Block Story Worlds

 

2.       Once the zip is downloaded you need to extract it to your Block Story Worlds folder.

  • If you are using a mobile device then a file viewing app, such as ES Explorer, will be needed to extract the zip into the correct  folder

 

3.       The Worlds folder is located in either of these locations depending on what device you are using:

  • Android: mnt/SDCard/Android/data/com.mindblocks.blocks/files/worlds
  • PC:  C:\Users\(your user name)\AppData\LocalLow\MindBlocks\Block Story\Worlds
  • Apple: /var/mobile/Applicaions   Jailbreak Required 

 

4.      One of the biggest mistakes made when extracting new worlds is placing them 2 folders deep in the worlds folder. Make sure that the new world chunk files are in the first folder. Example:

  • Correct: com.mindblocks.blocks/files/worlds\NewWorld\0_0_0.chunk

  • Wrong: com.mindblocks.blocks/files/worlds\NewWorld\NewWorld\0_0_0.chunk

 

5.      Open Block Story and choose your new world from the list.

 

Your new world should now work.

 

Uploading Worlds to the site

 

1.       Find the world you want to upload by looking in the world folder.

 

2.       The World folder is located in either of these locations depending on what device you are using:

  • Android: mnt/SDCard/Android/data/com.mindblocks.blocks/files/worlds
  • PC:  C:\Users\(your user name)\AppData\LocalLow\MindBlocks\Block Story\Worlds
  • Apple: /var/mobile/Applicaions   Jailbreak Required 

 

3.       Compress the desired world into a .zip

 

4.       On the website select the Download tab, select worlds, and then select share world

 

5.       Create your post, then right above the save button click choose file to add your .zip file.

 

6.       Once your world is selected hit the upload button.

 

7.       Save, now your work is shared with the world.

_____________________________________________________________________________________________________________________________

Modding

_____________________________________________________________________________________________________________________________

Modding is a very big part of block story, and though the game does not have much support for it that has not stoped

the community from comming up with creative way's to use the current support.

 

  • Modding the player:

    (coming soon)

 

  • Making creative worlds into story or hardcore:

    (coming soon)

 

  • Creating an infinite flat world:

    (coming soon)

 

  • Making unbreakable blocks:

    (coming soon)

 

  • Creating custom terrain:

    (coming soon)

 

  • Creating custom items:

    (coming soon)

 

  • Creating custom recipes:

    (coming soon)

 

  • Creating custom blocks:

    (coming soon)

 

 

  • Creating custom textures:

    (coming soon)

 

  • Creating a mod pack in block story lite:

    (coming soon)

 

  • Modding Block Story Community Edition:

    (coming soon)

 

Back to Top