UHolographicMapWidget is a UMG UserWidget that shows the holographic map in your HUD. It captures a HolographicMapActor with an orbiting Scene Capture 2D and displays the render target.

Capture d’écran 2026-07-13 225542.jpg

Setup

Create a Widget Blueprint with HolographicMapWidget as parent class.
Add an Image named exactly MapImage — the capture is auto-assigned to it. (Optional: skip the image and use Get Map Brush / Get Render Target for fully custom layouts or your own UI material.)
Add the widget to the viewport.

Where does the map actor come from?

In order of precedence:

Existing Map Actor — if you assign one, it is used (share the in-world hologram with the HUD).
A HolographicMapActor already placed in the level (first one found).
Otherwise the widget spawns one of class Map Actor Class at Spawned Map Location (default: 1 km below the origin, out of sight). Make a Blueprint subclass of HolographicMapActor with your terrain/colors preconfigured and set it as Map Actor Class.

To choose or change the map after the widget exists, call Set Map Actor (see Blueprint functions) — this is the reliable way to point the widget at a specific level actor, since a widget's Existing Map Actor default can't hold a level reference.

Properties

Property	Default	Description
Map Actor Class	HolographicMapActor	Class spawned when no map actor is found/assigned.
Existing Map Actor	none	Use this level actor instead of spawning.
Spawned Map Location	(0,0,-100000)	Where the auto-spawned map lives.
Capture Resolution	512	Square render target resolution (64–4096).
Capture FOV	45	Capture camera field of view.
Capture Source	Final Color (LDR)	Black background, ideal for additive-style HUDs.
Capture Interval	0	Seconds between capture updates. 0 = every frame; 0.05 (20 fps) roughly halves the capture cost — good for low-end platforms.
Camera Distance	220	Distance from the hologram in cm.
Camera Pitch	-50	-90 = top-down, ~-50 = classic hologram angle.
Camera Yaw	0	Rotation around the hologram.
Auto Orbit / Orbit Speed	false / 10°/s	Slow cinematic orbit.

Blueprint functions

Get Map Actor — access the underlying map (zoom, colors, filters...).
Set Map Actor (Map Actor) — change which map actor the widget displays at runtime. This is how you pick a specific map placed in the level (a widget can't reference a level actor from its defaults): get it with Get All Actors Of Class (Holographic Map Actor) and pass it in. If the widget had auto-spawned its own map, that one is destroyed when you switch. Safe to call before or after the widget is constructed.
Spawn And Display Map Actor (Map Class) — spawn a fresh map of the given class (or Map Actor Class) and display it; any map the widget previously spawned is destroyed. Returns the new map actor.
Get Render Target / Get Map Brush — use the capture in your own materials/brushes.
Add Orbit Yaw (float) — rotate the view (bind to drag or Q/E keys).