World Text

Namespace: DeadworksManaged.Api

Display text in the 3D world or anchored to a player's screen.

CPointWorldText

Wraps the point_worldtext entity — a world-space text panel rendered in 3D.

Creating World Text

var text = CPointWorldText.Create(
    message: "Hello World",
    position: new Vector3(100, 200, 300),
    fontSize: 100f,
    r: 255, g: 255, b: 255, a: 255,  // RGBA color
    worldUnitsPerPx: 0
);

Parameters

Parameter	Type	Description
message	string	Text to display
position	Vector3	World-space position
fontSize	float	Font size in pixels
r, g, b, a	byte	RGBA color components
worldUnitsPerPx	int	World units per pixel (0 = default)

Updating Text

text.SetMessage("Updated text!");

Cleanup

text.Remove();  // Inherited from CBaseEntity

ScreenText

Displays world text anchored to a player's camera (screen-space). Internally uses a CPointWorldText entity parented to the player.

Camera Offset

Deadlock uses a right-shoulder third-person camera, positioned ~35 units to the right of the player's eye position. ScreenText positions are relative to the model eye, not the actual camera — so screen-center coordinates are not (0.5, 0.5).

Calibrated center position: posX: 2.341f, posY: 2.6f (these values are far beyond the 0-1 range due to the shoulder offset).

Positioning Tips

Parameter	Recommended Value	Notes
fwdOffset	-50f	Places text close to camera (behind eye position)
posX	2.341f	Horizontal center (accounting for shoulder camera)
posY	2.6f	Vertical center
PixelSize	50f	Good size for pixel art blocks
SpacingX	0.023f	Horizontal character spacing
SpacingY	0.06f	Vertical character spacing (~2.6x taller than wide for "█")

Pixel Art

Use the full block character "█" for pixel-art style displays. The "." character is invisible at small sizes. The block character is approximately 2.6x taller than wide, so adjust SpacingX and SpacingY accordingly for square pixels.

Example: Toggle Screen Overlay

From the Deathmatch plugin:

private CPointWorldText? _screenText;

[ChatCommand("worldtext")]
public HookResult OnWorldText(ChatCommandContext ctx)
{
    var pawn = ctx.Controller?.GetHeroPawn();
    if (pawn == null) return HookResult.Handled;

    if (_screenText != null)
    {
        _screenText.Remove();
        _screenText = null;
        return HookResult.Handled;
    }

    // Create text at screen center
    _screenText = CPointWorldText.Create(
        "OVERLAY TEXT",
        pawn.EyePosition,  // Will be parented to player
        fontSize: 200f,
        r: 255, g: 255, b: 255, a: 255
    );

    return HookResult.Handled;
}

See Also

• Entities — Base entity operations (Remove, SetParent)
• Networking — HUD announcements as an alternative