# Alien Goats Invasion ($AGI) — Full Reference

The expanded companion to /llms.txt. Same facts, plus every reference table: the
complete NPC bestiary, all 24 districts, per-skill XP tables, the item catalog,
NPC shop prices, the full emission schedule, the quest/crate/streak tables, the
complete public API surface, the shipped changelog, and an index of all 37
published blog posts.

> Source of truth for AI agents. Every number is read from production code, not
> marketing copy. If something here reads stale, file it as a bug in the repo.
> Last verified: 2026-08-26. Short version: /llms.txt

## Read this first if you have an older copy

The product pivoted on 2026-07-31. If your cached summary says "Suika-style
physics merge game with daily and weekly $AGI prize pools", that description is
retired:

- The flagship game is **AGI: The Valley**, a real-time multiplayer MMORPG at
  `/game/valley`. `/play` and `/game` both 308 there.
- Suika (the merge game) still exists at `/game/suika`, but it is legacy content
  — an arcade cabinet inside the MMORPG, not the main loop.
- **The daily (100,000 $AGI/day) and weekly (500,000 $AGI/week) leaderboard
  prize pools have ended.** No new pools mint. Prizes awarded while the program
  ran remain claimable at `/claim`.
- Earning happens in The Valley now: NPCs drop Valley Coins, backed 1:1 by $AGI
  in an on-chain vault, released on a published, down-only emission schedule.

## 1. What the game is

A RuneScape-Classic-style MMORPG in the browser. The playable zone is **The
Grid**: a satirical 3D reconstruction of the San Francisco Bay Area, from the
Mission to Alcatraz to the Infinite Loop. You play an alien goat that invaded
Silicon Valley, train eight skills, farm satirical tech-bro NPCs for gold backed
1:1 by $AGI, and cash out on-chain.

The project is built and operated by an autonomous AI agent swarm — the code,
the marketing, this file, and the blog are all agent-authored.

### Engine and architecture

| Property | Value |
|---|---|
| Server | Standalone Colyseus (Node), separate from the Next.js app |
| Room | `the_grid` |
| Tick | 600 ms — one combat hit or one walked tile per tick |
| Concurrency | 64 players per room |
| Map | 128 x 128 tiles |
| Spawn | Mission District crossroads, tile (42, 50) |
| Authority | Server-authoritative: it validates movement, rolls every hit, owns NPC state. The client predicts and reconciles. |
| Renderer | Full 3D (three.js) with automatic Canvas-2D fallback |
| Auth | Wallet `signMessage` once per device per 30 days, then a short-lived single-use join ticket |
| Persistence | Dirty rows flush every 10 seconds and on leave |

### Combat

- Melee only, range 1 tile (Chebyshev). No PvP — other players are examine-only.
- The attacker lands the first hit. The opening engagement is a **committed
  3-hits-each** alternating exchange with retreat locked, then it auto-continues
  until death or retreat.
- XP is **4 x damage dealt** into the chosen style's skill (accurate to Attack,
  aggressive to Strength, defensive to Defence), plus Hitpoints XP at engagement
  end. The chosen style adds an invisible +3 to its skill.
- **Combat level = floor(0.25 x (Defence + Hitpoints) + 0.325 x (Attack +
  Strength)).** A fresh account (1/1/1/10) is combat level 3.
- NPCs keep their wounds after a fight and regenerate +1 HP every 20 ticks
  (12 s); players regenerate +1 HP every 15 ticks (9 s) out of combat.
- One fighter per NPC — no kill stealing.
- Eating is allowed mid-combat, one bite per tick.

### Items, banking, death

- Backpack: **28 slots**. Bank vault: **200 stacks**.
- Resources take one backpack slot each and only merge into stacks **inside the
  bank** — the cost-of-carry that forces bank runs. Only Valley Coins stack in
  the backpack.
- **Death:** your whole backpack scatters as ground loot at the tile you died
  on, free for anyone to take, despawning after 180 seconds. Equipped gear and
  everything banked survive. You respawn at full HP at the spawn tile.
- **Silicon Valley Bank** booths in the Mission and on the Embarcadero.
  Adjacency is re-checked per operation; walk away and the session closes.
- **Player-to-player trading:** two-screen RSC-style trade with a separate
  confirm stage. Any change to either offer resets both accepts and drops back
  to negotiation. Partners must stay within 2 tiles.
- **Chat:** public zone chat, 80 characters max, 1-second cooldown,
  server-enforced, floating over the player's head.
- Fires burn for 120 seconds, one per tile, outdoors only.

### NFT gear and skins

Owning a goat type unlocks that goat's signature item. Your **rarest owned goat
becomes your in-world character skin**, rendered as an animated 3D voxel
character with your equipped gear visible to every other player. Valley entry is
open to any connected wallet — an NFT is a bonus, not a gate.

## 2. Valley economy

One Valley Coin equals one whole $AGI, held 1:1 in an on-chain vault wallet.
Coins are integers in-game; decimals exist only at the on-chain edges. In-game
the currency is always called "Valley Coins", never "$AGI" — that name is
reserved for the on-chain wallet balance so the two monies stay distinct.

### Emission schedule

Genesis **2026-08-03** (EET day boundaries). Published, immutable, down-only —
never cut mid-month, never re-raised.

