Improve README.md instructions.

Added instructions that would have made my initial attempts to use the tool less confusing.
This commit is contained in:
Myrddin Emrys 2024-02-14 18:01:25 -06:00 committed by GitHub
parent 9fd3989a95
commit 00eea45375
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -22,13 +22,18 @@ based on [Leaflet](https://leafletjs.com/). The map renderer is heavily inspired
## How to use ## How to use
Download both the release that matches your platform, as well as the platform-
independant viewer archive. Extract the viewer archive. This directory will be made
publicly accessible on a web server and will contain both the html and javascript to
operate the viewer, as well as the image data generated by MinedMap.
Minecraft stores its save data in a directory `~/.minecraft/saves` on Linux, Minecraft stores its save data in a directory `~/.minecraft/saves` on Linux,
and `C:\Users\<username>\AppData\Roaming\.minecraft\saves`. To generate MinedMap 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 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 (replacing the first argument with the path to your save data; `<viewer>` refers
to the directory where you unpacked the MinedMap viewer): to the directory where you unpacked the MinedMap viewer):
```shell ```shell
minedmap ~/.minecraft/saves/World viewer/data minedmap ~/.minecraft/saves/World <viewer>/data
``` ```
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
@ -47,6 +52,10 @@ This test server is very slow and cannot handle multiple requests concurrently,
a proper webserver like [nginx](https://nginx.org/) or upload the viewer together with a proper webserver like [nginx](https://nginx.org/) or upload the viewer together with
the generated map files to public webspace to make the map available to others. the generated map files to public webspace to make the map available to others.
If you are uploading the directory to a remote webserver, you do not need to upload the
`<viewer>/data/processed` directory, as that is only used locally to make updates
process more quickly.
### Signs ### Signs
![Sign screenshot](https://raw.githubusercontent.com/neocturne/MinedMap/e5d9c813ba3118d04dc7e52e3dc6f48808a69120/docs/images/signs.png) ![Sign screenshot](https://raw.githubusercontent.com/neocturne/MinedMap/e5d9c813ba3118d04dc7e52e3dc6f48808a69120/docs/images/signs.png)