The gap
Mini-golf holes are easy to draw and hard to make fair: a gate timing or a bumper angle can make par impossible, and testing every hole by hand after a physics change is slow.
Game templates
Puttlewick Game Template
The complete TypeScript and three.js source of Puttlewick, a cosy mini-golf game: 18 holes as ASCII maps and a daily hole. A search bot sinks every hole at or under par.
- TypeScript
- three.js
- Vite 8
- Web Audio
- Vitest and Playwright
- Coming soon
Coming soon
Not published on its store yet, so there is no buy or download link. PN Scripts does not take payment for it here.
What it solves
What it is
A finished, tested mini-golf game whose holes are text maps and whose pars a search bot proves with the real physics.
How you use it
Unzip, run npm ci and npm run dev, then edit src/game.config.ts; npm test checks the game again in seconds.
Source code of a real, playable game to reskin and learn from, with its proofs built into the tests.
Who it is for
Use it when
- Publishing your own mini-golf or physics-putt game on itch.io, web portals or your site.
- Learning deterministic ball physics and search-based level testing in TypeScript.
- Building a branded mini-golf course for a client or an event.
Built for
- Web and indie game developers who know some TypeScript.
- Studios and freelancers who make branded browser games.
What you get
One config file
Title, save key, ball physics (speed, friction, sand, cup, bounces), courses and holes as text maps, three themes with scenery, ball colours and sound.
Pars with a proof
A search bot plays every hole and 30 daily holes with the real physics on each npm test and sinks each one at or under par.
A finished game
Two nine-hole courses and a daily hole, windmills, bumpers, humps, gates, sand and ponds, drag-to-putt, a scorecard and saved bests.
Tests and a guide
35 unit tests and Playwright browser runs, a size budget, an upload zip for itch.io or any static host, and a guide to building holes and tuning the ball.
Gallery
This file could not be loaded.
This file could not be loaded.
This file could not be loaded.
1 of 3
Specs
- Availability
- Coming soon
- Vendor
- PN Scripts
- Type
- Template
- Platforms
- JavaScript
- Pricing
- One-time purchase Price to be announced.
- License
- PN Scripts Template Licence 1.0
- Deployment
- Download (ZIP of source code)
- Maturity
- v1.0.0
Compatibility
| Platform or runtime | Supported versions | Tested up to |
|---|---|---|
| Node.js | 22.12 or newer | Not stated |
Stack
- TypeScript
- three.js
- Vite 8
- Web Audio
- Vitest and Playwright
The Puttlewick template is coming soon
The template is finished and tested. It is not on sale yet; this page will say where to get it when it is.
Coming soon
Not published on its store yet, so there is no buy or download link. PN Scripts does not take payment for it here.
Questions
Make and sell any number of your own games from it, and build games for clients. You may not resell or share the source code itself (PN Scripts Template Licence 1.0).
Node.js 22.12 or newer and some TypeScript. Google Chrome runs the browser tests.
No ad or portal SDK, and English only. It is tested in desktop Chrome and Chrome's Pixel 7 emulation, not yet on iOS Safari, Firefox or a real phone.
The code was written with AI assistance and checked by PN Scripts with automated tests. All visuals and sounds are generated by code; there are no AI-generated image or audio files.
It is not on sale yet. When it is, this page will link to the store; PN Scripts does not take payment on this site.
