Usage

The main requirement is setting up a fivemanage account to allow the images to save to

You then need to get the fivemange api key and add it to your config file

In the config is an option to toggle /commands for easy use for your players

  • /freecam

    • enables the camera system for the player

  • /freecampics

    • shows the player all their saved pictures

  • /screenshot

    • allows for a quick sreenshot without showing the screenshot at the end

Fivemanage API Key

  • Create or login to a "team"

  • Click tokens on the left sidebar

  • Create a token

  • Copy it and place it in Config.General.fivemanageAPIKey

Discord Webhook (Optional)

  • Create a new channel in your discord and name is something like #freecam

  • Right click on it and select Edit Channel

  • Select Integrations

  • Select Webhooks

  • Create a new webhook and name it something like freecam

  • Click on that new webhook that pops up

  • Select Copy Webhook URL

  • Paste the link into Config.General.discordWebhookUrl


General Notes and info

  • When freecam is triggered they are shown several options to use as a photo tool or a custom gameplay camera (with effects) for role play

  • When taking a picture it will display the current and allow them to grab the URL to post in other places and an option to delete them

  • When deleting a picture it also removes it from the fivemanage storage

  • The picture urls are stored in client side data, if they clear their cache they will lose access to them

  • Fivemanage also has a free storage limit of around 20gb before you need to pay for their subscription

  • I've worked in as many exploit protections as possible so it can't be abused

  • It combines NUI and GTA native scaleforms to allow the script to run on any framework (with the help of jim_bridge)

  • It utilizes screenshot-basic to take screenshots, NUI's won't be visible but GTA scaleforms will be visible in their screenshots

Exports

startFreeCam

This is an export so you can trigger the camera from other scripts like a radial menu

exports["jim-freecam"]:startFreeCam()

getCamActive

This export returns true or false based on wether the cam is active or not, so you can use it to limit other script events from being triggered if needed

exports["jim-freecam"]:getCamActive()

Last updated