RoadMinigolf - FiveM Minigolf Creator

Images:

Videos:

Summary:

FiveM Minigolf Creator

RoadMinigolf

Build minigolf courses anywhere on the map with a full in-game editor and a custom track kit, then play them solo or with friends — with real ball physics, par scoring and leaderboards.

21

Track Pieces
16

Colour Themes
6

Prebuilt Holes
13

Languages

Why RoadMinigolf

Build it. Play it. Beat the record.

A complete minigolf system for your server: build the courses, run the games and keep the records — no database and no extra resources required.

Custom track kit

21 modular streamed pieces — lanes, curves, ramps, hills, waves, an island split, a windmill, a tunnel and a spiral loop — in 16 colour themes. Pieces lock onto open lane ends by themselves.
In-game course editor

Courses with up to 36 holes anywhere on the map: freecam, mouse cursor, orbit and top-down cameras, a move gizmo, undo and redo, and a test mode for every hole.
Real ball physics

Slopes, ramps, walls, drops, water and out-of-bounds with penalty strokes. Windmill sails turn in sync for every player, and the loop only works with enough speed.
Play together

Solo rounds or lobbies in two modes: everyone at once, or classic take turns. Invites, private lobbies, live standings and one-click rematches.
Leaderboards and records

All-time, monthly and weekly leaderboards for every course, a record for every hole, personal bests and player statistics.
Demo map included

SkyGarden, a streamed roof garden on a city mall, with a nine-hole course built from the kit (par 31). Ready on the first start — edit it, move it or remove it.

Course Editor

Build a hole in minutes

Four ways to build, from a single click to full freedom. Every change can be undone.

Six prebuilt holes

Windmill, ramp, loop, tunnel, zigzag and hills. Pick one, place it with the crosshair, done — tee, cup and par included.
Quick build

Set a tee and add piece after piece on the open lane end. A cup finishes the hole with a suggested par and play area, ready to test.
Draw a path

Click the lane on the ground and the hole is built from kit pieces — straights, 45° and 90° curves, and ramps for height steps.
Blueprint

A 2D hole builder in the panel: drag pieces onto a grid, see heights and the course check, then place the hole in the world. Save your own blueprints for later.
Any prop you like

A prop catalog with base game and stunt race props plus any model name, with snapping, grid, surface alignment and multi-select.
Safe workflow

Copy and duplicate holes and courses, a course check before saving, publish when ready. Drafts survive crashes, with course history, a trash and JSON export and import.

Gameplay

Feels like a real round

Simple to pick up, with enough depth to chase the hole record.

Aim and power

Aim camera with a hole overview, fine aim and zoom. Two power controls per player: Timing (release at the right moment) or Precision (pull the mouse back).
Aim guide

Simulates the real roll while you charge: slopes, ramps and walls bend the line, and it ends in the cup when the putt drops. Can be turned off per course or lobby.
Real putting animation

Stance and swing come from the game’s own golf animations. The player stands beside the ball and turns around walls, posts and steps.
Hole intro and shot feedback

A flyover from cup to tee with a hole card, lip-outs and near misses, ball trails in the player colour and a hole-in-one celebration.
Practice and course finder

Practice any hole alone, without score or money. The course finder lists every open course by distance, with the record, your best and a waypoint.
Watch the others

Spectate after finishing. Players near a running game see the balls and putters, and players near a course hear about new lobbies.

For Server Owners

Made for live servers

Fair scoring, an optional economy and full control for your staff.

Server-side scoring

Shots are counted on the server and every round is scored against the course as it was at the start. Anti-cheat flags keep suspicious rounds off the leaderboard and never punish on their own.
Optional economy

Entry fees and rewards per course, paid into a society account or a prize pot for the winner. Cancelled games are refunded, and reward cooldowns stop farming.
Admin console

Live sessions, leaderboard moderation, publishing, course history and a trash for deleted courses — all inside the editor.
Discord audit logs

Admin actions, money, anti-cheat flags and records, each with the player’s identifier. Webhook URLs stay on the server.
No database needed

Courses, scores and stats are saved as JSON files, written to two alternating copies and read back before they are trusted. A damaged file never overwrites the last good copy.
Easy to configure and integrate

A short config with defaults in code, so updates never break it. Exports, events and state bags for HUD, phone and inventory scripts; config, locales and hook files stay open.

Compatibility

Drop it in and play

Frameworks ESX, QBCore, Qbox or Standalone — detected automatically
Interaction Marker, ox_target or qb-target
Notifications Built in, or your notification script, detected automatically
Admins ACE permission, framework groups, fixed identifiers or your own check
Languages English, German, French, Spanish, Italian, Dutch, Polish, Portuguese, Turkish, Czech, Russian, Greek and Chinese
Requirements A server artifact with Lua 5.4. OneSync recommended for start checks, invites of nearby players and the bystander view.