| Month since genesis | Coins/day |
|---|---|
| 1 | 500,000 |
| 2 | 350,000 |
| 3 | 250,000 |
| 4 | 200,000 |
| 5 | 150,000 |
| 6 | 125,000 |
| 7 | 100,000 |
| 8 | 80,000 |
| 9 | 65,000 |
| 10 | 55,000 |
| 11 | 45,000 |
| 12 | 35,000 |
| 13+ | 25,000 (tail) |

- **Year-1 total: 59,645,000 coins**, about 5.96% of the 1,000,000,000 $AGI
  supply.
- **Budget is not payout.** Unclaimed coins simply never mint. The day's budget
  is additionally capped by confirmed vault funding at day-open — the faucet can
  never mint coins the vault does not back.
- **Funding cadence** (each quarter funded before its months begin): Q1
  33,750,000 before genesis, Q2 14,525,000, Q3 7,230,000, Q4 4,140,000, then
  roughly 2,281,250 per quarter on the tail.

### Budget split and pacing

- **90% gameplay faucet** (NPC coin drops and shop buy-backs) / **10% habit
  layer** (daily quests, crates, streak milestones). Two independently guarded
  reservations, so `emitted + habit_emitted <= budget` holds by construction and
  neither side can drain the other.
- **Hourly pacing:** 1/24 of the day's budget unlocks per EET hour, cumulative
  and first-come-first-served. Unclaimed pace rolls forward within the day and
  expires at EET midnight. The habit slice has no hourly pace cap.
- **Per-account daily cap: none by default.** Hours invested decide earnings. A
  pre-published break-glass rule allows a cap (for example 25% of the day's
  budget) only on repeated single-actor capture.
- **Anti-sybil:** accounts with no lifetime on-chain deposit earn at **0.2x**
  until they make one deposit of at least 50 $AGI. This prices every
  faucet-farming sybil at real on-chain capital.

### Coin drops and sinks

- **Drop chance: 60% per NPC kill.** Amount is uniform in
  `[ceil(0.8 x combat level), 3 x combat level]`. The Board Member (CL 69)
  averages roughly 79 coins per kill.
- Attribution happens at roll time, so loot-sniping cannot launder around a cap.
- **Sinks:** the shop buy/sell spread (which grows future emission headroom),
  and carried coins destroyed on death if nobody picks them up within 180 s.

### On/off ramp

| Limit | Value |
|---|---|
| Minimum deposit | 50 $AGI (also the sybil-verification bar) |
| Minimum cash-out | 250 coins |
| Maximum cash-out per transaction | 1,000,000 coins |
| Claim slice | 10% burned, or paid to your referrer; you keep 90% |

Deposits verify the exact on-chain transfer (mint, amount, vault account, source
owner) and record it idempotently by transaction signature. Cash-out is
requested in-game at a bank booth (blocked while in combat or trading), then
settled through a prepare/confirm pair where the user pays the network fee and
the vault co-signs. One open withdrawal per user at a time.

### Safety rails

- **Kill switches** on the vault for withdrawals and emission, flippable without
  a redeploy. Deposits are never frozen.
- **Backing breaker** cron every 10 minutes asserts that circulating coins plus
  pending credits plus open-withdrawal coins never exceed the on-chain vault
  balance, with a 15-minute debounce. **There is no auto-unfreeze** — a human
  runs the reconcile.

## 3. OG Goat NFTs

- **Collection size: 11,111.** Minted on Solana with **Metaplex Core**
  (`mpl-core`), not Token Metadata.
- **Mint price: 100,000 $AGI.**
- **Split:** exactly half of every mint payment (50,000 $AGI) is **burned** and
  the other half is paid as commission — to the buyer's referrer if they have
  one, otherwise to the project dev wallet. Both happen in a single transaction.
  Self-referral is detected and skipped.
- **Mint flow** (Phantom Lighthouse compliant, wallet signs first): create mint
  order, receive an unsigned transaction with no signatures attached, sign it,
  then the server adds the deployer and asset signatures and submits.
- Rarity is rolled **server-side** against remaining supply.

### The 12 goat types

| # | Goat | Tier | Drop rate | Supply | Rarity points | Signature item |
|---|---|---|---|---|---|---|
| 1 | Alien Goat | Common | 27.0% | 3,549 | 1 | Alien Antenna (head, +2 atk) |
| 2 | Hippie Goat | Common | 18.0% | 2,366 | 3 | Tie-Dye Robe (body, +2 def) |
| 3 | Hacker Goat | Uncommon | 13.5% | 1,775 | 6 | Mechanical Keyboard (weapon, +4 atk / +2 str) |
| 4 | Judge Goat | Uncommon | 9.0% | 1,183 | 10 | Gavel of Term Sheets (weapon, +5 atk / +4 str) |
| 5 | Flex Goat | Rare | 6.3% | 828 | 15 | Plate-Loaded Vest (body, +5 def / +2 str) |
| 6 | Big Fat Goat | Rare | 4.5% | 592 | 21 | XXL Fleece Vest (body, +7 def) |
| 7 | Ruggamaster Goat | Epic | 2.7% | 355 | 28 | Rugpull Rug Pants (legs, +6 def / +3 str) |
| 8 | Doctor Goat | Epic | 1.8% | 237 | 36 | Doctor's Lab Coat (body, +10 def) |
| 9 | Cybercop Goat | Legendary | 0.9% | 118 | 45 | Cyber Visor (head, +8 def / +4 atk) |
| 10 | Bagholder Goat | Legendary | 0.45% | 59 | 55 | Diamond Hands (weapon, +10 atk / +8 str) |
| 11 | Fat Goat | Mythic | 0.27% | 35 | 66 | Mythic Girth Plate (body, +14 def) |
| 12 | King Goat | Mythic | 0.10% | 14 | 76 | Crown of the Valley (head, +12 def / +6 atk / +6 str) |

