/ads opens a clean NUI where players can create and send advertisements like police alerts, EMS notices, mechanic promos, taxi calls, anonymous messages, and custom business ads. Each ad shows as a smooth, scrollable banner to every player on the server. Everything is handled server-side including cooldowns, billing, filtering, and database logging.

🎬 Preview

✨ Features

• 📋 Predefined Ads Police, EMS, Mechanic, Taxi, Realtor, Lawyer, Anonymous, General. Fully editable in shared/adtypes.lua.
• ✏️ Custom Ads Players can create their own ads with title, message, category, logo, background, colour, and sound. Live preview included.
• 🕒 History Last 50 ads saved per player. Resend with one click.
• 🛡️ Admin Panel View recent ads, manage bans, schedule ads, stop running ads, and reset locks.
• 💰 Billing Each ad type can have its own cost. Custom ads use a flat fee.
• ⏱️ Cooldowns Per-player cooldown with UI feedback.
• 🚫 Word Filter Block or censor unwanted words.
• 📡 Discord Logs Sends a clean embed for every ad.
• 🗄️ Database Uses oxmysql and auto-creates the ads history table.
• 🔊 Sounds Supports custom OGG sounds or fallback effects.
• 📍 Banner Positions Six different screen positions supported.
• 🎨 Branding Per-ad styling including logos and colours.
• 🧭 Job Restrictions Control who can send which ads.
• ⚙️ Auto Framework Detection Works with QB-Core and QBox automatically.

📋 Requirements

⚡ Installation

1. Place ads-system in your resources/ folder
2. Add ensure ads-system to your server.cfg
3. Start your server once to generate the database table
4. Edit shared/config.lua for your settings
5. Edit shared/adtypes.lua to match your server

Use /ads in-game and you're ready.

🛠️ Configuration

Config.Framework      = 'auto'

Config.Command        = 'ads'
Config.PlayerCooldown = 120
Config.DisplayTime    = 11
Config.BannerPosition = 'top-center'
Config.CurrencySymbol = 'R'

Config.Billing.enabled  = true
Config.Billing.cashFirst = true

Config.WordFilter.enabled = true
Config.WordFilter.action  = 'block'

Config.Discord.enabled  = true
Config.Discord.webhook  = 'https://discord.com/api/webhooks/...'

Config.SaveAds.enabled      = true
Config.SaveAds.historyLimit = 50

Config.CustomAds.enabled       = true
Config.CustomAds.cost          = 500
Config.CustomAds.titleMaxLen   = 60
Config.CustomAds.messageMaxLen = 400

🎯 Why choose this?

• Simple to use with a single command
• Everything important is handled server-side
• Full logging and moderation tools included
• Works out of the box with QB-Core and QBox