Add README.md
This commit is contained in:
parent
304e772353
commit
204bdb5ff3
70
README.md
70
README.md
@ -1,24 +1,56 @@
|
|||||||
# dynmap
|
# LiveAtlas
|
||||||
|
A [Dynmap](https://github.com/webbukkit/dynmap) frontend for the modern web, built with [Vue.js](https://github.com/vuejs/vue) and typescript.
|
||||||
|
|
||||||
## Project setup
|
LiveAtlas is a drop-in replacement for the original Dynmap frontend, which aims to provide a more modern interface and improved performance for busy maps.
|
||||||
```
|
|
||||||
npm install
|
|
||||||
```
|
|
||||||
|
|
||||||
### Compiles and hot-reloads for development
|
Development is ongoing, and there are some rough edges, but most of the Dynmap features used by a typical Minecraft server have been implemented.
|
||||||
```
|
|
||||||
npm run serve
|
|
||||||
```
|
|
||||||
|
|
||||||
### Compiles and minifies for production
|
## Supported Dynmap features
|
||||||
```
|
- Viewing maps
|
||||||
npm run build
|
- Layers
|
||||||
```
|
- Player markers
|
||||||
|
- Custom markers, areas, circles and lines
|
||||||
|
- Popups
|
||||||
|
- Tile/some marker updates
|
||||||
|
- Following players
|
||||||
|
- Location control
|
||||||
|
- Link control
|
||||||
|
- Digital/time of day clock control
|
||||||
|
- Logo controls
|
||||||
|
- New urls (`#world;map;1,1,1,1`)
|
||||||
|
|
||||||
### Lints and fixes files
|
## Not supported right now
|
||||||
```
|
- Chat
|
||||||
npm run lint
|
- Chat balloons
|
||||||
```
|
- Login/register
|
||||||
|
- Marker settings (show labels/min and max zoom)
|
||||||
|
- Legacy urls (`?worldname=world&mapname=map&z=1&y=1&z=1`)
|
||||||
|
- Inactivity timeout
|
||||||
|
|
||||||
### Customize configuration
|
## Installation
|
||||||
See [Configuration Reference](https://cli.vuejs.org/config/).
|
Using an [external webserver](https://github.com/webbukkit/dynmap/wiki/External-Webserver-Basics) is recommended.
|
||||||
|
|
||||||
|
### External webserver
|
||||||
|
1. Download the latest release.
|
||||||
|
2. Extract into your webserver root. Any existing index.html should be overwritten.
|
||||||
|
3. Clear any CDN caches you may have
|
||||||
|
4. Done.
|
||||||
|
|
||||||
|
### Default internal webserver
|
||||||
|
1. Download the latest release.
|
||||||
|
2. Extract into `plugins/dynmap/web`. The existing index.html should be overwritten.
|
||||||
|
3. (Optional) Set index.html as readonly. This will prevent Dynmap overwriting it after every update.
|
||||||
|
4. Clear any CDN caches you may have.
|
||||||
|
5. Done.
|
||||||
|
|
||||||
|
## Customisation
|
||||||
|
The index.html file can be edited to add custom favicons, just like the original Dynmap.
|
||||||
|
You are also free to build LiveAtlas yourself to make further changes.
|
||||||
|
|
||||||
|
## Building
|
||||||
|
First run `npm install` to install LiveAtlas dependencies. You can then either run `npm run serve` to start a local dev server, or `npm run build` to build.
|
||||||
|
|
||||||
|
## Support
|
||||||
|
If you find a bug, please create an issue with as must detail as possible. I'm working on this in my spare time, so fixes are on a best effort basis, but I'll eventually find time for them.
|
||||||
|
|
||||||
|
Please do not contact the Dynmap team regarding any issue with LiveAtlas. They will be very upset.
|
Loading…
Reference in New Issue
Block a user