https://github.com/dantevg/dynmapexport

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

dynmap minecraft spigot spigot-plugin

Last synced: 3 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 (over 3 years ago)
• Default Branch: master
• Last Pushed: 2024-11-30T16:23:48.000Z (over 1 year ago)
• Last Synced: 2025-03-26T14:08:33.303Z (about 1 year ago)
• Topics: dynmap, minecraft, spigot, spigot-plugin
• Language: Kotlin
• Homepage:
• Size: 234 KB
• Stars: 3
• Watchers: 1
• Forks: 0
• Open Issues: 5
• 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.

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

- `area-change-threshold`: The minimum fraction of pixels to change before the

  automatic export saves the result.

- `colour-change-threshold`: The minimum difference in colour of two pixels for

  them to be considered changed. This is especially useful for maps generated

  by ChunkyMap, since they tend to have lots of unnoticeable changes in noise.

  Changes in dark colours are weighed heavier than changes in light colours.

- `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.