https://github.com/dantevg/dynmapexport

Auto-export dynmap to image periodically
https://github.com/dantevg/dynmapexport

dynmap minecraft spigot spigot-plugin

Last synced: about 2 months ago
JSON representation

Auto-export dynmap to image periodically

• Host: GitHub
• URL: https://github.com/dantevg/dynmapexport
• Owner: Dantevg
• License: mit
• Created: 2022-10-12T15:41:16.000Z (about 2 years ago)
• Default Branch: master
• Last Pushed: 2024-07-28T09:27:54.000Z (5 months ago)
• Last Synced: 2024-07-28T10:42:15.716Z (5 months ago)
• Topics: dynmap, minecraft, spigot, spigot-plugin
• Language: Kotlin
• Homepage:
• Size: 232 KB
• Stars: 2
• Watchers: 1
• Forks: 0
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# 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     `: 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      [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.