Minimap System

The minimap shows a subset of the world map at the top-right corner of the player's screen. It also displays an indicator to show where you are, where the delivery vehicle is, and where your teammates are when playing in team mode. Lastly, it shows the current state of the storm and where the storm will be next so players know how to avoid it.

Players can toggle between the minimap and world map by pressing M on a keyboard, pressing up on a gamepad's DPad, or by touching the minimap on touchscreens.

Structure

The minimap is simply an ImageLabel that displays a previously-generated image and uses CollectionService to show the position of objects with specific tags. All of the UI objects used for the minimap are inside of the minimap screen GUI located in ReplicatedStorage/Assets/GuiObjects.

Adding Indicators

To add new indicators that show up on the minimap, complete these steps:

1. Using the Tag Editor, accessible from the View tab, apply a custom tag to the workspace object that you want to show up on the minimap.

2. Add the ImageLabel you want to represent the object as a child of ReplicatedStorage/Assets/GuiObjects/minimap/mapframe and give it a unique name.

3. Inside of ReplicatedStorage/Libraries/Guis/MinimapGui, locate the MinimapGui.start() function. Inside it, register the tag as shown below, where tag is the tag you registered in step #1 and indicatorLabel is the name of the ImageLabel you added in step #2.

   function MinimapGui.start(teamDividingAngle)
   
   	while not _setupFinished do
   		task.wait()
   	end
   
   	MinimapGui.addMapTag("DeliveryVehicle", "Bus")
   	MinimapGui.addMapTag(Util._clientFocusTag, "LocalPlayerLocation")
   	MinimapGui.addMapTag("Player")
   	MinimapGui.addMapTag("Vehicle", "VehicleLocation")
   	MinimapGui.addMapTag(tag, indicatorLabel)

Customizing the Minimap

To customize the minimap or use the minimap system with your own map and minimap image, you can change these values in ReplicatedFirst/Configurations/MainConfiguration: