A fully comprehensive tutorial for webbukkit/dynmap to render the nether roof in Minecraft

Rendering-the-Nether-Roof.md

ℹ: Note, this document is a fork, check out the original here: https://gist.github.com/depwl9992/626bf2c20269abe9cda79eeab0de58af My main alteration to it is that I am running a fabric Minecraft server, and the world name for the Nether is DIM-1in my case, all commands have been altered accordingly I also removed Stuff that is not applicable for my setup!

Initial Setup of the Nether Roof Map

1. Assuming dynmap is already initialized and the folder structure has been generated during a first-time run, <server>/dynmap/custom-perspectives.txt should exist.
2. Open custom-perspectives.txt in a text editor.
3. In this file below the line perspectives: add the following lines of text.

  - class: org.dynmap.hdmap.IsoHDPerspective
    name: nether_top_map_lowres
    maximumheight: 256
    minimumheight: 128
    inclination: 90
    scale: 4
    azimuth: 180

4. If fabric is not running, start it and wait for everything to load, remaining in the server console. If fabric is running, you can re-attach to the console using whatever method you have set up.
5. Run dynmap pause all to halt all live updates to the map.

[12:49:49] [Server thread/INFO]: [dynmap] Full/radius render pause set to true
[12:49:49] [Server thread/INFO]: [dynmap] Update render pause set to true
[12:49:49] [Server thread/INFO]: Full/Radius renders are PAUSED
[12:49:49] [Server thread/INFO]: Update renders are PAUSED
[12:49:49] [Server thread/INFO]: Zoom out processing is ACTIVE

6. If it does not already exist, add a new nether roof map with the command dmap mapadd DIM-1:nether_roof title:"The Roof" perspective:nether_top_map_lowres.
7. If it DOES already exist, you can change the perspective of an existing map with dmap mapset DIM-1:nether_roof perspective:nether_top_map_lowres.
8. Optionally you can change the lighting of the map, so lightsources are easily seen, similar to how they are seen in the End: dmap mapset DIM-1:nether_roof lighting:brightnight

[12:50:25] [Server thread/INFO]: Refreshing configuration for world DIM-1
[12:50:25] [Server thread/INFO]: [dynmap] Loaded 4 maps of world 'DIM-1'.
[12:50:25] [Server thread/INFO]: If you are done editing map data, run '/dynmap pause none' to resume rendering

9. Run dynmap pause none.

[12:51:37] [Server thread/INFO]: [dynmap] Full/radius render pause set to false
[12:51:37] [Server thread/INFO]: [dynmap] Update render pause set to false
[12:51:37] [Server thread/INFO]: Full/Radius renders are ACTIVE
[12:51:37] [Server thread/INFO]: Update renders are ACTIVE
[12:51:37] [Server thread/INFO]: Zoom out processing is ACTIVE

10. Run dynmap cancelrender DIM-1.

[12:54:27] [Server thread/INFO]: Cancelled render for 'DIM-1'

(This could also be blank, meaning no fullrender was in progress.)

11. Run dynmap fullrender DIM-1:nether_roof.

[12:56:54] [Server thread/INFO]: Full render starting on world 'DIM-1'...
[12:58:34] [Dynmap Render Thread/INFO]: Full render of map 'nether_roof' of 'DIM-1' in progress - 100 tiles rendered (50.30 msec/tile, 18.75 msec per render)
[13:00:13] [Dynmap Render Thread/INFO]: Full render of map 'nether_roof' of 'DIM-1' in progress - 200 tiles rendered (53.48 msec/tile, 16.67 msec per render)
[13:01:54] [Dynmap Render Thread/INFO]: Full render of map 'nether_roof' of 'DIM-1' in progress - 300 tiles rendered (49.51 msec/tile, 15.78 msec per render)
[13:03:34] [Dynmap Render Thread/INFO]: Full render of map 'nether_roof' of 'DIM-1' in progress - 400 tiles rendered (45.63 msec/tile, 15.27 msec per render)

Giving the new map an icon

1. In the server console run dynmap pause all
2. Run the command dmap mapset DIM-1:nether_roof icon:images/sign_warp.png
3. Return to the browser and note the updated icon now displays something like a white chat bubble with a black "><":
4. Icons are stored in <server>/dynmap/web/images.
5. You can create or find 16x16px custom PNG images, copying them into this folder for use within the server console.
6. To load the newly copied PNG image, repeat step 2, changing the icon:images/sign_warp.png bit to icon:images/<filename>.png

Example

I threw together this one called which blends the bedrock block texture and the nether_portal block texture, and copied it in as <server>/dynmap/web/images/bedrock_portal.png.

Then I ran the command dmap mapset DIM-1:nether_roof icon:images/bedrock_portal.png, which I'm quite happy with!

5. Finally, run dynmap pause none to resume the fullrender or active rendering process. If a full render is not in progress, the map will only update when a player loads the nether roof chunks and remains there for some minimum amount of time.