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.