Installation Instructions for gs_powerups

Follow these steps to properly install and configure your new resource:

Download the Resource
- Go to portal.cfx.re
- Navigate to Assets > Granted Assets > gs_powerups
- Download the resource
Extract the Files
- Open the downloaded .zip file
- Inside, you'll find a folder named gs_powerups
- Move the entire gs_powerups folder into your desired server resources folder (e.g., /resources/[scripts])
Add to Server Configuration
- Open your server.cfg
- Add the following line:
```
ensure gs_powerups
```
Restart the Server
- Restart your FiveM server (Important!)
Configure the Script (Optional)
- Navigate to gs_powerups/config.lua
- Edit the configuration options to fit your server's needs

Additional documentation

Available export (client-sided):

You can toggle a specific action using the export below. The index corresponds to the key in Config.Layout, so exports.gs_powerups:ToggleAction(2) toggles the flashlight for example.

exports.gs_powerups:ToggleAction(index)

Want to change the colors of the overlay?

You can easily tweak the colors of the UI at the top of gs_powerups/html/style.css under main-color and secondary-color.

Want to add/replace images/sound-effects in the overlay?

You can add images to gs_powerups/html/images (svg file extensions only).
You can add sound effects to gs_powerups/html/sounds.

How to hide the flashlight-prop under specific circumstances if I use presistant mode?

There is a function Functions.CanFlashlightPropBeActive() in gs_powerups/bridge/cl_bridge.lua, you can edit this function to despawn the flashlight prop under specific conditions.

Rappeling down a rope is not perfectly synced?

It is known that the rappeling is not perfectly synced. The build in rappel function within GTA5 is not synchronized between clients so there is not much that can be done to fix this. You can keep syncPositionOnStandStill enabled in config.lua, this updates the position of the player on the rope for other clients when the person on the rope is standing still.