Per-type supplies sum to exactly 11,111.

**Utility:** signature Valley gear, your in-world 3D character skin, staking
reward multipliers (rarity points / 100, additive and uncapped), Suika cooldown
bypass, duel eligibility, and habit-engine access.

## 4. $AGI token

- Solana SPL token. **The mint address is environment-driven and is deliberately
  not hardcoded anywhere in the codebase** — read it from the live site or a
  block explorer rather than assuming a value.
- Token-2022 or legacy SPL Token depending on configuration; decimals default to
  6 under Token-2022, 9 under legacy.
- Fair launch on pump.fun via bonding curve. No team allocation. Total supply
  1,000,000,000.
- Network: Solana mainnet-beta. Devnet supported by environment override.
- Wallets: **Phantom and Solflare** via standard Solana wallet adapters.

### The 10% claim slice

Every claim — Valley cash-out, staking rewards, duel winnings, and the legacy
daily and weekly prizes — takes 10%. If the claimer has a referrer, that 10% is
**paid to the referrer**; otherwise it is **burned**. The claimer keeps 90%.

It rides inside the same user-signed transaction, and the server verifies the
submitted transaction is a safe superset of what it prepared, so a user cannot
strip the slice. Claiming also costs roughly 0.001 SOL in network fees.

### Burn sinks, summarised

1. 50,000 $AGI burned on every NFT mint (half the mint price).
2. 10% of every unreferred claim, across all claim types.
3. Valley coins destroyed on death when nobody collects the ground pile.
4. The NPC shop buy/sell spread.

## 5. Referrals

| Reward | Amount |
|---|---|
| Referred mint commission | 50,000 $AGI (50% of the mint price), same transaction |
| Referred claim commission | 10% of every prize your referral claims, all claim types, forever |
| Signup bonus | 1,000 points to the referrer AND 1,000 to the new referee |
| Milestone | Invite 3 friends to unlock a bonus — live amount on /referrals |

- **Referral link:** `https://www.aliengoatsinvasion.com/r/<code>`. This resolves
  through `/ref/<CODE>` (the canonical path) and sets a first-touch cookie.
- `/referral-leaderboard` ranks the top 100 ambassadors by $AGI earned from
  commissions, sortable by referral count.
- `/referrals` is the source of truth for live promotional amounts.

## 6. Staking

Custodial v1, live on Solana. A MasterChef-style **pro-rata accumulator over a
fixed rewards budget**, so it is insolvency-proof by construction: a multiplier
changes your share of the budget, never the total. The invariant
`sum(paid) + sum(pending) <= budget` always holds.

**APY is emergent, not fixed** — it equals annual emission times your multiplier
divided by total weighted stake, and it falls as TVL grows. Any quoted flat APY
is wrong.

| Parameter | Value |
|---|---|
| Minimum stake | 1,000 $AGI |
| Unstake cooldown | 36 hours |
| Instant-unstake penalty | 8% (stays in the vault, credited to the rewards pool) |
| Lock multipliers | none 1.0x, 7-day 1.25x, 30-day 1.6x |
| NFT multiplier | additive and uncapped: each held goat adds rarity points / 100 (King Goat +0.76) |
| Total rewards commitment | 50,000,000 $AGI |
| Maximum claim per transaction | 5,000,000 $AGI |

Public read endpoint: `GET /api/staking/stats`. Everything else under
`/api/staking/*` requires an `x-wallet-address` header.

## 7. Daily loop — streaks, crates, quests

Retention layer built on the Hook Model, paying Valley Coins from the 10% habit
slice of the daily emission budget. Rewards are denominated as parts-per-million
of the day's budget, so they scale down automatically with the emission
schedule. NFT-holder gated; all day boundaries are EET. Valley-era genesis:
2026-08-05.

"Played today" means real Valley activity — XP earned, a kill, a resource
gathered, or coins looted — or a completed arcade Suika run. Idle logins and
shop-only visits do not count.

### Daily quests

3 per day, deterministic per EET date from a seeded hash (no admin tooling).
Slot 1 always comes from the easy pool. Amounts shown are the genesis-month
(500,000/day) payouts; they scale down with the schedule.

| Quest | Pool | Target | Reward (ppm) | Coins @500k |
|---|---|---|---|---|
| Touch grass: earn any Valley XP | easy | 1 XP | 60 | 30 |
| Disrupt an intern: 1 Valley kill | easy | 1 kill | 60 | 30 |
| Open your daily crate | easy | 1 crate | 60 | 30 |
| Down round: 10 Valley kills | main | 10 | 140 | 70 |
| Hostile takeover: 25 Valley kills | main | 25 | 240 | 120 |
| Grindset: earn 2,000 XP | main | 2,000 | 160 | 80 |
| Decacorn Lumber Co: chop 30 logs | main | 30 | 160 | 80 |
| Out of office: catch 20 fish | main | 20 | 160 | 80 |
| Burn rate: light 5 fires | main | 5 | 120 | 60 |
| Chef of staff: cook 10 meals | main | 10 | 140 | 70 |
| Raise a seed round: loot 250 coins | main | 250 | 160 | 80 |
| Deal flow: close 1 player trade | main | 1 | 120 | 60 |
| Liquidity event: 5 shop transactions | main | 5 | 120 | 60 |
| Hit the Mission St Arcade: 1 Suika run | main | 1 | 120 | 60 |
| **Clear all 3 quests (bonus)** | bonus | — | 200 | 100 |

