2023-05-21: Yes, we're back. No, you can't login yet

Map System

Uploaded by Queuenard

The add-on board icon. Clients
The add-on file name icon. Client_MapSystem.zip
The add-on upload date icon. Feb 4th 2018, 5:23 AM
The add-on download count icon. 1,391

Description

A Map System GUI to show you where you are in the game world.

After my Map GUI for BLOCKLAND SURVIVAL and a version for Heedicalking's Pirate RPG that was never released, I realized I needed to make a map system addon instead of an addon for every different map.

Features:

  • Choose a specific map to show (including 3rd party-registered maps and the default one which has two versions: a 20000x20000 and a 4000x4000 map with basic axis labels)
  • Single tap to open the quick view which doesn't interrupt other input such as movement and chat
  • Double tap to open the same map view as well as settings, display options and map selection
  • Automatic switching of submaps (or master if no relevant submap) for transition from area to area
  • Label control (choose whether to show labels if the map provides any)
  • 2D, top-down images
  • Death dots which show the location of the player's last 10 deaths
  • Direction dots which show where the player is facing for 27944 units (55886 bricks) ahead, enough to span diagonally across a 20000x20000 unit map (40000x40000 bricks)
  • 3rd party addons can call a function to register their own map and have it appear in a list the player can choose

Drawbacks and future plans:

  • no 3D isometric support (as seen on the server list on blockland.us) and this feature is low priority
  • Server not yet able to inform a client of a particular map that's in use
  • The player's movement history is not tracked (including admin orbing as well)
  • Not more than 10 deaths can be displayed
  • There is no arrow to show where the player wanders if it is beyond the boundaries of a map
  • The direction dots should have a distance or time written above them based on setting and speed input box (Amir's suggestion)

Registering a 3rd party map:

function MapSystem_registerMap(%master, %submap, %type, %imgext, %p1, %p2, %path, %hasLabelVers)

Register each submap (including the "master" submap which is required) with a call to this function.

%master - A name for this map (like "Heedicalking's Pirate RPG" or "Crown's Jailbreak") %submap - A name for a submap. Any submap named "master" will be the default if no submap with relevant boundaries is found. Example names: "Small Island", "Arstotzka" or "Gefangnis" %type - "2D" is the only valid map type for now %imgext - the physical the dimensions of the image, in (y, x) format %p1 - the bottom left corner of the image using the position in the 3D world %p2 - the top right corner of the image using the position in the 3D world %path - a path to the image. PNG only. %hasLabelVers - "1" or "0"; describes whether there is a labeled version of the map. If there is a labeled version, the string "_labeled" is prepended to ".png" when a labeled version is being displayed.

Changelog

0.0.0 - First release 0.0.1 - Bug fix that fixes crash when spawning. MapSystemMockGUISubcontainer can't be present in PlayGUI when the player first spawns (when PlayGUI is first displayed) for some reason. 0.0.2 - Added position and speed indicator on lower left corner of full GUI 0.0.3 - Added Z value to position indicators, added ground speed to lower left corner of full GUI 0.0.4 - Position and speed information now show on the quick view

Comments (1)

Chazpelo
2019-12-25 20:24:44
changelog formatting is broken