struct

ArcUIWorldWidgetComponent

Binds a .ui widget tree to an entity's position in the world — the WidgetComponent analog: nameplates over players, ping markers, interaction prompts. The host drives it through CArcUIScreenStack::SyncWorldWidgets, which projects the entity's world position (plus offset) through the camera and places the built tree on the overlay at that point, scaled by distance and faded out past drawDistance. Interaction is off by default: the tree is built hit-test invisible so it never steals gameplay clicks.

Module
ArcUI
Header
#include "ArcUI/ECS/Components/ArcUIWorldWidgetComponent.h"
Namespace
Mowo
Reflection
Reflected by MowoHeaderTool

Properties

TypeNameDescription
std::stringassetPath
Vec2sizeDefault Vec2(240.0f, 72.0f).
Vec3offsetDefault Vec3(0.0f, 2.0f, 0.0f).
floatscaleDefault 1.0f.
booldistanceScaleDefault true.
floatreferenceDistanceDefault 8.0f.
floatdrawDistanceDefault 50.0f.
floatfadeDistanceDefault 8.0f.
boolinteractiveDefault false.
boolvisibleDefault true.
boolworldSpaceTrue = render the widget tree into an offscreen texture and draw it as a real in-scene quad (depth-tested, occluded by geometry — nameplates, ping markers). False = the legacy screen-space projection onto the 2D overlay. Default true.
boolfaceCameraWorld-space quad only. True = the quad always faces the camera (billboard); false = it is oriented by the entity's transform (a plaque on a wall). Ignored by the screen-space path. Default true.
floatworldWidthWorld-space quad only. The quad's physical width in world units; its height follows the design aspect (size.y / size.x). Drives how large the nameplate reads in the scene independent of the design pixel size. Default 1.5f.
uint32_tmaxTexelsWorld-space quad only. Longest edge of the offscreen render target at the reference distance; the LOD shrinks it further away so an idle far nameplate costs almost nothing to re-render. Default 512.
boolmountedDefault false.
Generated from ArcUI/ECS/Components/ArcUIWorldWidgetComponent.h via arcui.json · Nov 4, 2026Version 1.0.0