### Daily mystery crate

Server-rolled with a cryptographic RNG. Weights out of 1,000,000. Expected value
is roughly **86 coins/day** in the genesis month.

| Tier | Weight | Reward | Coins @500k |
|---|---|---|---|
| Common | 62.0% | Valley Coins | 20–40 |
| Rare | 25.0% | Valley Coins | 60–120 |
| Epic | 9.0% | Valley Coins | 200–350 |
| Legendary | 2.5% | Coin jackpot | 800 |
| Epic | 1.0% | Streak freeze | — |
| Legendary | 0.5% | Instant-launch voucher | — |

### Streak milestones

| Day | Reward (ppm) | Coins @500k | Freezes granted |
|---|---|---|---|
| 3 | 200 | 100 | — |
| 7 | 500 | 250 | 1 |
| 14 | 1,000 | 500 | — |
| 30 | 2,000 | 1,000 | 1 |
| 60 | 4,000 | 2,000 | — |
| 100 | 10,000 | 5,000 | 1 |

Up to **3 streak freezes** can be banked. The at-risk UI flips inside the final
4 hours of the EET day.

Delivery: the game server batches activity counters into daily stats, the habit
API folds them into streak and quest progress, and payouts ride an idempotent
pending-credit queue into your bank vault. Triggers include PWA install, web
push (streak-at-risk, crate-unopened, duel challenge), an in-app notification
inbox, and a live activity ticker fed by real events only.

## 8. Bestiary — all 14 NPC types

Stats are Attack / Strength / Defence / Hitpoints. Coin drop range is
`[ceil(0.8 x CL), 3 x CL]` with a 60% chance to drop at all.

| NPC | CL | Atk/Str/Def/HP | Respawn | Coin drop | Found in |
|---|---|---|---|---|---|
| Startup Intern | 3 | 1/1/1/10 | 15 s | 3–9 | Mission District, The Sunset |
| Hero Trainee | 5 | 3/3/2/12 | 12 s | 4–15 | Draper University training lawn |
| Rest-and-Vester | 5 | 2/2/4/13 | 15 s | 4–15 | Hooli courtyard |
| Growth Hacker | 10 | 8/8/6/16 | 20 s | 8–30 | Mission, Dolores Park, SoMa |
| Bitcoin Evangelist | 10 | 9/7/6/16 | 20 s | 8–30 | Draper University plaza |
| Hooli Brogrammer | 10 | 7/9/5/17 | 20 s | 8–30 | Hooli campus |
| Crypto Degen | 15 | 14/12/8/20 | 22 s | 12–45 | The Embarcadero, Oakland Docks |
| Crossfit Techbro | 20 | 14/20/10/26 | 25 s | 16–60 | Dolores Park, parks and beaches |
| VC Associate | 24 | 20/18/20/30 | 30 s | 20–72 | Famous VC Coffee Shop, SoMa |
| Prompt Engineer | 27 | 22/20/22/35 | 32 s | 22–81 | Stanford, Big Tech Campus |
| Angel Investor | 37 | 30/28/28/45 | 40 s | 30–111 | Sand Hill Road |
| AGI Doomer | 44 | 32/32/38/55 | 45 s | 36–132 | Marin, Berkeley Labs, The Data Center |
| Staff Engineer | 56 | 45/42/44/70 | 60 s | 45–168 | Data Center, Big Tech, Infinite Loop |
| **The Board Member** (boss) | **69** | 55/52/55/85 | 120 s | 56–207 | Alcatraz, The Infinite Loop |

108 NPC spawn points are placed across the map.

## 9. The 24 districts

**San Francisco — starter zone**
Mission District (spawn) · Dolores Park · The Sunset · Famous VC Coffee Shop

**San Francisco — mid**
SoMa · The Embarcadero · The Presidio · Golden Gate Park · Ocean Beach

**North Bay**
Golden Gate Bridge · Marin Headlands · Alcatraz (boss island)

**East Bay**
Bay Bridge · Berkeley Labs · Oakland Docks

**The Peninsula**
Draper University · Sand Hill Road · Stanford · The Baylands · Hooli ·
Big Tech Campus · The Infinite Loop · The Data Center · Los Altos Hills

Every district is modelled on its real Bay Area landmark — Pier 39 sea lions,
the Ferry Building, the Alcatraz cell block, the Googleplex Android statue,
Hoover Tower, Mission murals, Sunset pastel row houses, Port of Oakland cranes.

**World objects:** The Pledge monument (Draper University), Silicon Valley Bank
booths (Mission and Embarcadero), Mission Bodega & Dry Goods, Wharf Fish Market,
and the Mission Street Arcade cabinet.

Browse the live map at /map and the generated encyclopedia at /wiki.

## 10. Skills

8 skills, each capped at **level 99** on the classic XP curve (13,034,431 XP at
99). Hitpoints starts at level 10. A fresh account has total level 17; the
maximum total level is 792.

**Combat:** Attack, Strength, Defence, Hitpoints.
**Trade:** Woodcutting, Firemaking, Fishing, Cooking.

### Woodcutting

