Render a Minecraft map in ThreeJS
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
public
.gitignore
.nvmrc
README.md
index.js
karma.config.js
package-lock.json
package.json
webpack.config.js
yarn.lock

README.md

minecraft-mapper-js

Render a Minecraft map with three.js

Greenkeeper badge

Description

This is still in early prototype stages.
Uses a number of libraries from prismarineJS to read the map data server-side. Then loads the block data in the browser for rendering with three.js

Install

git clone git@github.com:Qazzian/minecraft-mapper-js.git
cd minecraft-mapper-js
npm install

Setup

Copy your Minecraft map folder into minecraft-mapper-js/map.
Map locations depend on which OS you run Minecraft on.

  • Windows: 'C:\Users\your username\appdata\roaming.minecraft\saves' by going to run and entering '%appdata%'
  • Mac OS X: Go to the "Go" menu in the Finder, click "Go to folder", and type '~/Library/Application Support/minecraft/saves'
  • Linux: Many repositories install Minecraft in the $HOME directory, '~/.minecraft/saves',

There are also a number of assets that you will need from the main Minecraft executable.
Find a copy of the Minecraft.jar file and open it with a zip file manager. The location will depend on which version you have and OS. I suggest using Google to find it for your environment.

Copy the jar file somewhere accessible.
Change the file extension from .jar to .zip

Copy the blockstates, models and textures folders into minecraft-mapper-js/public

Once you have done all of the above the directory structure should look like this:

minecraft-mapper-js
├── map
│   ├── DIM-1
│   ├── DIM1
│   ├── data
│   ├── playerdata
│   ├── region
│   └── stats
└── public
    ├── blockstates
    ├── js
    │   └── lib
    ├── models
    │   ├── block
    │   └── item
    └── textures
        ├── blocks
        ├── colormap
        ├── effect
        ├── entity
        ├── environment
        ├── font
        ├── gui
        ├── items
        ├── map
        ├── misc
        ├── models
        ├── painting
        └── particle

Running

Start the server with npm start
Go to http://localhost:3000/ in a browser that supports WebGl.

Thanks

This mapping tool has been built on top of the following libraries and frameworks:

All images and textures are the copyright of Mojang.