ChunkyMap

ChunkyMap is a map renderer for Dynmap that uses Chunky to render the map tiles. This combines photorealistic rendering with the convenience and automatic updates of Dynmap. ChunkyMap is implemented as a drop-in replacement for the HDMap that comes with Dynmap.

Installation

Download the latest jar from the releases page and put it in your plugins directory.
Edit plugins/dynmap/worlds.txt and change the class option from org.dynmap.hdmap.HDMap to de.lemaik.chunkymap.dynmap.ChunkyMap for all maps that you want to render with Chunky.
You can use any perspective and resolution for those maps (list of available perspectives).

This example worlds.txt for a single map of a world called world might help you:
```
worlds:
  - name: world
    maps:
      - class: de.lemaik.chunkymap.dynmap.ChunkyMap
        name: chunky
        title: World
        perspective: iso_SE_30_hires
```
Restart your server (restart not reload).
Re-render the worlds you enabled the new renderer for by running the following command from the server console: dynmap fullrender world (replace world with the actual world name).
Wait for it… ⌛
Wait for it… ⌛ (Sorry, rendering with Chunky takes a while, but it's worth it!)
Take a look at your new, shiny maps! ✨

Configuration

The maps can be configured by adding options to the map's section in the world.txt file.

Option	Description	Default
`samplesPerPixel`	Samples per pixel that Chunky should render. More SPP improves the render quality but also increases render time.	100
`chunkyThreads`	Number of threads per Chunky instance. More threads will decrease render time but increase the CPU load of your server.	2
`texturepack`	Texturepack path, relative to `plugins/dynmap`. Use this option to specify a texturepack for a map. The texturepack in Dynmap's `configuration.txt` is ignored by ChunkyMap.	None
`chunkPadding`	Radius of additional chunks to be loaded around each chunk that is required to render a tile of the map. This can be used to reduce artifacts caused by shadows and reflections.	0
`templateScene`	Path to a Chunky scene file (JSON), relative to `plugins/dynmap`. Use this option to customize the scene that is used for rendering the tiles, e.g. to change the water color.	None
`texturepackVersion`	The Minecraft version that should be used as fallback textures	1.16.2
`denoiser.enabled`	Enable denoising using Intel Open Image Denoise. Only works on Linux	false
`denoiser.albedoSamplesPerPixel`	Samples per pixel for the albedo map. Setting this to 0 will disable the albedo and normal map.	4
`denoiser.normalSamplesPerPixel`	Samples per pixel for the normal map. Setting this to 0 will disable the normal map.	4

Example config

worlds:
  - name: world
    maps:
      - class: de.lemaik.chunkymap.dynmap.ChunkyMap
        name: chunky
        title: Chunky
        perspective: iso_SE_30_hires
        chunkyThreads: 2
        samplesPerPixel: 20
        denoiser:
          enabled: true
          albedoSamplesPerPixel: 4
          normalSamplesPerPixel: 4

Ceveats

Rendering is pretty slow, but I'll improve this by rendering multiple tiles as one image in the future.
ChunkyMap only works with Bukkit/Spigot at the moment. Supporting more servers would be awesome, though!

Dynmaps that use this plugin

Craften Server: Lobby dynmap

Building ChunkyMap

Get the latest version of Chunky 2. After updating, you'll find the jar file in ~/.chunky/lib (Linux/Mac) or %APPDATA%\.chunky\lib (Windows). Copy the chunky-core-<version>.jar file into the root directory of this repository and rename it to chunky.jar.
Run mvn install to install all other dependencies. Chunky 2 can't be installed this way because it's not yet in the Maven repository.
Run mvn clean package, the plugin jar will be in the target directory.

Copyright & License

Permission to modify and redistribute is granted under the terms of the GNU General Public License, Version 3. See the LICENSE file for the full license.

ChunkyMap uses the following third-party libraries:

Chunky by Jesper Öqvist
Chunky is covered by the GNU General Public License, Version 3. See the license file in licenses/gpl-3.txt.
Commons Math by the Apache Software Foundation
Commons Math is covered by The Apache Software License, Version 2.0. See the license file in licenses/commons-math.txt.
DynmapCore by mikeprimm
DynmapCore is covered by The Apache Software License, Version 2.0. See the license file in licenses/apache-2.txt.
Gson by Google
Gson is covered by The Apache Software License, Version 2.0. See the license file in licenses/apache-2.txt.
OkHttp by Square
OkHttp is covered by The Apache Software License, Version 2.0. See the license file in licenses/apache-2.txt.

Trivia

Originally, ChunkyMap was created as a demo for the RenderService. This service allows rendering the tiles on a distributed network of renderers, which is often faster than rendering the tiles locally.

Ironically, I then implemented support for local tile rendering and removed support for using the RenderService. It will come back in the future.

stormboomer/ChunkyMap