GCMod

Quick Actions

Quick action behavior and constraints for gcm-reports.


Quick actions are handled in server callback gcm_reports:admin:quickAction.

Supported actions

  • bring
  • goto
  • bringback
  • back
  • teleport
  • inventory
  • giveitems
  • revive
  • ropa
  • bucket
  • screenshot (quickAction reports success path; actual capture/upload is handled by modal callback)
  • espectar

Permission checks

Most actions require member:hasPermission('<perm>') (unless staff has full access):

  • teleport
  • inventory
  • giveitems
  • revive
  • ropa
  • bucket
  • spectate
  • screenshot

Side effects

  • Most quick actions append a staff message to report chat.
  • SavedCoords is used for bringback and back restore flows.
  • bucket updates routing bucket with SetPlayerRoutingBucket.
  • espectar triggers txcl:spectate:start on staff client.
  • inventory, revive, and ropa now return backend failure when the detected integration is unsupported instead of always reporting success.

Backend support notes

Inventory quick action

  • Native success path:
    • ox_inventory
  • Custom adapter success path:
    • qb-inventory
    • ps-inventory
    • origen_inventory
    • core_inventory
    • tgiann-inventory
    • jpr-inventory
  • Detected but not currently openable through gcm_reports:
    • qs-inventory
    • codem-inventory

Clothing quick action

  • Supported:
    • esx_skin
    • qb-clothing
    • illenium-appearance
    • fivem-appearance
    • rcore_clothing
    • origen_clothing

Revive quick action

  • Supported:
    • qb-ambulancejob
    • qbx_medical
    • wasabi_ambulance
    • esx_ambulancejob
  • Fallback:
    • ESX uses esx_ambulancejob:revive
    • QBCore/QBX uses hospital:client:Revive

Screenshot flow (modal)

  1. Staff calls gcm_reports:admin:takeScreenshotForModal.
  2. Server validates screenshot permission + webhook.
  3. Server requests capture from target client (gcm_reports:client:takeScreenshot).
  4. Client uploads with screenshot-basic and returns image URL.