neocturne/MinedMap
1
0
Fork 0
mirror of https://github.com/neocturne/MinedMap.git synced 2025-03-04 17:23:33 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions

README.md: some improvements to the "How to use" and "Installation" sections

Browse source
This commit is contained in:
Matthias Schiffer 2024-01-10 22:40:53 +01:00
parent 2e6a200c6c
commit 7b12c4aea3
Signed by: neocturne
GPG key ID: 16EF3F64CB201D9C
1 changed files with 15 additions and 11 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

26
README.md
View file

@ -12,7 +12,7 @@
![Screenshot](https://raw.githubusercontent.com/neocturne/MinedMap/997a4fb24e89d2cd3c671d77eafaa47084d14304/docs/images/MinedMap.png) ![Screenshot](https://raw.githubusercontent.com/neocturne/MinedMap/997a4fb24e89d2cd3c671d77eafaa47084d14304/docs/images/MinedMap.png)
## How to use ## About
MinedMap consists of two components: a map renderer generating map tiles from MinedMap consists of two components: a map renderer generating map tiles from
Minecraft save games, and a viewer for displaying and navigating maps in a browser Minecraft save games, and a viewer for displaying and navigating maps in a browser
@ -20,16 +20,16 @@ based on [Leaflet](https://leafletjs.com/). The map renderer is heavily inspired
[MapRend](https://github.com/YSelfTool/MapRend), but has been reimplemented from scratch [MapRend](https://github.com/YSelfTool/MapRend), but has been reimplemented from scratch
(first in C++, now in Rust) for highest performance. (first in C++, now in Rust) for highest performance.
The viewer expects the the map data in a directory named `data`. To generate a new ## How to use
map, create this empty directory inside the viewer directory. Next, to generate the
map files run MinedMap passing the source and the destination paths on the command Minecraft stores its save data in a directory `~/.minecraft/saves` on Linux,
line: and `C:\Users\<username>\AppData\Roaming\.minecraft\saves`. To generate minedmap
tile data from a save game called "World", use the a command like the following
(replacing the first argument with the path to your save data; `viewer` refers
to the directory where you unpacked the MinedMap viewer):
```shell ```shell
minedmap /path/to/save/game /path/to/viewer/data minedmap ~/.minecraft/saves/World viewer/data
``` ```
The save game is stored in `saves` inside your Minecraft main directory
(`~/.minecraft` on Linux, `C:\Users\<username>\AppData\Roaming\.minecraft` on Windows)
in a subdirectory with the name of your world.
The first map generation might take a while for big worlds, but subsequent calls will The first map generation might take a while for big worlds, but subsequent calls will
only rebuild tiles for region files that have changed, rarely taking more than a second only rebuild tiles for region files that have changed, rarely taking more than a second
@ -38,7 +38,8 @@ MinedMap as a Cron job every minute.
Note that it is not possible to open the viewer *index.html* without a webserver, as Note that it is not possible to open the viewer *index.html* without a webserver, as
it cannot load the generated map information from `file://` URIs. For testing purposes, it cannot load the generated map information from `file://` URIs. For testing purposes,
you can use a minimal HTTP server, e.g. (if you have Python installed): you can use a minimal HTTP server, e.g. if you have Python installed just run the
following in the viewer directory:
```shell ```shell
python3 -m http.server python3 -m http.server
``` ```
@ -48,7 +49,10 @@ the generated map files to public webspace to make the map available to others.
## Installation ## Installation
Building the MinedMap map generator from source requires a recent Rust toolchain (1.72.0 Binary builds of the map generator for Linux and Windows, as well as an archive
containing the viewer can be found on the GitHub release page.
Building the generator from source requires a recent Rust toolchain (1.72.0
or newer). The following command can be used to build the current development version: or newer). The following command can be used to build the current development version:
```shell ```shell
cargo install --git 'https://github.com/neocturne/MinedMap.git' cargo install --git 'https://github.com/neocturne/MinedMap.git'