AHolographicMapActor is the hologram itself. Place it in a level for an in-world 3D map, or let HolographicMapWidget spawn one for the HUD. Create a Blueprint subclass to preconfigure your own map presets.
| Component | Purpose |
|---|---|
| Map Root | Everything that scales/rotates with the map (terrain + markers). |
| Terrain | Static mesh component displaying the Terrain Mesh with the holographic material. |
| Base Plate | Optional cosmetic pedestal — assign any mesh in your Blueprint subclass. |
| Projector Beam | Optional cosmetic beam/cone — assign any mesh in your Blueprint subclass. |
| Property | Default | Description |
|---|---|---|
| Center Mode | Fixed World Center | Fixed World Center / Follow Player Pawn / Follow Actor. |
| Fixed World Center | (0,0,0) | World location shown at the map center in fixed mode. |
| Follow Target | none | Actor followed in Follow Actor mode. |
| World Size | 20000 | Diameter in world units of the area shown. Lower = more zoomed in. |
| Map Shape | Circle | Circle or Rectangle footprint. |
| Map Radius | 50 | Half-size of the hologram in cm (50 = 1 m wide hologram). |
| Rotate With View | false | Rotate the map with the view. In Follow Player Pawn mode it tracks the player camera view yaw (where the player looks), not the pawn body; in Follow Actor mode it tracks the followed actor's yaw. |
| Rotation Mode | Counter-Rotate | Direction the map turns: Counter-Rotate keeps the view pointing "up" on the map (classic minimap); Rotate turns the map the same way the view turns. |
| Property | Default | Description |
|---|---|---|
| Terrain Mesh | none | 1:1 scale simplified mesh of your level. Optional — without it you get a markers-only hologram. |
| Terrain World Origin | (0,0,0) | World position the terrain mesh's pivot corresponds to. |
| Terrain Offset | (0,0,0) | Extra local offset (e.g. lift the hologram above the base plate). |
| Terrain Height Scale | 1.0 | Vertical exaggeration of terrain and Relative Height markers. |
| Property | Default | Description |
|---|---|---|
| Hologram Material | auto | Empty = the included M_HoloBase (additive, unlit, scanlines, fresnel, radial clip). Any material exposing the same parameters works. |
| Marker Material | auto | Empty = the included M_HoloMarker (per-instance colors). |
| Hologram Color | blue | Main tint. |
| Emissive Intensity | 4.0 | Brightness. |
| Scanline Frequency / Speed / Strength | 0.15 / 1.0 / 0.4 | Animated scanline look. Strength 0 disables. |
| Fresnel Strength | 0.6 | Edge glow. |
| Clip Terrain To Map Area | true | Fade terrain outside the map radius (needs M_HoloBase). |
| Property | Default | Description |
|---|---|---|
| Show Markers | true | Master marker switch. |
| Category Filter | empty | Only show these categories (empty = all). |
| Marker Scale Multiplier | 1.0 | Global multiplier on marker sizes. |
| Clamp Markers To Edge | false | Pin out-of-range markers to the map border instead of hiding them. |
| Global Marker Height Offset | 0 | Extra height added to every marker. |
| Max Markers | 0 | Marker count limit (0 = unlimited); highest Priority wins. |
| Property | Default | Description |
|---|---|---|
| Marker Update Interval | 0 | Seconds between marker updates. 0 = every frame. Use 0.1–0.25 for cheap maps with many markers. |
| Zoom Rescan Delay | 0.25 | After World Size (zoom) changes, the terrain rescales instantly and smoothly; a background rescan then refills detail/coverage once the zoom has been steady for this long. Higher = cheaper fast zooming (fewer scans); 0 = rescan as soon as the zoom stops. |
Primitive-shape markers are rendered with Instanced Static Meshes (one draw call per shape type, colors via per-instance custom data), so hundreds of dots are cheap.