Gamzky Scripts
Home Browse Scripts Free Scripts Documentation Server Name Generator Hash Resolver Discord
Login with FiveM
Basket
ESX • QBCore • Qbox compatible
Instant download
Updates included
Discord support
Secure checkout

Interactive Power-ups

Resource folder: gs_powerups

View product

Installation Instructions for Interactive Power-ups

Follow these steps to install and configure gs_powerups on your FiveM server.

  1. Download the Resource
    • Go to portal.cfx.re
    • Navigate to Assets > Granted Assets > gs_powerups
    • Download the resource
  2. 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])
  3. Add to Server Configuration
    • Open your server.cfg
    • Add the following line: 
      ensure gs_powerups
  4. Restart the Server
    • Restart your FiveM server (Important!)
  5. 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.

What key opens the powerups menu?

The default key is E, not G. It is set by Config.InteractionKey in config (control ID 38). Change it to any unused key if another script blocks E.

Why is there always a prop on my shoulder?

The shoulder flashlight prop stays visible when Config.Flashlight.prop.presistent is true. Set it to false so the prop only appears while the flashlight is active through the menu.

The menu opens and closes immediately

Common causes:

  • A job restriction in the client bridge closes the menu if the player lacks the required job.
  • Another script is blocking the interaction key (default E).
  • A startup error in the bridge file.

Try changing Config.InteractionKey to an unused key, test with other resources stopped, and check the F8 console on join for errors.

Everyone can open the menu but I want police only

The stock bridge does not restrict the whole menu by job. Edit Functions.CanInteract in the client bridge to check the player's job against your allowed list. Support can provide an updated bridge file with this logic if needed.

Can I restrict individual powerups to certain jobs?

Yes. Add requiredJob = { 'police' } (or multiple jobs) to each powerup entry in config.

The flashlight prop will not turn off

Check Config.Flashlight.prop.presistent and any requiredItem setting on the flashlight. When an item is required, the player needs it to toggle the flashlight on and off. Dropping the item while the persistent prop is enabled can leave the prop attached.

How do I hide the flashlight prop entirely?

Set Config.Flashlight.prop.enabled = false in config, or adjust the presistent setting under Config.Flashlight.

The script uses high resmon when idle

Baseline idle is around 0.02 ms. Overlay and job checks add a small amount. Lower Config.Flashlight.syncDistance (for example from 200 to 50) to save roughly 0.01 ms. Resmon also varies by PC hardware. If a custom job check runs every frame, throttle it to every 2 seconds instead.

Will powerups trigger my anticheat?

The script does not fire vehicles or spawn abusive entities. Allow its required props in your anticheat whitelist if needed.

What does the scan powerup target?

When Config.Scan.onlyTargetPlayers is true, only players are highlighted. When false, both players and NPC peds are highlighted. NPC-only scanning is not supported.

Can I open the overlay from another script or keybind?

You can call exports.gs_powerups:ToggleOverlay() from another resource to open or close the UI. Keymapping support is also available as a config option to avoid constant key-detection loops.

Does it work with core_inventory or other custom inventories?

Not by default. Inventory-related bridge functions are open source and can be adapted. Use Functions.DoesPlayerHaveItem and per-powerup requiredItem in config for item checks.

The menu only works after I restart the resource

This often points to a bridge startup error or a job-restriction file that was added after the first load. Check F8 for errors on join and confirm you are using the latest bridge version.