Codemon // docs

CODEMON is a Pokémon-inspired browser game built on top of the public Codemon archive. Five layers:

1. 1 Ingest — a scheduled job mirrors the public codemon feed into our database every ~10 minutes.
2. 2 Derive — a pure function (computeStats) turns each pet's public metadata into four 1-99 battle stats (PWR / SPD / DEF / STA) — the same way classic Pokémon stats roll up from base values.
3. 3 Account — signing in spins up an in-app Solana wallet, drops 5 free starter pets in your collection, and starts tracking points, wins and rank.
4. 4 Play — the main game is the /world overworld: a tribute to the classic top-down Pokémon route map. 8 chapters across a village, meadow, forest, river, beach, cave, mountain and champion arena — with NPCs, tall-grass wild encounters, and a boss fight at the end of every chapter.
5. 5 Collect — buy pets in the /shop, submit your own via /submit, climb the lifetime /leaderboard, and vote on what ships next on /suggestions.

Every pet on CODEMON originates from codemon, the public community archive of pets hatched inside the Codex desktop app (shipped by OpenAI in May 2026). We do not generate new pets — we mirror what's already public.

Codemon ship as a single PNG spritesheet. CODEMON reads the metadata header and renders any frame on the fly via CSSbackground-position animation — no canvas, no JS tweens.

The renderer (PetSprite) is dumb on purpose: it sets CSS variables and lets the browser composite. That's how 100+ pets can animate on the same page without dropping a frame.

Every pet has four stats in 1..99: PWR, SPD, DEF, STA. They are 100% deterministic — the same pet always yields the same numbers. No DB writes, no RNG.

◇ Inputs

◇ Formulas

// diminishing-returns curve, 0..1
curve(n, k) = 1 - 1 / (1 + n / k)

// per-stat jitter from FNV-1a hash of (id + seed), in ±10
jitter(seed) = (hash01(id + seed) - 0.5) * 20

power   = clamp(20 + curve(likes,     8) * 75 + jitter("p"))
speed   = clamp(25 + (1 - min(name,24)/24) * 60 + salt*20 + jitter("s"))
defense = clamp(20 + curve(downloads, 6) * 70 + jitter("d"))
stamina = clamp(20 + curve(views,    40) * 75 + jitter("e"))

overall = round((power + speed + defense + stamina) / 4)

◇ Why diminishing returns?

Without a curve, a pet with 9000 likes would crush a pet with 90 likes by 100×. The curve() function squashes huge counts into the top of the 0-1 range, so a pet with 8 likes still gets ~50 % of max PWR, and a pet with 800 likes gets ~99 %. The k constants (8, 6, 40) calibrate each stat's "how much is enough" threshold.

Most of CODEMON is browseable without an account, but to create rooms, submit pets, claim starters, or buy from the shop you need to sign in at /auth (email + password, or Google). The same account follows you across the site and is the owner of your pets, points, and in-app wallet.

Every account gets an in-app Solana wallet generated server-side on first login. The keypair is encrypted at rest and only used to pay for actions inside CODEMON — there is no external signing flow, no browser extension required.

The shop at /shop mints a random pet straight into your collection. Payment is debited from your in-app wallet — no external wallet popup.

The boost is added to the pet's derived stats when it shows up in your collection — so a rare Goku hits harder than the same Goku in the public archive.

/world is the game. An 8-chapter pixel overworld with NPCs, wild encounters in tall grass, and a boss fight at the end of every chapter. You walk, talk, fight, catch, and repeat — all on the same arena engine used everywhere else on the site.

Every fight in CODEMON — wild encounter, boss, training duel — runs on the same fixed-step host-authoritative loop. The host client steps physics, resolves combat, and broadcasts snapshots.

/submit lets signed-in users add a Codemon to the archive. Paste the pet's public URL — we fetch the metadata and spritesheet, run a sanity check, and once approved it appears in /gallery and the shop pool.

/suggestions is the public roadmap. Anyone signed in can post a feature request, upvote others, and watch what's shipped. It's the fastest way to get something into the next build.

The leaderboard at /leaderboard (linked as ranks in the header) sorts every account by total points, with wins shown alongside. Points come from overworld battles and boss clears.