Installation

1. Drop the resource

Extract suty-announce into resources/[suty]/suty-announce.

2. Ensure in server.cfg

ensure ox_lib
ensure suty-announce

If you use sleepless_waypoints for 3D world markers, make sure it's also ensured (start order doesn't matter — suty-announce probes for it at runtime).

3. Set the framework

Open config.lua and confirm:

Config.Framework = 'qbx'    -- 'qbx' | 'qb' | 'esx'

4. Grant admin permission

The /evento command requires admin ACE:

add_principal identifier.license:YOUR_LICENSE group.admin

The script accepts both admin and group.admin ACE forms.

5. Configure your jobs

Open config.lua and review Config.AllowedJobs. Each job in this table can use /anuncio. Pre-configured with police, ambulance, barber, pizzeria, tokyo, kushbites, mechanic, bbq, sexywaffle, coffeclub, carwash, abogada, gelato, bowling, cannabis, etc. — add your own following the same pattern.

6. (Optional) Discord webhook

In config.lua:

Config.DiscordLogs = {
    enabled = true,
    webhook = 'https://discord.com/api/webhooks/...',
    botName = 'HoodLife Announce',
    botLogo = 'https://your-cdn.com/logo.png',
}

Logs include sender identity even for anonymous /evento broadcasts (audit trail).

7. Verify

• As a player with one of the AllowedJobs, run /anuncio — the input dialog opens
• As an admin, run /evento — the emergency-broadcast dialog opens