Client API

Top Notify

Shows the native RedM cinematic two-line mission-header notification using the UiFeedPostTwoTextShard native (0xA6F4216AB10EB08E). No framework required — pure native.

TopNotify(title, msg, headerFallback)client

Displays a cinematic two-line mission-header notification. Pass only title for a single-line header using the fallback label.

Param	Type	Description
title	string	Large upper line, or the full message if `msg` is omitted.
msg	string \| nil	Smaller lower line.
headerFallback	string \| nil	Label shown in the upper slot when only `title` is passed. Defaults to `"Wild County"`.

WcNotify(msg, level, placement)client

Fires the wc_notify:send event (configurable via WCLibConfig.WcNotifyEvent) for a HUD notification.

Param	Type	Description
msg	string	Notification message text.
level	string \| nil	`"INFO"` \| `"SUCCESS"` \| `"WARNING"` \| `"ERROR"`. Defaults to `"INFO"`.
placement	string \| nil	Placement hint. Defaults to `"middle-right"`.

example

-- Two-line cinematic header
wc:TopNotify('New Contract', 'Speak to the stranger at Flatneck Station')

-- One-line (uses "Wild County" as the header)
wc:TopNotify('Mission complete!')

-- Custom header label
wc:TopNotify('10 Gold earned', nil, 'Reward')

-- wc_notify HUD notification
wc:WcNotify('Deer harvested successfully', 'SUCCESS')

Use wc:, not WCLib. WCLib is an internal global that only exists inside the wc_libs resource's own Lua state. Other resources can't see it — always call through the wc export proxy (wc:TopNotify(...)), exactly like every other function on this site.

Real Wild County example — stagecoach mission start

wc_stagecoach/client/main.lua

wc:TopNotify('Stagecoach Run', 'Deliver the mail sack to Valentine')

Common mistakes

Calling WCLib.TopNotify(...) from another resource — that global doesn't exist outside wc_libs itself. Always use wc:TopNotify(...).
Using TopNotify for frequent/spammy notifications — it's a cinematic, attention-grabbing native meant for mission starts/completions, not routine HUD messages. Use Notify or WcNotify for those instead.
Calling this from the server — TopNotify is client-only. To trigger it for a specific player from server code, fire your own client event that calls it.

Troubleshooting

If nothing appears on screen: confirm you're calling it client-side — there is no server-side TopNotify bridge built in.
If WcNotify does nothing: the wc_notify resource isn't installed — this call no-ops gracefully rather than erroring, by design.

← backGround markers next →Native prompts