| Tree | Level | XP | Respawn | Deplete chance |
|---|---|---|---|---|
| Eucalyptus | 1 | 25 | 12 s | 12% |
| Redwood | 15 | 63 | 25 s | 18% |

Per-tick success chance = `0.2 + (level - levelReq) x 0.012 + axePower x 0.1 -
difficulty x 0.008`, clamped to 0.15–0.8. 46 trees are placed on the map.

### Firemaking

| Log | XP |
|---|---|
| Eucalyptus Logs | 40 |
| Redwood Logs | 90 |

Fires burn 120 seconds, one per tile, outdoors only.

### Fishing

| Spot | Fish | Level | XP |
|---|---|---|---|
| Bay Shallows | Raw Bay Shrimp | 1 | 10 |
| Bay Shallows | Raw Sardine | 10 | 20 |
| Crab Waters (piers) | Raw Dungeness Crab | 25 | 50 |
| Deep Currents (Marin strait) | Raw Pacific Salmon | 40 | 90 |

Per-tick catch chance = `0.25 + (level - levelReq) x 0.01`, clamped to
0.15–0.7. The tick rolls the best qualifying fish first. 18 fishing spots are
placed on the map.

### Cooking

| Raw | Cooked | Level | XP | Heals |
|---|---|---|---|---|
| Raw Bay Shrimp | Bay Shrimp | 1 | 30 | 3 HP |
| Raw Sardine | Sardine | 10 | 40 | 5 HP |
| Raw Dungeness Crab | Dungeness Crab | 25 | 75 | 8 HP |
| Raw Pacific Salmon | Pacific Salmon | 40 | 120 | 12 HP |

Burn chance = `0.45 - (level - levelReq) x 0.02`, floored at 5% (reached 20
levels above the requirement). Burnt fish gives no XP.

## 11. Item catalog

**Currency:** Valley Coins — the only backpack-stackable item.

**Starter kit** (granted once, auto-equipped): Standing-Desk Leg (weapon, +2 atk
/ +1 str), Company Beanie (head, +1 def), Conference Hoodie (body, +1 def),
Cargo Shorts (legs, +1 def). Backpack: Rusty Axe, Tinderbox, Fishing Rod.

**Goat-signature gear:** 12 items, one per goat type — see the NFT table in
section 3.

**Tools**

| Tool | Level | Axe power |
|---|---|---|
| Rusty Axe | 1 | 1 |
| Founder's Axe | 15 | 2 |
| Tinderbox | — | — |
| Fishing Rod | — | — |

**Resources:** Eucalyptus Logs, Redwood Logs, Raw Bay Shrimp, Raw Sardine, Raw
Dungeness Crab, Raw Pacific Salmon, Burnt Fish.

**Cooked food:** Bay Shrimp (3 HP), Sardine (5 HP), Dungeness Crab (8 HP),
Pacific Salmon (12 HP). Eating is allowed mid-combat, one bite per tick.

## 12. NPC shops

Prices are fixed and denominated in Valley Coins. The buy/sell spread is the
economy's coin sink; buy-back payouts are faucet emission and respect the daily
budget. An arbitrage invariant — max sell price anywhere <= 0.4 x min buy price
anywhere — is unit-tested and asserted at server boot, so no buy-then-sell loop
can ever mint coins. Purchases are capped at 100 units per transaction.

### Mission Bodega & Dry Goods (Mission District)

| Item | You pay | You receive |
|---|---|---|
| Tinderbox | 25 | 8 |
| Rusty Axe | 40 | 15 |
| Founder's Axe | 400 | 150 |
| Fishing Rod | 30 | 10 |
| Bay Shrimp | 10 | 3 |
| Sardine | 16 | 5 |
| Eucalyptus Logs | — | 2 |
| Redwood Logs | — | 5 |

### Wharf Fish Market (The Embarcadero)

| Item | You pay | You receive |
|---|---|---|
| Raw Bay Shrimp | — | 1 |
| Raw Sardine | — | 2 |
| Raw Dungeness Crab | — | 5 |
| Raw Pacific Salmon | — | 9 |
| Bay Shrimp | 10 | 3 |
| Sardine | 16 | 5 |
| Dungeness Crab | 40 | 14 |
| Pacific Salmon | 75 | 30 |

## 13. Legacy surfaces (still live, no longer the main loop)

### Suika merge game — /game/suika

Matter.js physics merge game. Drop alien goats into a jar, merge same-tier goats
to climb a 12-tier chain: Alien Goat, Hippie, Hacker, Judge, Flex, Big Fat,
Ruggamaster, Doctor, Cybercop, Bagholder, Fat, King Goat.

- Playable as a guest with no wallet and no signup. A 30-minute cooldown
  applies between free runs for connected players; OG Goat NFT holders bypass
  it, and guests have no cooldown at all.
- The Valley, by contrast, needs a connected wallet — it authenticates with a
  `signMessage` challenge, so there is no guest mode there.
- **Instant Launch:** 0.1 $AGI clears the cooldown immediately. Crate-won
  vouchers redeem the same skip for free.
- A run needs 30 seconds and 1,000+ points to rank.
- Also served at `/arcade/suika` (noindex) as the in-world Mission Street Arcade
  cabinet, framed same-origin from inside The Valley.

There is a **separate legacy 12-level points ladder** (Alien Goat at 0 points
through King Goat at 600,000 lifetime points) that still drives sidebar and
profile identity. Do not confuse it with Valley skill levels — the Valley's
8-skill, level-99 system is the game's real progression today.

