# Client Notifications Usage Guide - forge-docus
The client notifications addon owns the notification HUD, notification sound, and local notification service used by Forge client and server modules.

Client Addons

# Client Notifications Usage Guide

The client notifications addon owns the notification HUD, notification sound, and local notification service used by Forge client and server modules.

# Client Notifications Usage Guide

The client notifications addon owns the notification HUD, notification sound, and local notification service used by Forge client and server modules.

## Runtime Behavior

The notification display is created during client initialization. The browser HUD sends:

    notifications::ready

When that event is received, `NotificationService` initializes and sends a startup notification.

## Create a Notification

Use the notification service when available:

    GVAR(NotificationService) call ["create", [
        "success",
        "Title",
        "Notification text.",
        4000
    ]];

Arguments:

Argument | Purpose
--- | ---
`_type` | Notification type, such as `success`, `info`, `warning`, or `error`.
`_title` | Notification title.
`_content` | Notification body text.
`_duration` | Display duration in milliseconds.

The service dispatches a browser `forge:notify` custom event.

## CBA Event Surface

Other addons can use the client notification event:

    ["forge_client_notifications_recieveNotification", [
        "warning",
        "Garage",
        "Vehicle spawn position is blocked.",
        3000
    ]] call CBA_fnc_localEvent;

The event payload is:

    [_type, _title, _content, _duration]

## Usage Rules

- Use the shared notification service instead of opening separate transient browser UIs.
- Keep server-driven player feedback short and actionable.
- Treat notification state as transient client UI state.
- Do not use notifications as the only record of durable domain changes.

## Related Guides

- Client Usage Guide
- Client Garage Usage Guide
- Client Bank Usage Guide
- Client Store Usage Guide

Edit this page or Report an issue

Client Locker Usage Guide

The client locker addon manages personal locker display state, local locker container behavior, and virtual arsenal unlock state.

Client Organization Usage Guide

The client organization addon provides the organization portal UI and browser bridge for login, registration, membership, invites, credit lines, leave and disband flows, assets, fleet, and treasury display.