Dynamic Billboard Advertising

Requirements

Dependency	Required	Purpose
oxmysql	✅ Yes	Stores boards, rentals, views, kiosks, reps, and settings
rs_ad_agency_assets	✅ Yes (included)	Billboard faces, house ads, the kiosk prop, and render slots
Qbox, QBCore, or ESX	For charging rent	Player money, jobs, and admin groups
OneSync	Recommended	Lets nearby players watch a kiosk session
ox_target or qb-target	Optional	Target interaction with kiosks and reps

Installation Steps

1. Install the Resources

Download both resources from your Cfx.re Keymaster and place them in your server’s resources directory.

resources/[retro]/rs_ad_agency/
resources/[retro]/rs_ad_agency_assets/

Keep the folder names exactly rs_ad_agency and rs_ad_agency_assets. Upload the rs_ad_agency/data/ads/ folder with its README.txt so your FTP client creates it.

2. Add the Resources to server.cfg

Start the asset pack and the script after the database, your framework, and the optional target resource.

# Qbox example
ensure oxmysql
ensure qbx_core
ensure ox_target
ensure rs_ad_agency_assets
ensure rs_ad_agency

For QBCore, start qb-core (and qb-target if used) first. For ESX, start es_extended first. rs_ad_agency_assets must always start before rs_ad_agency.

3. Set Admin Permissions

add_ace group.admin command.rsadagency allow

A player is an agency admin if any of these is true:

They have the ACE command.rsadagency.
They have the general command ACE, which most admin groups already have.
Qbox group god or admin, QBCore permission god or admin, or ESX group superadmin or admin.

The framework groups can be changed in AgencyConfig.Framework.

4. Restart and Let It Set Up

The resource creates its own SQL tables automatically on the first start. There is no .sql file to import. Your database account must be able to create tables.

On the first start with a new database, six starter kiosks are placed around the map:

Starter kiosk	Area
Ad Agency Kiosk	Rockford Hills
Ad Agency Kiosk	Maze Bank Arena
Ad Agency Kiosk	Tataviam (Route 15)
Ad Agency Kiosk	Harmony
Ad Agency Kiosk	Paleto Bay
Ad Agency Kiosk	Chumash

They are ordinary placed kiosks: admins can move or remove them in game, and removed ones never come back. To begin with no kiosks, empty AgencyConfig.Kiosk.StarterLocations before the first start.

5. Place More Kiosks and Reps

/rsad_kiosk place [label]
/rsad_npc place

Placing shows a preview: use the mouse wheel to rotate, then press Enter or left click to place. Kiosks and reps are saved in the database and restored after restarts. Both commands also take remove and list.

6. Verify

After starting the server, check the following:

The console shows no errors from rs_ad_agency or rs_ad_agency_assets.
Ad Agency Kiosk blips appear on the map.
Walking up to a kiosk and pressing E (or using your target) opens the agency manager on the kiosk screen.
Renting a board charges the configured account (bank by default).
A saved ad appears on the real billboard, including for a second player nearby.
/adagencyadmin opens the admin panel for staff.

General Installation Guide