-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
1 changed file
with
45 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,45 @@ | ||
# DynmapExport | ||
This is a Spigot plugin that can automatically export dynmap tiles at a set | ||
interval. It will only export when at least one tile in an export configuration | ||
has changed since the last export. | ||
|
||
## Known issues | ||
- The in-game to tile coordinate conversion is not 100% correct. Should be fine | ||
for top-down maps, but may be noticeable for perspective maps. | ||
|
||
## Config file | ||
### `dynmap-host` | ||
The hostname/ip and port on which dynmap is set to run. `localhost:8123` by | ||
default. | ||
|
||
### `auto-combine` | ||
Whether to automatically combine the Dynmap tiles into one single image. | ||
If you have set a large area and you encounter lag when exporting, you can try | ||
disabling this. Note that you will have to combine the tiles yourself. | ||
|
||
### `schedule` | ||
A simplified ISO-8601 formatted interval at which to automatically export all | ||
configurations. | ||
> For example: `10m`, `1h30m`, `1d` | ||
### `exports` | ||
A list of export configurations. Each configuration has the following structure: | ||
- `world`: the name of the world | ||
- `map`: the name of the map | ||
- `zoom`: the zoom-out level, 0 is fully zoomed in. | ||
- `change-threshold`: The minimum fraction of pixels to change before the | ||
automatic export saves the result. | ||
- `from` and `to`: the in-game coordinates that specify the (inclusive) range | ||
of tiles to export. | ||
- `x`, `y` and `z`: the in-game block coordinates | ||
|
||
## Command | ||
- `/dynmapexport now`: export all configurations immediately, separate from the | ||
scheduler. | ||
- `/dynmapexport export <world> <map> <x> <z> <zoom>`: export a single tile at | ||
the given **world coordinates** (not tile coordinates), at y-level 64. | ||
- `/dynmapexport reload`: reload the plugin and config-file. | ||
- `/dynmapexport worldtomap <world> <map> <x> <y> <z> [zoom]`: get the tile | ||
coordinates of the given world coordinates. | ||
- `/dynmapexport purge [all]`: delete all old exports, or delete everything | ||
(also the latest export) if `all` is given. |