Configuration of worlds

Configuration of worlds

There are two parts in configuration.txt that need to be checked when setting up Dynmap for multiple worlds. The first one is only for server-side rendering of the maps, this has to do with what the server needs to do to render the maps. Another part (under web-section) is about how the browser should show the map (and of course what maps).

Below are the sections from configuration.txt. You can see it contains two worlds: world and nether. The world world has two 'maps', this might not be too obvious since it looks like the server-side section only has one map, but it has two renderers. The maps have two prefixes, these determine the filename of the tiles in minecraft_server/plugins/dynmap/web/tiles/world/. These prefixes have to be unique for that world.

The other world is called nether. It has only one map. Note that this map has a special option called maximumheight which makes the renderer not render the upper part of the world. This is handy for nether-like environments where the upper part of the nether is covered with bedrock.

Server-side section

# The maptypes Dynmap will use to render.
worlds:
  - name: world
    maps:
      - class: org.dynmap.kzedmap.KzedMap
        renderers:
          - class: org.dynmap.kzedmap.DefaultTileRenderer
            prefix: t
            maximumheight: 127
          - class: org.dynmap.kzedmap.CaveTileRenderer
            prefix: ct
            maximumheight: 127
  - name: nether
    maps:
      - class: org.dynmap.kzedmap.KzedMap
        renderers:
          - class: org.dynmap.kzedmap.DefaultTileRenderer
            prefix: nt
            maximumheight: 64

Web section

web:
    defaultworld: world
    worlds:
      - title: World
        name: world
        maps:
          - type: KzedMapType
            title: Surface
            name: surface
            prefix: t
          - type: KzedMapType
            title: Cave
            name: cave
            prefix: ct
      - title: Nether
        name: nether
        maps:
          - type: KzedMapType
            title: Surface
            name: nether
            prefix: nt

How to proceed

Make sure that:

• Your world directories are in the root of minecraft_server, for example minecraft_server/world and minecraft_server/nether.
• Your world directories are places in minecraft_server next to craftbukkit*.jar and not in a subdirectory.
• Your world directories do not contain weird characters and only letters, numbers and _.
• The name of the world in both the server-side-section and the web-section correctly match the name of your world directory, for example world or nether. Please note that these names are case-sensitive!
• defaultmap matches a name of a map in the web-section. Again note that these names are case-sensitive!
• If you change the prefix variable, the prefix in both the server-side section AND the web-section matches.
• After you start the server, place and remove blocks and see whether the tile is visible. Your character should also be visible on the map. You can click your character to quickly go to the world where your character is located.