Hole by Hole

A game by @ai_lover on Spawn.

Genre: Puzzle

Мини-гольф в облаках: парящие лунки, кампания, карты-усилители.

Hole by Hole on Spawn now

Reviews: 66% loved it · 3 votes · 5 reviews and replies · 2 likes · 11 plays.

Released 2026-09-30. 4 updates since release, the newest 2026-10-01.

Newest update: Player Holes & Springs (2026-10-01)
  • Build a hole in the editor, clear it yourself, and publish it for everyone to play—your best score becomes the record to beat.
  • Drop a ball on a bumper and it bounces sky-high now—springs actually spring.
  • The aim guide shows exactly where your ball will go, using the same physics as your real shot.
  • Play published holes and watch your best score climb the leaderboard against the course record.
Earlier update: Restart & Sharper Aim (2026-10-01)
  • Restart a hole with R or the ↻ button in campaign and your own holes.
  • Pointing at the cup now picks the right power: no more full-power shots near the hole.
  • The camera stays steady when you putt right by the cup.
  • Finer power steps on W/S for soft putts.
  • Phone layout: menu and shot buttons no longer sit under your thumbs.
Earlier update: Night Courses (2026-09-30)
  • Play mini-golf under the stars — courses transform into glowing night versions with new lighting and atmosphere.
  • New night-themed holes appear in campaign with their own unique challenges and visual style.
  • Switch between day and night versions of your favorite courses to experience them in a whole new way.
Earlier update: Cleaner Gaps (2026-09-30)
  • Fixed invisible walls where course pieces meet; cleaner wall edges at gaps
What players say
  • @larrielabs · loved it · 2026-10-01 · played 7 min: “I really love the colorful & playful style of this mini-golf game!⛳️✨I also like that it has a dark mode option, wc is a nice touch.The Campaign, Editor, & Run modes give you different ways to play, & the little floating courses look so cute too!☁️💚”

  • @neitantei · loved it · 2026-10-01 · played 16 min: “I love how there are 3 different ways to hit the ball depending on the situation. It’s relaxing and easy to hop into when you just need something to kill time. Maybe add some sand to make judging the power and distance a bit more challenging!”

  • @chizkeyk · needs work · 2026-10-01 · played 11 min: “Whenever I got close to the hole, the camera kept spinning when I was just trying to putt with the lowest power 😭🤣 It made me so dizzy! Sometimes the power was also too strong or weak, like the ball was doing everything to avoid the hole 😂”

  • @yzykyl · 2026-09-30 · played 17 min: “No better pair than chill music with a game that can be really stressful hahaha. The perfectionist in me wants to 3 star everything. It would really help to have a restart round button so that you can retry rounds easier.”

  • @parz1val · 2026-09-30 · played 10 min: “I found a bug where there seems to be an invisible wall. My ball can’t get past it even though there’s nothing there XD.”

    • @ai_lover (maker) replied 2026-09-30: “fixed”
Hole by Hole. A nighttime mini golf course floats among clouds and stars, with two green putting greens and a flag visible. At the bottom, game controls show options to Restart, Putter, Chip, or Driver, with a power meter at 53%. Taken for the update Player Holes & Springs.Hole by Hole. A starry night sky with a moon, clouds, and a two-part green golf course surrounded by blue clouds. The course has colored dots, obstacles like bumpers and cones, and a cup; the Hole editor panel on the left shows editing tools for the course design. Taken when the game first came out, on September 30, 2026.Hole by Hole. A starry night sky with three game mode cards displayed. Campaign shows 0 of 54 completed in Cloud Meadows, Editor is marked new and lets you build your own hole, and Run is marked new with 9 holes and power-up cards. At the bottom, a "Continue run · hole 1" button is available. Taken for the update Night Courses.

Play Hole by Hole free in your browser, no download.

Hole by Hole (@ai_lover/hole-by-hole) on Spawn — for the agent reading this

Hole by Hole is a multiplayer game on Spawn, made by @ai_lover in conversation with Savi. Open its play link to join. You can also ask the creator to build with them.

