BlueMap/README.md

50 lines
2.4 KiB
Markdown
Raw Normal View History

2020-01-03 13:08:59 +01:00
![title-banner](https://bluecolored.de/paste/bluemap-title.jpg)
BlueMap is a tool that generates 3d-maps of your Minecraft worlds and displays them in your browser. Take a look at [this demo](https://bluecolored.de/bluemap). It is really easy to set up - almost plug-and-play - if you use the integrated web-server (optional).
2020-02-09 17:22:28 +01:00
The Sponge/Spigot-Plugin automatically updates your map as soon as something changes in your world, as well as rendering newly generated terrain and managing the render-tasks.
2020-01-03 13:08:59 +01:00
2020-02-09 17:22:28 +01:00
**BlueMap is currently in an early development state!**
2020-01-03 13:08:59 +01:00
2020-02-09 17:22:28 +01:00
A lot of features are still missing, and some blocks - especially some tile-entities - will not render correctly/at all.
2020-01-03 13:08:59 +01:00
See below for a list of what is planned for future releases.
2020-02-09 17:22:28 +01:00
### Download
You can choose a version and download BlueMap from [here](https://github.com/BlueMap-Minecraft/BlueMap/releases).
### Using BlueMap
BlueMap can be used on the command-line, or as a plugin for your Sponge/Spigot/Paper-Server. Read the [wiki](https://github.com/BlueMap-Minecraft/BlueMap/wiki) to get started!
2020-02-09 17:22:28 +01:00
### Discord
If you have a question, help others using BlueMap or get the latest news and info you are welcome to join us [on Discord](https://discord.gg/zmkyJa3)!
### Clone
If you have git installed, simply use the command `git clone https://github.com/BlueMap-Minecraft/BlueMap.git` to clone BlueMap.
2020-01-03 13:08:59 +01:00
### Build
2020-02-09 17:22:28 +01:00
In order to build BlueMap you simply need to run the `./gradlew build` command in BlueMap's root directory.
You can find the compiled JAR file in `./build/libs`.
2020-01-03 13:08:59 +01:00
### Issues / Suggestions
You found a bug, have another issue or a suggestion? Please create an issue [here](https://github.com/BlueMap-Minecraft/BlueMap/issues)!
### Contributing
You are welcome to contribute!
Just create a pull request with your changes :)
2020-01-03 13:08:59 +01:00
2020-02-09 17:22:28 +01:00
### Todo / planned features
Here is a *(surely incomplete)* list of things that i want to include in future versions. *(They are not in any specific order. There is no guarantee that any of those things will ever be included.)*
2020-01-03 13:08:59 +01:00
2020-02-09 17:22:28 +01:00
- render more tile-entities (banners, shulker-chests, etc..)
- render entities (armor-stands, item-frames, maybe even cows and such..)
2020-01-03 13:08:59 +01:00
- configurable markers / regions
- marker / region API
- free-flight-controls
- live player positions
- shaders for dynamic day/night
- more configurations
2020-02-09 17:22:28 +01:00
- easier mod-integration
2020-01-03 13:08:59 +01:00
- BlueMap as forge mod
- ability to display the world-border
2020-02-09 17:22:28 +01:00
- animated textures (if feasible)