Difference between revisions of "How to use the Dynmap"
(→Markers: Updating set info)
(→Sets: default icon)
|Line 84:||Line 84:|
Revision as of 22:55, 26 November 2019
Dynmap is a server plugin which generates an interactive, live-updating map of This Land as a webpage, not unlike Google Maps. Click here to visit.
- 1 Understanding and using the map
- 2 Accessing the tools
- 3 In-game commands
- 4 Markers
Understanding and using the map
On loading the page, the main area is filled with a large bird's-eye view map of the world. The colours on the map are intuitive representations of the blocks visible on the surface (blue = water, green = grass, etc), and shading displays the contours of the surface. Black marks areas of the map which haven't been generated (i.e. no player has been there). A globe icon marks the global spawn point for the map.
The scroll wheel zooms in and out of the map. Click and drag to move around.
Accessing the tools
Overlaid on the map are several sets of controls and information.
There are three tools toward the top left of the screen. Top to bottom:
- Zoom buttons: + to zoom in, - to zoom out.
- Layers: An icon of three sheets. When hovered over, this displays two checkboxes that are checked by default:
- Players: controls whether online players' positions are shown on the map.
- Markers: controls whether the central spawn point is shown on the map.
- Location: Shows the current co-ordinates that the mouse cursor is hovering over on the map (xxx,yyy,zzz).
Clock (top centre)
Compass (top right)
A compass rose shows the in-game directions.
Click this to generate a direct URL link for the exact current view of the map, including exact location, whether it's 2D/3D, and how far you are zoomed in. This is very useful for showing someone a particular location on the map.
For example, here is a link to the isometric/3D/"surface" view of Zero Zero: http://18.104.22.168:8765/?worldname=world&mapname=surface&zoom=5&x=3&y=64&z=4
Along the right edge of the page is a semi-transparent black bar with an arrow on it halfway down. When you hover, a very useful tray slides out.
The sidebar contains two sections:
- Map Types: allows you to switch the map between different views and different worlds, by clicking on the small icons. The overhead view of the world is shown by default.
- World: A map of the overworld. The icon on the left is the overhead (flat) view. The icon in the middle is an isometric (3D) view of the surface. The icon on the right is an isometric view of the caves below the surface.
- World_nether: A map of the nether. The icon on the left is an overhead view, and the right is an isometric view.
- World_the_end: A map of the end. As above, the icon on the left is an overhead view, and the right is an isometric view.
- Players: Shows a list of all players currently online (and not hidden).
- Clicking on a player's name in this list will navigate to them on the map.
- Clicking on a player's head in this list will navigate to them on the map, and your map view will "follow" them as they move in-game.
You can choose to hide yourself from dynmap, so that you are not visible on the map when you're online. (You will still be visible in the game, and your name will show in the tab-list as normal)
To do this, type
/dynmap hide. To reverse it, type
You can add a marker (icon and text label) to the Dynmap to mark your base or tell people about interesting stuff.
The only way for players to add a marker is to place a sign, and if you destroy the sign the marker will be removed from the Dynmap. We strongly recommend protecting the sign with GriefPrevention, so that other people can't remove your markers.
You must type "dynmap" in square brackets on the first/top line of the sign, like this:
[dynmap] (If your marker works, that won't be visible once the sign is placed.)
By default, Dynmap markers go into the "markers" set. To put a marker in a set (such as NetherNetworkPortals or EndGatewayPortals), type
set:set_name on another line.
By default, Dynmap icons look like signs on the map. To change that, type
icon:icon_name on a third line. You can see the icon names here (scroll down a bit).
Anything else on the sign will be the text part (label) on the Dynmap. Labels cannot contain spaces and are case sensitive, but you can use underscores (_) instead of spaces. So something like this would be fine:
Cassolotl_JungleVillage. If the label contains spaces it will not show up on the Dynmap.
Adding a marker to the Dynmap
To easily add a nether network portal to the Dynmap, place two signs - one on the portal in the nether, and one on the portal topside. Replace <label> with the text you would like to appear on the Dynmap portal label. Remember - no spaces, but underscores are okay and it's case sensitive. You should use the icon "portal" and put it in the set "NetherNetworkPortals", so your four rows on the sign should look like this:
- Portals (default icon is
If you don't specify a set when creating a marker it is added to "Markers".
If you'd like a set to be added, contact Cassolotl and ask them to do it. Please note that sets cannot contain spaces and are case-sensitive. Tell Cassolotl whether you'd like the set to be visible or invisible by default.
Mods and the Admin can use commands to add Dynmap markers without signs.
/dmarker add <label> icon:<icon> set:<set-id>(If you omit
set:<set-id>, it defaults it to the "markers" set.)
/dmarker addset <label>
Please note that the label cannot contain spaces! If you put spaces in, it will only use the first word in your label. Labels are also case-sensitive.
To delete markers and sets, Cassolotl has to remove them from the markers.yml file - so please be careful when placing markers!