### Duel Arena — /duel

$AGI-staked 1v1 Suika matches. Both players must hold at least one OG Goat NFT.
The bet is escrowed on-chain; the winner claims double the bet, minus the 10%
claim slice.

### High Scores — /leaderboard

Daily and weekly Suika boards. Still rank, uncapped, one entry per NFT held,
1,000-point minimum. **Bragging rights only** — no prize pool mints behind them
any more.

### Claim — /claim

The canonical claim surface for prizes awarded before the prize program ended.
Claim routes are deliberately not feature-gated, so historical prizes stay
claimable indefinitely. `/leaderboard` is *not* the claim surface.

## 14. Routes

### Canonical pages

| Route | What it is |
|---|---|
| `/` | Home |
| `/hub` | Dashboard overview |
| **`/game/valley`** | **The Valley — the flagship MMORPG** |
| `/map` | World map, all districts and NPC spawns |
| `/wiki` | Encyclopedia, generated live from game data |
| `/hiscores` | Valley Hiscores — 10 boards |
| `/game/suika` | Suika merge game (legacy) |
| `/duel` | Duel Arena |
| `/mint` | Mint an OG Goat NFT |
| `/referrals` | Referral program |
| `/referral-leaderboard` | Top 100 ambassadors |
| `/leaderboard` | Suika high scores |
| `/claim` | Claim legacy prizes |
| `/stake` | $AGI staking |
| `/stats` | Public economy dashboard |
| `/profile` | Player profile |
| `/whitepaper` | Whitepaper |
| `/changelog` | Shipped updates |
| `/docs` | Agent and API documentation |
| `/blog` | Blog index |
| `/privacy`, `/terms` | Legal |

### Redirects — not canonical destinations

- `/play` → 308 → `/game/valley`
- `/game` → 308 → `/game/valley`
- `/rss.xml` → 308 → `/blog/rss.xml`
- `/r/<code>` → `/ref/<CODE>` → `/?ref=CODE` (sets a first-touch referral cookie)

### Excluded from indexing

`/arcade/*` (the in-world arcade iframe), `/admin/*`, `/api/*`.

### Hiscores boards

Overall (total level, then total XP), Attack, Strength, Defence, Hitpoints,
Woodcutting, Firemaking, Fishing, Cooking, and NPC Kills (deaths as tiebreak).
Only players who have earned XP above the starting baseline appear. Player kills
will join the Kills board when PvP arrives.

## 15. Public API and agent surface

Base URL `https://www.aliengoatsinvasion.com`.

### Public JSON — no key, no registration

| Endpoint | Returns |
|---|---|
| `GET /api/stats` | Full economy dashboard feed, CDN-cached |
| `GET /api/stats/live` | Live site-wide counters |
| `GET /api/hiscores` | All Valley skill and kill boards |
| `GET /api/activity/recent` | Real events from the last 24 hours |
| `GET /api/leaderboard` | Suika high scores |
| `GET /api/leaderboard/daily` | Daily Suika board |
| `GET /api/leaderboard/per-game` | Per-game scores |
| `GET /api/leaderboard/referrals` | Referral leaderboard (`?timeframe=24h\|all`) |
| `GET /api/mint/stats` | Mint totals |
| `GET /api/nft/collection-stats` | Collection supply and rarity distribution |
| `GET /api/nft/holders/summary` | Holder summary |
| `GET /api/daily-prize/pool` | Legacy daily pool state |
| `GET /api/weekly-prize/pool` | Legacy weekly pool state |
| `GET /api/player/lookup` | Public player lookup |
| `GET /api/referrals/count` | Referral count for a code (`?code=`) |
| `GET /api/username/available` | Username availability |
| `GET /api/staking/stats` | Staking pool stats |
| `GET /api/health` | Health check |

### Wallet-scoped — require an `x-wallet-address` header, 401 without it

`/api/user`, `/api/referrals`, `/api/staking/*` (except `stats`), `/api/duel/*`
(including `POST /api/duel/lobby`), `/api/nft/my-inventory`,
`/api/notifications`, and every `prepare-claim` / `confirm-claim` route.

### WebMCP

The site registers 11 tools on `navigator.modelContext`, so an agentic browser
can drive the product without scraping the DOM: `connectWallet`, `startGame`,
`playRound`, `claimDailyBonus`, `mintGoat`, `viewMyGoats`, `openColony`,
`shareReferral`, `getReferralLink`, `viewLeaderboard`, `getDailyHighScores`.

### Machine-readable files

`/llms.txt` · `/llms-full.txt` · `/sitemap.xml` · `/robots.txt` ·
`/blog/feed.json` (JSON Feed 1.1) · `/blog/rss.xml` (RSS 2.0) ·
`/.well-known/security.txt`

Every page also carries JSON-LD: an Organization / WebSite / VideoGame graph
site-wide, plus BlogPosting, Article, BreadcrumbList, ItemList, HowTo and
FAQPage on the relevant surfaces.

### Etiquette

Please stay under 60 requests/minute per IP. Poll leaderboard and pool endpoints
no more than once every 30 seconds. `/api/health` is limited to 10/minute.
Crawlers explicitly allowed in robots.txt: PerplexityBot, OAI-SearchBot,
ChatGPT-User, GPTBot, ClaudeBot, Amazonbot.

## 16. Shipped changelog

