Small islands. Big shots.
This is an HTML5 3D mini golf game template with full source code, ready to host on your own website. Players drag back to set direction and power, read the slopes and bank off the walls across 30 holes on five miniature island courses. Daily challenges, stars, medals, hidden coins, cosmetic unlocks and two-to-four-player rounds on one device are already built in, and the interface comes in 14 languages.
30 holes on five island courses
Sunlit Ruins, Lantern Pier, Frost Peaks, Cloud Garden and Volcano Forge each bring six holes, their own look and one new idea. Finishing a course opens the next one. Every course has its own hole file, and a separate courses file sets the order and the unlock requirements.
More than a straight shot
Ramps, portals, bumpers and windmills turn every hole into a small puzzle. Drag away from the ball to set direction and power, then release. Rotate the camera with two fingers or a right-drag, pinch or scroll to zoom, and pause with the on-screen button or the P key. The ball is simulated by Rapier 3D running as WebAssembly and drawn with Three.js.
Chase every star
Each hole has three stars: finish it, make par or better and find the hidden coin. Bronze, silver and gold medals reward the best rounds. Full-course solo runs save a personal record per course, where fewer strokes is better, and restarting a hole voids that ranked run.
A new daily challenge
One hole and one twist each day, the same for everyone on that date: windy, icy green, heavy ball, bouncy walls, coin rush or birdie hunt. Three tries per day, and a win keeps the streak going. Daily challenges and same-device rounds keep their own local progress, and no score is uploaded.
Your ball. Your style.
Coins earned on the course unlock balls, trails and other cosmetics in the Locker. They are defined, with their prices, in a single economy file.
Two to four players, one device
Friends take turns on the same device, two to four at a time. The interface is available in 14 languages, from English, Portuguese and Spanish to Japanese, Korean and Simplified Chinese.
A smooth start for your project
Upload the contents of the game folder to your host, keeping the subfolders, and open its address: no npm, no build step, no PHP, no database. Three.js and Rapier are bundled with their licence files, so nothing is loaded from a CDN. The code is plain, formatted JavaScript.
Who this template is for
Portal and site owners who want a sports or family game in their catalogue, studios delivering a branded game to a client, and developers who want to learn how a 3D physics game is put together in readable code. One licence covers one end product, yours or one client's.
Customise it
The guide covers adding a hole: duplicate a definition, give it a unique ID, set par, tee and cup positions, add it to its course and add its name and tip to the language files. Cosmetics and prices sit in the economy file, physics tuning in a constants file, and colours and fonts in css/style.css. The two music tracks can be replaced with licensed files of your own.
Technical details at a glance
- Stack: Vanilla JavaScript, Three.js r186, Rapier 0.21 (WebAssembly), WebGL2 and ES modules
- Files: HTML, CSS, JavaScript and JSON
- Delivery: a ready-to-host game folder and a readable source folder, with libraries, fonts and two music tracks bundled
- Requirements: a modern browser with JavaScript, ES modules, WebAssembly and WebGL2, and any HTTP(S) host for static files
- Documentation: one illustrated guide in English and Portuguese
Not included in this edition
Online multiplayer and online rooms, online leaderboards and cloud accounts, advertising SDKs and accounts, native apps and hosting are not part of the package. Progress and records stay in the player's browser.
Licence and support in short
A perpetual, non-exclusive licence for one end product. Players can access it free of charge or through advertising monetisation. Six months of support are included, or 12 months with the extension; support covers installing and using the files and fixing reproducible defects. Customisation, hosting and SDK or portal integration are separate services, quoted first.
