Web UI Parameters - webbukkit/dynmap GitHub Wiki

The URL used to launch the web user interface supports a number of parameters, which may be used to override the default view presented to the user. This can be used to launch the UI with a given world or map selected, a given zoom level selected, and/or have the map centered on a given set of world coordinates.

The parameters are provided as a sequence of attribute-value pairs, with each parameter formatted as follows:

attribute-id=value

The base URL must have a question-mark (?) before the first parameter, and each additional parameter must be separated from the previous one by an ampersand (&). So, if the default URL for the map web is:

http://mygreatserver:8123/

then, launching the site with the world named 'fred' selected, and with the map 'surface' being shown, would be formatted as:

http://mygreatserver:8123/?worldname=fred&mapname=surface

If you're using an external server, the same format applies - add '?' and the corresponding parameters, seperated by ampersands:

http://mycoolapacheserver.com/dynmap?worldname=fred&mapname=surface

The parameters available are as follows:

  • worldname - this specifies the name (not the title) of the world to be selected. If not provided, the first world defined will be shown (unless defaultworld has been set in configuration.txt, in which case that world is shown).

  • mapname - this specifies the name (not the title) of the map to be selected. If not provided, the first map for the selected world is shown (unless defaultmap has been set in configuration.txt, in which case that map is shown).

  • zoom - this specifies the zoom level to be selected (0 = highest zoom out). If not provided, a zoom level of zero is used (unless defaultzoom has been set in the configuration.txt).

  • x - this specifies the X coordinate (in the coordinate system of the world being shown) of the center point of the map view. If not specified, this defaults to the value of the x attribute of the center attribute of the selected world (typically 0).

  • y - this specifies the Y coordinate (in the coordinate system of the world being shown) of the center point of the map view. If not specified, this defaults to the value of the y attribute of the center attribute of the selected world (typically 64).

  • z - this specifies the Z coordinate (in the coordinate system of the world being shown) of the center point of the map view. If not specified, this defaults to the value of the z attribute of the center attribute of the selected world (typically 0).

  • nopanel - if defined and set to 'true', the sidebar menu on the map will be removed

  • chatname - if defined and set to a string, the web UI will pass this value as the suggested name of the sender for any chat messages. This will only be accepted by the internal web server if the 'trustclientname' setting has been set to true, in addition to the 'allowurlname' parameter for the 'chat' component. Supported on 0.28 and later.

  • playername - if defined and set to a player's account name, the web UI will initialize following the position of the given player, if the are online when the UI starts, or come online sometime after.

  • hidechat - if defined and set to 'true', the web UI will disable all chat input and output components (balloons, input fields, and chat box).

  • nogui - if defined and set to 'true', the web UI will disable ALL controls, panels and the like, just presenting the map layer itself.

  • nocompass - if defined and set to 'true', the compass rose on the UI will be hidden (v2.2-alpha-1)