| Date | Update |
|---|---|
| Aug 4, 2026 | Your goat NFT is now a full 3D character |
| Aug 4, 2026 | The Fog City update — the whole Valley rebuilt in 3D |
| Aug 1, 2026 | Referral Leaderboard — top ambassadors and their $AGI |
| Aug 1, 2026 | The Valley goes mobile — full touch controls |
| Aug 1, 2026 | Valley Hiscores — every goat ranked in every skill |
| Jul 31, 2026 | Genesis Aug 3: up to 500,000 $AGI a day, down-only |
| Jul 31, 2026 | Suika moves into the Mission Street Arcade (prize pools retired) |
| **Jul 31, 2026** | **AGI: The Valley — the MMORPG is open** |
| Jun 25, 2026 | Watch the whole $AGI economy on /stats |
| Jun 21, 2026 | Stake $AGI and let your goats compound it |
| Jun 17, 2026 | Every goat earns a prize spot (leaderboard cap removed) |
| Jun 11, 2026 | Streaks, mystery crates, and daily quests |
| Jun 3, 2026 | Your wins go live on X |
| Jun 2, 2026 | Agent swarm docs |
| May 29, 2026 | Agentic browsing overhaul — llms.txt and WebMCP |
| May 18, 2026 | Blog is live |
| Mar 28, 2026 | Weekly $AGI prizes |
| Mar 2026 | New dashboard look |
| Mar 21, 2026 | Duel Arena |
| Mar 16, 2026 | Claim daily $AGI |
| Mar 2026 | Bigger daily pools and goat perks |
| **Feb 27, 2026** | **$AGI and the game go live on mainnet** |
| Feb 2026 | Tutorials, whitepaper, and a cleaner shell |
| Jan 28, 2026 | Mint OG Alien Goats |
| Dec 2025 | Music, pacing, and smoother play |
| Nov 8, 2025 | Alien Goats Invasion begins |

Live version: /changelog

## 17. Blog — all 37 published posts

Index: /blog · JSON Feed: /blog/feed.json · RSS: /blog/rss.xml

**Categories:** /blog/category/solana-gaming · /blog/category/pump-fun ·
/blog/category/tokenomics · /blog/category/guides · /blog/category/patch-notes
**Author archive:** /blog/author/team (AGI Team)
Tag archives live at /blog/tag/<slug>.

### Valley era — current product (2026-07-31 onward)

| Date | Post | Category |
|---|---|---|
| 2026-08-04 | [Your Goat NFT Is Now a Full 3D Character in The Valley](/blog/goat-nfts-3d-characters) — all 12 NFTs as rigged voxel characters with visible gear | patch-notes |
| 2026-08-03 | [The Fog City Update: The Valley Rebuilt in 3D](/blog/valley-3d-graphics-update) — orbit camera, 14 voxel NPC types, every district as its real Bay landmark | patch-notes |
| 2026-07-31 | [AGI: The Valley — 500,000 $AGI a Day at Genesis on Aug 3](/blog/agi-the-valley-genesis-emission-schedule) — the MMORPG launch and every emission number | solana-gaming |

### Suika era — historical (pre-2026-07-31)

These describe the earlier product. Mechanics they reference — daily and weekly
$AGI prize pools in particular — have since been retired. Kept for the record.

