Dynamic Billboard Advertising

The script ships as two resources. Keep their folder names exactly rs_ad_agency and rs_ad_agency_assets. Their main files are organized as follows:

• Directoryrs_ad_agency The script

  • client Client-side rendering, kiosks, reps, editor, city map, and admin interface logic
  • Directorydata Runtime data

    • ads Ad media saved by the server
  • Directoryserver Rentals, payments, analytics, kiosks, reps, reservations, and the admin back end

    • bridge.lua Open framework, permission, and payment adapter
  • Directoryshared Shared modules

    • config.lua Main editable configuration
  • web In-game interfaces: agency manager, ad editor, kiosk screen, admin panel, and 3D map
  • fxmanifest.lua Resource manifest and dependency declarations
  • README.md Quick setup notes
• Directoryrs_ad_agency_assets Streamed assets

  • Directorystream Billboard faces, baked house ad textures, and the kiosk prop

    • rs_ad_agency_kiosk.ydr Agency kiosk prop
    • rs_adverts_house_ads.ytd Baked house ad textures
  • metadata Billboard catalog data
  • decals.dat Adds the agency’s render slots
  • gta5.meta Points the level at the agency’s decals.dat
  • fxmanifest.lua Resource manifest
  • README.md Asset pack notes

Editable Files

Path	Status	Purpose
shared/config.lua	✅ Open	Access points, kiosks, reps, rental terms, slides, pricing, house ads, rendering, and permissions
server/bridge.lua	✅ Open	Admin checks, player jobs and identifiers, and charging or refunding rent
web/	Accessible in the package	Interfaces and styles; preserve compatibility when modifying

Protected Core

The release uses Cfx.re Asset Escrow. Its fxmanifest.lua explicitly leaves these files editable:

• shared/config.lua
• server/bridge.lua

The gameplay Lua in client/, server/, and shared/ is otherwise protected. Supported customizations should use config.lua, the in-game admin panel, and bridge.lua instead of editing internal scripts.

Note

Most servers never need to open config.lua: the admin panel’s Settings tab changes the same values in game. Values changed there are saved in the database and take priority over the file.

Important Paths

Path	Used For
shared/config.lua	Main settings and their defaults
server/bridge.lua	Framework admin groups, player jobs, and rent payment accounts
data/ads/	Ad media stored by the server for every rented board
rs_ad_agency_assets/stream/	Billboard faces, the kiosk prop, and baked house ads
rs_ad_agency_assets/gta5.meta	The level meta replacement that adds the render slots

Caution

Upload the data/ads/ folder together with its README.txt. Many FTP clients skip empty folders, and the script needs this folder to store ad media.

Database Storage

The resource creates and manages its own SQL tables through oxmysql:

Table	Stores
rs_ad_agency_placements	Billboards, their prices, whether they can be rented, and the ad currently on each
rs_ad_agency_contracts	Rentals, their terms, slides, and payments
rs_ad_agency_views	Board views used for stats and traffic pricing
rs_ad_agency_reservations	Boards kept for players or jobs, and dedicated boards
rs_ad_agency_kiosks	Kiosks placed in game
rs_ad_agency_agents	Agency reps placed in game
rs_ad_agency_denied	Players stopped from renting
rs_ad_agency_settings	Settings changed in the admin panel
rs_ad_agency_receiver_bindings, rs_ad_agency_receiver_aliases	How the billboard catalog maps to boards in the world

Caution

Do not delete these tables while upgrading. Back them up together with data/ads/, as rentals reference both their database records and the stored ad media. No manual SQL import is needed for a new installation.