Skip to content

Instantly share code, notes, and snippets.

@tgzw
Last active June 13, 2025 21:56
Show Gist options
  • Select an option

  • Save tgzw/4e2faf5b4de8b1b28fa2ade3c6fb87e0 to your computer and use it in GitHub Desktop.

Select an option

Save tgzw/4e2faf5b4de8b1b28fa2ade3c6fb87e0 to your computer and use it in GitHub Desktop.
Tutorial to add a 3D/Surface (or Top) view of the nether roof to the dynmap maps.

3D/Surface (or Top) view of the Nether Roof in Dynmap

  1. Open <server>/dynmap/custom-perspectives.txt
  2. Below the line perspectives: and add the following:
  - class: org.dynmap.hdmap.IsoHDPerspective
    name: nether_SE_map_hires
    maximumheight: 256
    minimumheight: 128
    inclination: 30
    scale: 16
    azimuth: 135
  • name can be whatever we want. Later we will use it.
  • maximumheight and minimumheight are self explanatory
  • inclination is the angle, in degrees below horizontal, of the viewpoint for the map: 90 = top view, 0 = horizontal. With 30 we get a nice side view. If we want a Top view, we'll leave it in 90.
  • scale is the scale or resolution used for rendering the scene, in pixels per block edge.
  • azimut is the angle, in degrees clockwise from north, of the viewpoint for the map : 0 = north, 90 = east, 180 = south, 270 = west. For a South-East view, we'll leave it in 135.
  1. We save the file and restart the server.
  2. Run dynmap pause all
  3. In order to know the name of the nether map, we run dmap worldlist. It should appear 3 and it should be the second one. Probably is called world_nether or DIM-1. Henceforth, we'll asume it is called world_nether
  4. We have two options:
    • (most likely) To add a new view to the nether map with the custom perspective we run dmap mapadd world_nether:nether_roof_side title:"The Roof" perspective:nether_SE_map_hires
    • To change the perspective of an already existing view of the nether map, we run dmap mapset world_nether:nether_roof_side perspective:nether_SE_map_hires
  5. To give a icon to our new view, we run dmap mapset world_nether:nether_roof_side icon:images/block_other.png
    • In order to choose a custom icon, we save a 16x16px png image in <server>/dynmap/web/images and re-run the previous command with the name of the image.
  6. Run dynmap pause none
  7. (not indispensable) To start a full render we run dynmap fullrender world_nether:nether_roof_side
  8. Profit

Sources:

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment