Journeyman's Minimap - Code Plugin for Minimaps and Fog of

[anonymous_user_11c1b2f9]

@;711077

Update 2 is live

In this update, backgrounds textures have gained new options.

Multi-level backgrounds
Robust and simple to use support for multi-level environments has been added. You can now configure multiple levels on a MapBackground actor, each with its own minimap texture or generated background. You define the height of each floor and will see the floor placement previewed in the front and side editor viewports. During gameplay, which floor is rendered is selected based on the Z-position of the MapViewComponent that defines the minimap’s view. You can also set a different SceneComponent whose Z-position will be used by setting MapViewComponent->HeightProxy to any SceneComponent. The functions SetBackgroundTexture(), GetBackgroundTexture() have been updated to receive a LevelIndex parameter, so you can change any level’s texture during gameplay. Here is a GIF of multi-level backgrounds in action:

https://s22.postimg.org/n2zkmd5jl/Multi_Level_BG_2.gif

Priority backgrounds
Do you have an outdoor environment with buildings, and when the player enters a building it should switch to the indoor background texture? This is now easy to do by placing multiple MapBackground actors and assigning different Priority values. When a MapViewComponent is inside multiple MapBackgrounds with different Priority, only the MapBackgrounds with highest priority are rendered. You can thus place one large MapBackground that define the outdoor background texture and place smaller MapBackgrounds with higher priority that define indoor background textures to make the indoor textures show up as soon as entered. Here are priority backgrounds in action:

https://s3.postimg.org/ic6p6jilf/Priority_BG_1.gif

Multi-level backgrounds and priority backgrounds are combinable. When using both features, the MapBackground with highest priority is chosen and the correct floor of that MapBackground is rendered.

Background Z-order
The rendering order of background texture is now controllable via the MapBackground’s ZOrder setting. A background with higher ZOrder is rendered on top. This is useful when you place multiple MapBackgrounds that should be visible at the same time, so you let them have the same Priority. Use this for example if you want to show an indoor background at the same time as the outdoor, but haven’t combined them into a single texture beforehand. By giving the indoor background a higher ZOrder, it will be rendered on top of the outdoor.

Icon interaction with multi-level and priority
MapIconComponent has a new setting to control how they interact with background levels and priority. You can configure the icon to always render or only render when the MapViewComponent (usually on the player) and the MapIconComponent are on the same floor. If the MapIconComponent is inside a MapBackground with high Priority (in-doors) it can be configured to only show on the minimap when the player is also inside that MapBackground (or one of equal Priority).

Show or hide backgrounds
MapBackground actors now have functions SetBackgroundVisible(bool) to control a background texture’s visibility on the minimap during gameplay. This is for you to implement any cases not handled by multi-level or priority backgrounds, for example hiding a room’s background texture until it is explored and then showing it permanently.

Tweaks and bug fixes

• Fixed a broken in-editor documentation link (thanks Peter Ryan)
• Fixed a crash that occurs when using a MapBackground that renders the nav mesh in a packaged game.
• Removed the boolean option “Fill Background” from the Minimap. This setting is now interpreted from “Fill Color” alpha channel.
• Fixed “missing includes” compile errors that occur since UE 4.15.2.

Left: Overview of MapBackground settings as of this update. Right: Configuring a multi-level MapBackground.

Have you updated your documentation with this?