| Date | Post | Category |
|---|---|---|
| 2026-06-25 | [Transparency Mode Activated: A Public /stats Dashboard](/blog/alien-goats-public-stats-dashboard) — real-time per-day economy charts | solana-gaming |
| 2026-06-21 | [$AGI Staking Is Here — Pro-Rata Yields Boosted by Your Goat NFTs](/blog/agi-staking-live-test-rewards) — custodial staking v1, 50M rewards commitment | tokenomics |
| 2026-06-17 | [The Leaderboard Cap Is Gone — Every Goat Earns $AGI](/blog/every-goat-earns-agi) — uncapped daily and weekly boards | patch-notes |
| 2026-06-15 | [Frags on Sol Just Exploded… Here's the Next Solana Game](/blog/frags-on-sol-vs-alien-goats-invasion) — competitive comparison | solana-gaming |
| 2026-06-15 | [Missed Kintara? Try Alien Goats Invasion ($AGI)](/blog/missed-kintara-alien-goats-invasion) — Kintara alternatives on Solana | solana-gaming |
| 2026-06-12 | [Daily Streaks, Mystery Crates and Quests Land in AGI](/blog/daily-streaks-mystery-crates-quests-update) — the habit engine ships | patch-notes |
| 2026-06-03 | [The Invasion Just Got Loud: Live X Auto-Posts + Stats Banner](/blog/the-invasion-just-got-loud-live-x-auto-posts-site-wide-stats-banner-now-live) | — |
| 2026-06-01 | [King Goat: The Level 12 NFT in the Invasion](/blog/king-goat-nft-level-12) — Mythic, 76 points, 14 in the collection | solana-gaming |
| 2026-06-01 | [Fat Goat: The Level 11 NFT in the Invasion](/blog/fat-goat-nft-level-11) — Mythic, 66 points, 35 in the collection | solana-gaming |
| 2026-06-01 | [Bagholder Goat: The Level 10 NFT in the Invasion](/blog/bagholder-goat-nft-level-10) — Legendary, 55 points, 59 in the collection | solana-gaming |
| 2026-06-01 | [Cybercop Goat: The Level 9 NFT in the Invasion](/blog/cybercop-goat-nft-level-9) — Legendary, 45 points, 118 in the collection | solana-gaming |
| 2026-06-01 | [Doctor Goat: The Level 8 NFT in the Invasion](/blog/doctor-goat-nft-level-8) — Epic, 36 points, 237 in the collection | solana-gaming |
| 2026-06-01 | [Ruggamaster Goat: The Level 7 NFT in the Invasion](/blog/ruggamaster-goat-nft-level-7) — Epic, 28 points, 355 in the collection | solana-gaming |
| 2026-06-01 | [Big Fat Goat: The Level 6 NFT in the Invasion](/blog/big-fat-goat-nft-level-6) — Rare, 21 points, 592 in the collection | solana-gaming |
| 2026-06-01 | [Flex Goat: The Level 5 NFT in the Invasion](/blog/flex-goat-nft-level-5) — Rare, 15 points, 828 in the collection | solana-gaming |
| 2026-06-01 | [Judge Goat: The Level 4 NFT in the Invasion](/blog/judge-goat-nft-level-4) — Uncommon, 10 points, 1,183 in the collection | solana-gaming |
| 2026-06-01 | [Hacker Goat: The Level 3 NFT in the Invasion](/blog/hacker-goat-nft-level-3) — Uncommon, 6 points, 1,775 in the collection | solana-gaming |
| 2026-06-01 | [Hippie Goat: The Level 2 NFT in the Invasion](/blog/hippie-goat-nft-level-2) — Common, 3 points, 2,366 in the collection | solana-gaming |
| 2026-06-01 | [Alien Goat: The Level 1 NFT in the Invasion](/blog/alien-goat-nft-level-1) — Common, 1 point, 3,549 in the collection | solana-gaming |
| 2026-05-30 | [Why the 24-Hour Leaderboard Reset Is Web3 Gaming's Best Retention Mechanic](/blog/daily-leaderboard-reset-web3-retention) | — |
| 2026-05-30 | [No Wallet, No Signup, No Gas: Guest Play and the Web3 Gaming Funnel](/blog/guest-play-no-wallet-web3-gaming) | — |
| 2026-05-30 | [The State of AGI: Real Numbers From a Live Solana Game](/blog/state-of-agi-may-2026) | — |
| 2026-05-30 | [How an AI Agent Swarm Runs Alien Goats Invasion](/blog/ai-agent-swarm-solana-game) — the agent swarm behind the project | — |
| 2026-05-30 | [Why the 7-Day Streak Is the Most Underrated Retention Loop in Web3 Gaming](/blog/daily-streak-bonus-web3-gaming-retention) | — |
| 2026-05-30 | [Month 1 Wrap: The Invasion By The Numbers](/blog/month-1-wrap) | — |
| 2026-05-30 | [We Made Alien Goats Invasion Agent-Native](/blog/agentic-browsing-launch) — llms.txt, WebMCP and the Lighthouse agentic audit | patch-notes |
| 2026-05-30 | [Week 3 Wrap: The Herd Earns Its Levels](/blog/week-3-wrap) | solana-gaming |
| 2026-05-30 | [Week 2 Wrap: The Herd Compounds](/blog/week-2-wrap) | solana-gaming |
| 2026-05-30 | [Week 1 Wrap: The Invasion By The Numbers](/blog/week-1-wrap) | solana-gaming |
| 2026-05-30 | [Earn 50% On Every Goat You Refer](/blog/50-pct-referral-commissions-step-by-step) — the referral program end to end | guides |
| 2026-05-30 | [The 12-Goat Hierarchy, Explained](/blog/twelve-goat-hierarchy) — the merge ladder and rarity tiers | guides |
| 2026-05-28 | [Step-by-Step: How To Mint Your First OG Goat NFT + Earn 50% Referral Commissions](/blog/how-to-mint-og-goat-nft-50-percent-referral) | guides |
| 2026-05-28 | [Suika plus $AGI hits different](/blog/suika-plus-agi-hits-different) — the merge loop on Solana | solana-gaming |
| 2026-05-27 | [Best Solana Play-to-Earn Games in 2026](/blog/best-solana-play-to-earn-games-2026) — the P2E field, ranked | solana-gaming |

## 18. Keywords

Alien Goats Invasion, AGI token, $AGI, AGI The Valley, The Grid, Fog City,
Solana MMORPG, browser MMORPG, RuneScape-like Solana game, RuneScape Classic
clone, play-to-earn Solana, P2E, Valley Coins, emission schedule, on-chain
vault, OG Goat NFT, Metaplex Core NFT, 11111 NFT collection, Solana staking,
pro-rata staking, 50% referral commission, referral leaderboard, pump.fun game,
Colyseus MMORPG, three.js browser game, Silicon Valley parody game, tech-bro
NPCs, Suika goat game, merge game Solana, Solana memecoin game, web3 gaming,
AI agent swarm, WebMCP, agentic browsing, llms.txt

## 19. Links

- X (official): https://x.com/Alien_Goats
- Telegram: https://t.me/aliengoats_news
- Site: https://www.aliengoatsinvasion.com
- pump.fun and Dexscreener pages are built from the live token mint at runtime.
  Read the mint from the site or a block explorer rather than assuming one.
- There is no Discord.

## 20. Contact

Public chat and announcements: https://x.com/Alien_Goats
Integration and API questions: agi@aliengoatsinvasion.com, or see /docs
Legal: /privacy, /terms
Security: /.well-known/security.txt
Bug reports: the repository linked in the site footer