UMageItWorldMarkersSettings

Base Class: UObject

Overview

UMageItWorldMarkersSettings is a developer-facing configuration class. Because it uses the config=Game, defaultconfig class specifiers, it automatically integrates into the Unreal Engine Project Settings window.

This class defines the default values that the UMageItWorldMarkersSubsystem will use when the game starts. Any changes made to these settings in the Editor are automatically saved to your project’s DefaultGame.ini configuration file.

How to Access in the Editor

To configure these values without touching code or Blueprints, go to: Edit -> Project Settings -> Game -> MageIt World Markers (Note: The exact category name may vary depending on how the plugin registers it in the module startup).

---

Configuration Properties

These properties define the global default behavior for all markers in your project.

Interaction Settings

• bCrosshairInteractionEnabled (Boolean) The global default for whether markers should react when the player looks at them. If disabled here, it acts as a master switch, preventing individual components from checking crosshair overlaps.
• CrosshairInteractionRadius (Float) The default screen-space radius (in pixels/UI units) around the exact center of the screen (the crosshair). Markers falling within this circle trigger their “Under Crosshair” hover events.
• FocusRadius (Float) The default secondary radius. Usually larger than the crosshair radius, this defines a broader “focus zone” near the center of the screen, useful for highlighting important markers that are simply in front of the player, even if not directly aimed at.

UI & Layout Settings

• ScreenEdgeGap (FMargin) The global default padding applied to markers when they clamp to the edge of the screen. Prevents markers from clipping into monitor bezels or overlapping with static UI elements (like minimaps or health bars).
• CanvasPanelZOrder (Integer) The default Z-Order of the master canvas panel that holds all the marker widgets. Increase this if you need the world markers to render on top of other persistent UI elements (like the main HUD).

Optimization & Performance

• MarkerVisibilityTestChunkSize (Integer) The default number of markers to test for visibility (distance to player checks) per frame. Keeping this number relatively low (e.g., 10-20) ensures your frame rate remains stable even if hundreds of markers are present in the level.

---

C++ API: Reading Settings at Runtime

If you need to access these global defaults in your own C++ classes before the subsystem has initialized, you can easily read them using the Class Default Object (CDO):

#include "MageItWorldMarkersSettings.h"

// Retrieve the default settings object
const UMageItWorldMarkersSettings* DefaultSettings = GetDefault<UMageItWorldMarkersSettings>();

if (DefaultSettings)
{
    float Radius = DefaultSettings->CrosshairInteractionRadius;
    // Use the radius...
}