ds-notifications

# DS Notifications

A drop-in notification system for FiveM with a fully custom NUI toast design, a live in-game layout editor, and a permission-gated /announce broadcast — built for **QBCore, ESX, Qbox, and ND_Core**.

## Features

• **Custom toast UI** — clean, animated notifications with `success`, `error`, `warning`, `info`, and `announcement` types, each with its own icon and sound.

• **Auto framework detection** — works out of the box on QBCore, Qbox, ESX, and ND_Core, or force a specific framework in `config.lua`.

• **In-game layout editor** — players open a config menu (default keybind or `/notificationsuiconfig`) to drag notifications to any corner of the screen; layout is saved per-player to the database.

• **Server-wide announcements** — `/announce` command broadcasts a styled announcement toast to every connected player, with permission checks via ACE, QBCore/Qbox `HasPermission`, ESX groups, or ND_Core groups.

• **Exports + events** — trigger notifications from any other resource via a simple export or `TriggerEvent`, from both client and server side.

• **Sound alerts** — per-type notification sounds with configurable volume, can be disabled entirely.

• **Stacking control** — configurable max visible toasts, oldest are cleared automatically when the stack overflows.

• **Persistent per-player settings** — saved layout/config is restored automatically on reconnect via a single SQL table.

• **Lightweight** — no heavy dependencies, minimal resmon impact.