Skip to main content
sh-golf turns the existing GTA V golf course into a fully playable minigame for your FiveM players. When a player runs the golf command, an in-game swing meter appears — they time and hold their input to set the force of the shot, then watch the ball travel. By default the minigame is restricted to the golf course PolyZone, but you can open it up to the whole map, lock it behind an ACE permission node, or both — all from config.lua without touching any encrypted code.

​
Dependencies

​
Commands

​
Configuration

All options are set in config.lua. The file is straightforward — every value is a single line with no nested tables.
config.lua
Set Config.GolfAnywhere = true to let players bring clubs anywhere on the map — great for custom golf course MLOs that aren’t in the default PolyZone boundary.

​
ACE Permission Setup

If you want to restrict golfing to certain player groups (for example, VIP members), enable the permission gate and add the appropriate ACE entries to your server.cfg.
1

Enable permission restriction

In config.lua, set Config.PermRestrict = true and choose a permission node name via Config.PermName.
2

Grant the ACE to a group

Add the allow rule in server.cfg, replacing vip with the group you want to grant access:
server.cfg
3

Assign players to the group

Add players to the group using their licence identifier:
server.cfg
Players without the ACE permission receive a notification when they attempt to use /golf and the command does nothing. No errors are thrown server-side.

​
Customising the Golf Zone

The PolyZone boundary that defines the allowed golf area is stored in locations.lua. This file is escrow-ignored, so you can edit it freely without breaking the resource’s encrypted code. Open locations.lua and replace the existing vector2 coordinate list with one that matches your custom golf course boundary. Each coordinate is a corner point of the polygon that outlines the playable area.
locations.lua
Do not rename the resource folder. sh-golf validates its own resource name at startup and will immediately stop itself if the name does not match sh-golf. Keep the folder name exactly as it was when you downloaded it.