heyheythere - World Map, Minimap & Compass System

A world map, minimap and compass bar for your game, in one C++ plugin with its whole surface in Blueprint. The map is drawn from your own level in one click; fog of war, pins and the tracked marker play in multiplayer and save into your save game.

The guide: heyheythere.com/docs/map-minimap-compass, a fifteen-minute quickstart into the Third Person template, and every node and setting. Read it before you buy.

The map, from your level

  • Capture Map on a region: the level shot from above, saved as a texture beside it
  • Atlas style: parchment, hill shading, contour lines, inked edges and rings on the water
  • Or Photo style: the level as it is lit, seen from straight above
  • Paper, inks, contours and shadows set per region
  • Drawn as play begins instead, or captured live for a small level that changes

Minimap and compass

  • A minimap round or square, turning with the camera or north up, with zoom
  • Markers out of reach held at its rim with an arrow pointing the way
  • A compass bar: the bearings ahead, each marker's bearing and distance, the tracked one highlighted
  • Markers over their places on screen, or at the screen's edge pointing the way
  • A place's name on a ribbon as the player discovers it
  • A small glint on what the player can use (a waystone, a chest, a door), hidden behind walls; on or off per thing or for the whole game

World map

  • Pan and zoom with mouse or gamepad; it opens on the player
  • Labels placed where they fit, tooltips, a legend that filters by category
  • Players place, edit and remove their own pins: right-click, or X on a gamepad
  • Track a marker or a pin: the compass highlights it and a route on the navmesh leads there
  • Fast-travel markers: a click calls your Blueprint event, which moves the player

Fog of war and discovery

  • Each player's own fog, cleared round them as they walk, as far as each region sets; the rest dimmed or blank paper
  • Named areas with an On Area Discovered event
  • Reveal a place, a region or every region from Blueprint, or reset it
  • Fog of exploration for RPGs and adventures, not an RTS's line of sight

Markers

  • A Marker component on any actor, a Marker actor on its own, or a pin that is only data
  • Icon, label, category, colour, size and priority; how close each view shows it
  • 14 icons included: town, waystone, quest, camp, cave, farm, fishing and more
  • Each view draws all its markers at once, no widget a marker

Floors and regions

  • Each region its own map; a region inside another is a floor of it: a cave, a cellar, an upper storey
  • The maps switch as the player goes up or down
  • An Underground style for caves: no sun; the floor a player can walk light and inked, the rock dark, read off the navmesh
  • The route drawn on each floor alone, ringed where it goes up or down

Blueprint

  • Ready on enabling: the Map HUD on each player's screen, M or the gamepad's Menu button opens the world map
  • Every node, event and setting in Blueprint, and C++ for those who want it
  • Minimap, Compass Bar, World Map, Glints, Screen Markers and Area Toast are widgets for your own Widget Blueprint
  • Restyle the Map HUD from a Widget Blueprint, or turn it off in the project settings
  • Keyboard, mouse and gamepad on the world map

Multiplayer

  • The server owns each player's fog and pins, replicated to that player alone
  • Shared pins and pings reach the player's team only
  • Tested with two players on a listen server

Save

  • Save Map gives fog, pins and the tracked marker for your own save game; Load Map brings them back
  • A region's fog is at most 8 KB, 2 KB by default
  • In multiplayer a client's load goes through the server, which sends the player's map back

Debugging

  • Map.Reveal, Map.Reset, Map.Markers, Map.Track and Map.Capture console commands
  • A Gameplay Debugger category: the region, fog revealed, areas, pins and tracking as they change
  • Data Validation and Map Check name a region without its map, or moved since its capture

The demo

  • The valley in the video: a village, a mill, a river, waystones and a two-floor cave
  • A quest board to track, pins, fast travel, and save and load buttons; a glint on each thing the player uses
  • Two players on a listen server, each with their own fog
  • It ships in the plugin's Content/Demo folder (turn on Show Engine Content and Show Plugin Content)
  • Epic's mannequins in a project made from the Third Person template, plain stand-ins otherwise

Engines and platforms

  • Unreal Engine 5.6, 5.7 and 5.8
  • Windows, Mac and Linux
  • The full C++ source, in a Blueprint-only or a C++ project
  • Needs only the engine's own Enhanced Input plugin

Support through this page's comments or by email.