Skip to content

Qazzian/minecraft-mapper-js

Repository files navigation

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.

About

Render a Minecraft map in ThreeJS

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published