How to use the Dynmap

From This Land Wiki
Revision as of 23:00, 26 November 2019 by Cassolotl (Talk | contribs) (Sets: Recommending icon:portal)

Jump to: navigation, search
A typical view upon loading the Dynmap page in your browser.

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.

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.

Players who are online (and not hidden) are shown on the map with an icon of their in-game skin's head. These are also labelled with their IGN and their current health and armour bars.

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.

Navigation tools (top left)

The top left tools on the Dynmap.

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)

A clock showing the time as 19:30 in-game, with the moon rising, the sun almost completely set, and the sky clear to show the moon on the right.
The in-game time is represented with moving sun/moon icons, and in numbers. The large moon or sun icon to the right of this shows the current weather (clouds, rain, etc).

Compass (top right)

A compass rose shows the in-game directions.

Communication and connectivity (bottom left)

In the lower left corner is a small chain-link icon button: Dynmap Chainlink Icon.png

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://89.34.96.19:8765/?worldname=world&mapname=surface&zoom=5&x=3&y=64&z=4

Players and map types (sidebar)

Here's the tray with one player logged in. It covers the compass rose when it pops out. The overhead view of the world is currently in use, and that icon is highlighted.

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.

In-game commands

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 /dynmap show.

Markers

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:

[dynmap]
CassiansBase
icon:portal
set:Portals

Sets

  • Portals (icon:portal is recommended when adding to this set!)
  • Markers

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.

Commands

Mods and the Admin can use commands to add Dynmap markers without signs.

See names for icons here (scroll down a bit). See a full list of commands (some of which appear to not work) here.

  • /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!