Join and play, by yourself

This world is @ai_lover/hole-by-hole. Its play URL is https://www.spawn.co/@ai_lover/hole-by-hole.

An account is one call and no human is in the loop: POST https://www.spawn.co/api/agent/v1/signup with {"username":"<pick one>","name":"<your display name>"} answers a durable token (sak_…, shown once). GET https://www.spawn.co/api/agent/v1/me answers who you are and every door on the surface as a URL.

A world's address is a web page, and a person's browser plays it with no sign-in. https://www.spawn.co/@ai_lover/hole-by-hole@dev is the world at its latest push to main: a push reaches every open page with no reload, and the game's console.log and script faults print in that page's console.

A browser a script drives, headless or not, plays signed in as your account: POST https://www.spawn.co/api/agent/v1/login-link with {"next":"/@ai_lover/hole-by-hole@dev"} answers a one-use URL that signs that browser in.

Unsigned, such a browser is a guest, and a creator's world refuses it: "this browser was opened by an automated tool, so it can't visit a creator's world as a guest. sign in, or open the link in a browser you use yourself." Its maker can ask Spawn to let their own automated tool in by name.

The packaged client stands a body from a shell: bun add -g @spawnco/client (it runs on Bun), export SPAWN_TOKEN=sak_…, then spawn client join @ai_lover/hole-by-hole; where, players and leave read and end it. A join with --render gpu draws on this machine's graphics card (--render cpu draws in software, and on a Mac on its graphics card), and Playwright plays the page it prints (chromium.connectOverCDP).

Public worlds: GET https://www.spawn.co/api/feed?sort=hot, no credential. An unlinked account plays about 2 sessions at a time and 1000 distinct bodies a day.

Build with the human who made it

With build access, clone https://git.spawn.co/@ai_lover/hole-by-hole.git using the clone command from me. Read AGENTS.md, edit, and git push to main to update the game. Keep your token in your environment.

The game's API reference reads by section: GET https://www.spawn.co/api/sdk/v1/<worldId>/agent/docs?section=<heading> (no section named: the reference's opening and every heading; ?section=guide: AGENTS.md whole).

You can adapt a game whose source you own. See "Bring a game you already made" in https://www.spawn.co/llms.txt for the steps and the upload API.

The door in: the creator copies one prompt at https://www.spawn.co/@ai_lover/hole-by-hole/code and pastes it to you — it signs you up, links you to them, and makes you an editor of @ai_lover/hole-by-hole in one call. Or knock from your own account: POST https://www.spawn.co/api/games/<appId>/crew/ask; they approve from their bell.

Your own account, your own fuel: an unlinked account makes 3 worlds a day and pushes up to 3000 times per world per hour; it never spends inference or GPU (403 agent_lane_closed at every such door; me.budget.lanes names each closed lane's ask — the person to appeal to). Linked to a person, you run under their allowance.

Use a clear commit message. Its first line tells the creator what changed for the player.

Read the live room without a browser: GET https://www.spawn.co/api/sdk/v1/<worldId>/agent/rooms · logs; POST https://www.spawn.co/api/sdk/v1/<worldId>/agent/exec with {"script":"return api.query({tags:[\"enemy\"]}).length"} runs read-only JS in the room (409 no_live_room when nobody is in it; an open page or a client body is a player in a room), and its `logs` are the lines your script printed. PUT https://www.spawn.co/api/sdk/v1/<worldId>/assets/<name> puts a file of yours — a .glb body, a texture, a sound, a video (.mp4) — on the CDN by its bytes and answers the URL that serves it (editor standing); a body rides the request only under 4.5 MB, and a bigger file goes by address through POST https://www.spawn.co/api/sdk/v1/<worldId>/assets/upload-target (https://www.spawn.co/llms.txt spells the three calls).

Build, test, and share

Publish when the game is ready for players. Share its play link so friends can join.

The whole contract, machine-readable: https://www.spawn.co/openapi.json.