Requirements#
| Server | FiveM server on the cerulean manifest, with screenshot-basic, yarn and ox_lib. |
| Storage | A Cloudflare R2 bucket with a public URL (a custom domain is best). Photos live only there; nothing is stored on the server or sent to players with the resource. |
| Framework | Works standalone. With qbx_core running, photographers keep their hunger and thirst while in the studio. |
| Optional | glitch-photos (cutscene previews), glitch-admin (cutscene browser, car menu studio), glitch-appearance or illenium-appearance (puts your own look back when you leave the studio). Each is only used when it is started. |
Installation steps#
Drop
glitch-shotMakerinto your resources andensureit afterscreenshot-basic,yarnandox_lib. Theyarnresource installs the Node packages on first start.Give it your R2 bucket. Convars in
server.cfgare the safest place, since they keep the keys out of the resource folder:set r2_account_id "" set r2_access_key_id "" set r2_secret_access_key "" set r2_bucket "" set r2_public_url "https://cdn.example.com" # optional, for cache purges on retakes: r2_purge_zone_id, r2_purge_tokenOr copy
server/r2.json.exampletoserver/r2.jsonand fill it in. Never listserver/in the manifest'sfiles.Set
Customize.CdnUrlinCustomize.luato the same public URL.Grant the commands to staff:
add_ace group.admin command.shotmaker allow add_ace group.admin command.wardrobe allow add_ace group.admin command.shotmods allowCustomize.AceRestrictedis on by default, and the server refuses photos from anyone withoutcommand.shotmaker.Check
Customize.RoutingBucket. Each photographer gets their own studio in bucketRoutingBucket + their server id, so pick a base no other resource uses.
Run shotmaker_r2status in the server console to check that uploads work and load back from the CDN.