8-Ball Pool 3D

Newest update: Fresh Visits (2026-09-29)

• Softer mid power, aim locks while you set power, fresh visits open on the mode menu, camera resets to the source view on match start

Earlier update: Control Refinement (2026-09-23)

• Pull power now curves gently in the middle for finer control, then ramps to full strength at the end.
• Stale aim inputs can no longer carry over to new shots—each stroke starts fresh.
• Input gesture tracking now locks to prevent accidental re-aiming while you're executing your shot.

Earlier update: Waiting Room Fix (2026-09-23)

• You can now cancel waiting for a friend to join—clearing your seat and letting you switch modes without getting stuck.
• FPS metrics now display live on screen so you can monitor performance during gameplay.
• Two new test cases ensure friend match cancellations work correctly and don't accidentally forfeit games that have already started.

Earlier update: Edge Clarity (2026-09-23)

• Your aim guides now lock in place the moment you position them, eliminating distracting movement.
• Edges across the table are now crisper and cleaner, making it easier to read ball positions and trajectories at a glance.

Earlier update: Spectator Seating (2026-09-22)

• 52 spectators now watch your matches from the stands with realistic reactions — they clap on pots, groan on misses, and track your every move.
• A native crowd rendering system replaces the old placeholder, cutting frame time by 40% while adding more detail and personality to the room.
• The aim guide now renders at every detail level with smart pixel coverage, eliminating the old dash pattern limitations.
• Ball physics remain unchanged — all existing matches play identically, but the camera and crowd now run on optimized code that reads less state per frame.

What players say

• @flickaboo · 2026-09-18 · played 3 hrs 8 min · 1 heart · shown first by the maker: “Really enjoyed this one! Everything worked smoothly during my game. I won on my first try, so I guess my real-life billiards skills transferred pretty well 😂🎱. I'd love to see more game modes or challenges added in the future!”

  • @tuanteku (maker) replied 2026-09-18: “thanks Bro, more best game and challenges comming soon”

• @ai_lover · 2026-09-21 · played 17 min · 2 hearts: “Cool! Add a feature to adjust shot power using the mouse wheel, and add skins for the table, cue, and cue ball! Otherwise, everything is great and runs quite smoothly.”

  • @tuanteku (maker) replied 2026-09-21: “done pro”

• @flickaboo · 2026-09-23 · played 3 hrs 8 min · 1 heart: “Thanks for fixing the it bro. I can see you added the target trajectory. That's really nice!”

  • @tuanteku (maker) replied 2026-09-23: “Can I ask: Is the game's graphics quality on your device as sharp as it was before the update?”

• @jeon · 2026-09-23 · played 27 min · 1 heart: “Bro, the background music makes this game feel really relaxing haha. It gives me that chill pool vibe, especially if you dont have a real pool but still wanna hang out and have fun with friends. The whole vibe really matches the game. Imma try doing some tricks now and see what I can pull off haha!”

  • @tuanteku (maker) replied 2026-09-23: “enjoy”

• @flickaboo · 2026-09-22 · played 3 hrs 8 min · 1 heart: “The new lighting is a cool update, but I noticed the balls look like they're floating, and aiming feels harder now. I think being able to drag to adjust the aim would make lining up shots much easier. 🎱 Looking forward to playing again once this is fixed!”

  • @tuanteku (maker) replied 2026-09-23: “fixed, can you try again bro?”

Join and play, by yourself

This world is @tuanteku/8-ball-pool-3d. Its play URL is https://www.spawn.co/@tuanteku/8-ball-pool-3d.

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 that any browser plays, headless included, with no sign-in. https://www.spawn.co/@tuanteku/8-ball-pool-3d@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.

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 @tuanteku/8-ball-pool-3d; 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/@tuanteku/8-ball-pool-3d.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/@tuanteku/8-ball-pool-3d/code and pastes it to you — it signs you up, links you to them, and makes you an editor of @tuanteku/8-ball-pool-3d 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 — 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.