gitwtfhub

wtf is cat-simulator-endless-city?

shifulegend/cat-simulator-endless-city — explained in plain English

Analysis updated 2026-05-18

0HTMLAudience · vibe coderComplexity · 3/5LicenseSetup · easy

TL;DR

A browser based 3D cat simulator where you roam an infinitely generated city, chasing pigeons and exploring streets that regenerate seamlessly using seeded procedural generation.

Mindmap

mindmap
  root((cat simulator))
    What it does
      Endless procedural city
      Stray cat exploration
      Chase pigeons
      Procedural audio
    Tech stack
      Three.js
      Rapier
      Vite
      Supabase
    Use cases
      Browser gameplay
      Community contributions
      Procedural generation demo
    Controls
      Keyboard and mouse
      Touch joysticks

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Play an endless, procedurally generated cat city simulator directly in the browser.

REASON 2

Fork the project to prototype new features such as collision detection, weather, or minigames.

REASON 3

Study the code as an example of seeded procedural generation and Three.js scene building.

What's in the stack?

JavaScriptThree.jsRapierGSAPViteSupabaseWebGL

How it stacks up

shifulegend/cat-simulator-endless-city100/rutgers-pbl-dining-2015a15n/a15n_old
Stars0
LanguageHTMLHTMLHTML
Last pushed2015-12-012016-06-18
MaintenanceDormantDormant
Setup difficultyeasyeasyeasy
Complexity3/51/51/5
Audiencevibe codergeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Local development needs Node.js and npm to run the Vite dev server.

MIT license, free to use, modify, and distribute including for commercial purposes.

Wtf does this do

Cat Simulator Endless City is a browser game built with Three.js that lets you play as a stray cat exploring a city that never ends. As you move in any direction, the game generates new streets, plazas, and buildings on the fly, so there are no borders or loading screens. Revisiting the same spot always reproduces the same layout, because each block is generated from a seeded formula tied to its map coordinates rather than random chance. The cat itself uses inverse kinematics for its legs and a jointed tail, giving it a more natural walk than a simple boxy model would. Buildings are dressed with canvas-generated brick, window, asphalt, and grass textures and rendered with physically based materials for a more realistic look. Pigeons wander the streets and scatter when the cat gets close, adding a small chase mechanic with its own counter and sound effect. All the audio, including a purr, wind, traffic honks, and a meow, is synthesized in the browser using the Web Audio API rather than loaded from external sound files. You can control the cat with WASD or arrow keys plus a mouse drag to look around on desktop, or with two on-screen virtual joysticks on a touch device, one for movement and one for the camera. The project is planned to use Three.js for rendering, Rapier for physics and collisions, GSAP for animation tweening, and Vite for local development and builds, though it does not have to stay a single HTML file. It can pull in Supabase for leaderboards and save data using the public anon key with database level permission rules. Hosting is meant to be static, served through GitHub Pages. The README notes the game currently has no collision detection, so the cat can walk through buildings and other objects, and cars only loop inside their own spawn area without reacting to the player or traffic lights. The project explicitly invites outside contributors to prototype new ideas, even rough ones, through forks and pull requests.

Yoink these prompts

Prompt 1
Add AABB collision detection so the cat cannot walk through buildings, lamps, or benches in this Three.js city.
Prompt 2
How do I extend the seeded procedural generation here to add a new type of city prop, like street lamps?
Prompt 3
Write a Playwright test that verifies the touch joystick controls move the cat correctly.
Prompt 4
Add a new interactive animal, like a rival cat, that reacts to the player using the existing pigeon flee logic as a reference.

Frequently asked questions

wtf is cat-simulator-endless-city?

A browser based 3D cat simulator where you roam an infinitely generated city, chasing pigeons and exploring streets that regenerate seamlessly using seeded procedural generation.

What language is cat-simulator-endless-city written in?

Mainly HTML. The stack also includes JavaScript, Three.js, Rapier.

What license does cat-simulator-endless-city use?

MIT license, free to use, modify, and distribute including for commercial purposes.

How hard is cat-simulator-endless-city to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is cat-simulator-endless-city for?

Mainly vibe coder.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.