# UNEXIS Ad System V2 (QB-Core | QBox)

Modern, polished advertisement system for QB-Core/QBox with a single /ads command, a clean NUI composer, job-gated ad types, server-side cooldowns, optional per‑ad billing, custom sounds, and Discord logging.

## Highlights

- One command: /ads opens a fast, searchable composer (type to filter ad types).

- Job-gated options: players only see ad types allowed for their job; Admin/God can access all (including hidden).

- Per‑ad pricing: charge per ad ID (cash first, then bank) with your currency symbol.

- Smooth UI: icon + sender + subject + scrolling message, and a progress bar.

- Sound: play a custom OGG via NUI (recommended) or GTA frontend beeps; volume control supported.

- Global sequencing: only one ad shows server-wide at a time; per‑player cooldown prevents spam.

- Discord embeds: log each ad with sender/subject/content and player info.

- Update notice: prints available update info in the server console.

### Feature overview

- Access control

  - Per-ad `allowedJobs` gating; hidden ad types for Admin/God only.

  - uses qb-core permissions (`admin`, `god`).

- Composer UX

  - Searchable list with icons, labels, per-ad cost, and last-selected memory.

  - Message box with server-side validation and word filtering.

- Display & UX

  - Crisp banner with icon, sender, subject, and auto-scrolling message text.

  - Adjustable scroll delay/duration and display time; progress bar; left/right position.

- Monetization

  - Per-ad pricing with flat or per-job override models; currency symbol support.

  - Cash-first, then bank deduction; failure if funds are insufficient.

- Anti-spam & security

  - Global single-ad display lock; per-player cooldown.

  - Optional profanity/slur filter (censor or block).

  - Resource name enforcement to prevent unauthorized re-packs.

- Observability

  - Discord embed logs with player name and CitizenID.

  - Version check notice in server console.

---

## Requirements

- FiveM build 3095 or higher

- qb-core | qbox

- ox_lib

VIDEO : https://youtu.be/Ro9-1ZTiwIE