Characteristics:

  • Custom track kit: Build courses with 21 modular streamed track pieces, including lanes, curves, ramps, hills, waves, an island split, windmill, tunnel and spiral loop, available in 16 colour themes.
  • In-game course editor: Create courses with up to 36 holes anywhere on the map using freecam, mouse cursor, orbit and top-down cameras, a move gizmo, undo and redo, and per-hole test mode.
  • Multiple building workflows: Create holes with six prebuilt layouts, quick build, drawn paths, or a 2D blueprint builder. Use the prop catalog with snapping, grid, surface alignment and multi-select.
  • Minigolf gameplay: Play solo rounds or lobbies with simultaneous play or classic turns, including invites, private lobbies, live standings and rematches.
  • Ball physics and scoring: Features slopes, ramps, walls, drops, water, out-of-bounds penalties, par scoring and server-side shot counting.
  • Leaderboards and records: Includes all-time, monthly and weekly leaderboards per course, hole records, personal bests and player statistics.
  • Gameplay tools: Includes aim and power controls, an optional aim guide, putting animations, hole flyovers, shot feedback, practice mode, course finder and spectating.
  • Server owner controls: Provides live session controls, leaderboard moderation, course publishing, history, deleted-course trash, optional economy settings and Discord audit logs.
  • JSON-based storage: Courses, scores and statistics are saved as JSON files using two alternating copies, with validation before saved data is trusted.
  • Framework and interaction support: Supports ESX, QBCore, Qbox and Standalone, with Marker, ox_target or qb-target interaction options.
  • Demo course included: Includes SkyGarden, a streamed roof-garden demo map with a nine-hole course built from the track kit.

Technical:

  • FiveM resource name: roadminigolf
  • Frameworks: ESX (FiveM), QBCore (FiveM), vRP (FiveM), Standalone, Qbox (FiveM)
  • Supported languages: cs,da,de,el,en,es,fr,it,pl,pt,ru,tr,zh

Interested?

Click to get this release

Escrow Protection:

This resource uses the Cfx.re Asset Escrow system.

Code is accessible No, only config files
Subscription-based No
Lines (approximately) 30000+
Requirements N/A
Support yes
2 Likes

Great work. You created something unique :fire:

Just be prepared for all the leech devs to take the idea/ clone your script now :roll_eyes:

1 Like

This is awesome!!

– Dan

1 Like

any chance for the course pieces to be items?
this would allow for players to setup their own courses if they own the items. Would create for some cool player own minigolf businesses.

1 Like

I will add support for this.

2 Likes

Amazing! if you dont mind - @ me once that’s ready and we will pick this up!

Rcore had a minigolf creator which was neat, but without weird ace permissions and such - players couldnt setup their own courses. Ive always liked the idea of players being able to go to like our activity stores, buying the parts needed to setup a course, and then setting up a course. That way they can setup private ones at their home, or buy some open land property and setup courses there.

We’ll keep the code flexible so you can configure exactly where players are allowed to build their own courses.

Features I expect to have ready by tomorrow:

Core Features – Shop, Items, Building System, Zones & Multiplayer
Players can purchase building parts from the shop, store them in their inventory, and place them within designated building zones. They can save their custom courses, set them to private or public, and allow other players to play them.

Blueprint System
Players can save their courses as blueprints, share them with others, or even sell them. However, anyone using a blueprint will still need to own the required building parts to construct the course.

Collaborative Building
Players can invite others to help build their courses. Collaborators can contribute their own building parts and work together to create a course.

Thanks for the idea :slight_smile:

2 Likes

Road Minigolf 1.5.0 – Released

:rocket: New Features

  • Player building – players build their own minigolf courses with the in-game editor (optional, Config.Build.enabled). /mgbuild opens the build menu.
  • Piece shop – buy the 21 track pieces with /mgshop, from the build menu or from a shop NPC at the counters you place on the map (Config.Build.shops, with blip). The shop shows every piece with its picture, grouped into start & finish, lanes and obstacles.
  • Pieces are inventory items – item definitions for ox_inventory, qb-core and ESX plus 21 item images ship in install/items/. No inventory? Pieces live in a server-side build box (Config.Build.inventory = 'box').
  • Build mode – the real editor with snapping, quick build, path drawing, prebuilt holes, the blueprint and test mode, limited to the pieces a player owns. No teleports, no admin tools, no god mode.
  • Building zones – allow building anywhere or only inside zones (Config.Build.zones) in PolyZone’s poly, box and circle formats. PolyZone itself is not needed. Zone borders show while building.
  • Course plans – save a course as a plan, keep it private, share it for free or sell it. Buyers place it where they stand and build it with their own pieces; sellers get paid even while offline.
  • Co-building – add players next to you as builders (maxBuilders). One builder edits at a time, everyone pays for the pieces they add.
  • Public or private – player courses can go public, optionally only after an admin approves them (requireApproval).
  • Admins see and moderate player courses in the editor; removed pieces go back to the owner.

2 Likes

Bought it! Thank you!

We are working on this past month, so regarding RTX Dev, we are not copying… just to mention this. :smiley: :smiley:

I love RTX,

Nobody copies—let’s just work together to create good scripts for the community.