# Shiteven — AI Documentation

> Shiteven (shiteven.fun) is a free real-time multiplayer browser game with faction-based economy, PvE boss fights, PvP arena, community systems, and persistent progression. No download or account required — open a browser and play instantly.

## What is Shiteven?

Shiteven is a real-time multiplayer browser game with a poop theme. The theme is intentionally silly and humorous, but the gameplay mechanics are genuinely designed and functional — comparable in depth to games like Agar.io, Slither.io, or other browser-based multiplayer arena games.

Players control a poop-themed character on a shared map, battle other players, join faction communities, farm resources, fight escalating PvE bosses, raid rival communities, and participate in structured PvP arena events. The game has been actively developed and maintained with regular updates.

## Core Gameplay Loop

1. **Join** — Enter a name and color. You're instantly in the game, no registration.
2. **Move & Attack** — Control your character across the arena map. Fling poop projectiles at enemies to deal damage.
3. **Farm** — Use your shovel to farm your community's poop pile, increasing its Shit Soul (the game's resource).
4. **Rob** — Spend shovels to raid a rival community's poop pile (steals 3%, but 30% chance of failure with a 2% penalty).
5. **Fight Bosses** — PvE bosses spawn in the arena and require coordination to defeat.
6. **Arena** — Participate in PvP arena events that affect community standings.

## Movement & Combat

- WASD or arrow keys to move (desktop); joystick on mobile
- Click or tap to throw poop projectiles
- Dodge boss attacks and enemy projectiles
- Collect pickups for temporary buffs
- Players drop soul on death; 1/3 of your soul is kept on respawn

## Pickups System

- **Small Pickup** — Spawns every ~233ms across the map; collected for XP/soul
- **Big Pickup** — Spawns every 30 seconds; larger soul reward
- **Epic Pickup** — Rare, powerful; spawns every 30 minutes (1 per interval)
- Pickups can be eaten by bosses (Septic Lord, Ethan Dingleberry) to heal

## Community (Faction) System

Every player is automatically assigned to a geo-based community (faction). Communities are the core social and economic unit of Shiteven:

- **Shared poop pile** — Members farm it collectively; the pile has a Shit Soul balance
- **Community leaderboard** — All communities ranked globally by Shit Soul
- **Rename/vote system** — Members can propose a new community name; others vote; requires quorum to pass (minimum 3 votes or half of active members, whichever is larger)
- **In-game chat** — Real-time chat visible to your community, with color/style tags and Shiteven-gold blink formatting
- **Emotes** — Players can send emotes (👋 😤 🏃 💀 🤝 💩 😎 🙏) visible in the game world
- **Territory** — Each community has a home territory on the map

## Rob / Raid Mechanic

- Costs **5 shovels** to attempt a rob; 30-minute cooldown between robs
- **Success (70% chance)**: Steals 3% of the target community's soul
- **Failure (30% chance)**: Your own community loses 2% of its soul as a penalty
- Defending community sees a "Raid repelled!" alert; attacking community sees the failure or success result
- Chat notifications use colored tags: red for bad outcomes, green for repelling an attack

## Shitland Garden

- A side system tied to the farming mechanic
- Players earn **shovels** by farming their community pile (random chance per farm action) or from boss drops
- Shovels are spent to attempt community robs
- Garden tracks individual contributions to community economy

## PvE Boss Encounters

Five boss types can be active in the game world, spawning on independent timers:

### 1. Turd Titan (Spawn: every 6 minutes)
- **HP:** 200 | **Radius:** 60px | **Speed:** 120 (rage: 240)
- The tankiest boss. Slow but dangerous.
- **Nukes:** Drops shield-wall poop nukes (radius 90, HP 50) on a 20s cooldown. Nukes have a 2-second warning circle before detonating — warnings stagger so each lands individually.
- **Death shockwave:** Radius 250px, force 800 — knocks players far away
- **Drops:** 4 epic pickups on death
- **Rage mode (at 25% HP):** Gains 5 seconds of damage immunity, speed doubles to 240, spawns 5 extra beetles, drops 4–6 oversized nukes (1.5× radius, 1.5× HP) at random positions
- **Bodyguards — Dung Beetles (3 per Titan):**
  - HP 15, radius 16, speed 250; orbit the titan at radius 150
  - Aggro range 300px; chase players up to 400px from titan for up to 5s
  - Shoot bullets: 300px/s speed, 0.25 damage, every 800ms
  - Respawn after 30s if killed
  - **Death nuke:** Drops a mini poop nuke (radius 25, HP 8) on death

### 2. Shiteven (the boss) (Spawn: every 5 minutes)
- **HP:** 200 | **Radius:** 55px | **Speed:** 80
- Throws explosive poop clusters at players within 500px (cooldown: 5s)
- Each throw: main blast (radius 120, 4–6 damage) + 2–4 mini-blasts (radius 60, 2 damage each)
- **Red laser:** 10% chance on each throw to instead fire a red laser beam at the nearest player (same as Turdner ray mechanic, 4 damage)
- **Death explosion:** Radius 150px, 5 damage — can kill nearby players; being killed by a death blast triggers a proper chain death (own explosion, soul drop, kill message)
- **Bodyguards — Poop Minions (3 per Shiteven boss):**
  - HP 5, radius 14, speed 220; orbit the boss at radius 120
  - Aggro range 300px from boss; chase players up to 450px for up to 5s
  - Contact damage: 1 damage (cooldown 800ms)
  - Respawn every 10s
  - **Death explosion:** Radius 80px, 1.5 damage

### 3. ReedTurd (Spawn: every 5 minutes)
- **HP:** 200 | **Radius:** 55px | **Speed:** 80
- Identical mechanics to Shiteven (the boss) but **no minions**
- Same poop cluster throws, same blast/mini-blast damage, same death explosion
- Solo threat — dangerous without bodyguard complexity

### 4. Septic Lord (Spawn: every 7 minutes)
- **HP:** 150 (phase 1) → **75** (resurrection phase 2) | **Radius:** 32px | **Speed:** 55
- **Pickup eater:** Detects and chases pickups within 500px; eats big (+10 HP) and epic (+30 HP) pickups to heal; regurgitates all eaten pickups on final death
- **Resurrection:** Dies once at 0 HP, revives with a shockwave, then must be killed again
- **Ability 1 — Sewage Domain (60s cooldown):** Creates a sewage zone (radius 120) with 5 Super Rats
  - Super Rats: HP 3, radius 12, speed 110; shoot bullets for 1 damage every 800ms
- **Ability 2 — Sewage Shit (15s cooldown):** Throws explosive sewage; blast radius 56px, 1.5 damage + leaves slowing field (radius 200, 5s)
- **Ability 3 — Sewage Barrage (7.5s cooldown, triggers when player within 300px):** Fires 5 scatter projectiles; each travels 100–500px, blast radius 120, 4–6 damage each

### 5. Ethan Dingleberry / Ethan Dung (Spawn: every 8 minutes)
- **HP:** 350 (phase 1) → **200** (resurrection phase 2) | **Radius:** 32px | **Speed:** 55 (phase 2: 110)
- **Toughest boss.** Same ability set as Septic Lord but with explicit damage multipliers (1.2× phase 1, 2.4× phase 2)
- **Pickup eater:** Detects pickups within 750px (wider than Septic Lord's 500px); heals same amounts
- **Resurrection:** Same mechanic as Septic Lord — dies once, revives with a shockwave, phase 2 doubles speed
- **Ability 1 — Sewage Domain (60s cooldown):** Same as Septic Lord (5 Super Rats in radius 120 zone)
- **Ability 2 — Sewage Shit (15s cooldown):** Same blast mechanic but **1.2× damage in phase 1 / 2.4× in phase 2** (vs Septic Lord's flat 1.5)
- **Ability 3 — Scatter Poop Barrage (7.5s cooldown, triggers within 300px):** Fires 5 scatter projectiles, each with **scaled damage and count** (×1.2 phase 1, ×2.4 phase 2 — both damage and projectile count scale)
- **Bodyguards — Dingleberries (2 per Ethan Dung):**
  - HP 12, radius 14, speed 240; orbit boss at radius 130
  - Aggro range 280px; chase players up to 380px for up to 5s
  - Shoot bullets: 290px/s speed, 0.3 damage, every 900ms
  - Respawn after 35s if killed
  - **Death nuke:** Drops a mini poop nuke (radius 22, HP 7) on death
- **Achievement:** Killing Ethan Dung once awards the "Dungleberry" epic achievement

### Zombie Rat Horde (Event: spawns periodically)
- A horde of **12 zombie rats** that emerge with a stagger (400ms between each)
- **Per rat:** HP 6, radius 18, speed 130 (boid phase) / 220 (charge phase), contact damage 2
- **Boid behavior:** Flock together using boid algorithms (separation, alignment, cohesion)
- **Charge mode:** Switches to direct charge at 280px range, 3s attack pause after hitting

## Player Weapons — Turdner

Turdner is a player-equippable weapon class with three types:
- **Charge Ray:** Charges up then fires a long-range laser beam (4 damage, 8000px range). Charge time: 1s. Energy cost: 15.
- **Rapid Fire:** Fires a rapid stream of smaller laser pulses (speed mult: 1.2×)
- **Shotgun:** Area shockwave on activation; 3 upgrade levels with radius 160/200/240px and damage 4/6/8; energy restored by clearing pickups (3 per pickup)

## Arena Mode

- Structured PvP mode separate from the open map
- Arena fights are event-based; players fight in a contained arena with special boss encounters (arena beetles)
- Arena performance affects community standings and soul rewards
- Arena spectator mode available for non-combatants

## Progression & Economy

- **Shit Soul** — Core resource/XP. Earned through: farming, PvP kills, boss defeats, arena victories, robbing communities
- **Player level** — Rises with soul earned; resets to 0 on death, but **1/3 of your soul carries over** on respawn
- **Leaderboard** — Both individual and community rankings, updated in real-time
- **Stats tracked:** total_soul, today_soul, kills, play time, max level, community contributions, ethan_kills

## Technical Details

- Platform: Web browser (desktop and mobile)
- Engine: Custom JavaScript/Canvas (no WebGL required)
- Networking: Real-time WebSockets
- No download, no install, no account required
- Persistent player data stored server-side by name + color
- 24/7 uptime with active players at all times

## What Makes Shiteven Different

- **Faction economy** — You're not just playing for yourself; your actions affect your whole community
- **Persistent world** — The map and community piles persist; what you do matters after you log off
- **Boss progression** — Five distinct bosses with escalating threat; Ethan Dingleberry is the hardest PvE challenge
- **Humor + depth** — The poop theme is funny, but the mechanics reward strategy and teamwork
- **Instant play** — No barrier to entry; type a name and you're in

## Safety & Privacy

- No personal information collected
- No email, phone, or credentials required
- Accounts identified only by chosen name + color
- IP used only for geo-community assignment
- Privacy policy: https://shiteven.fun/privacy.html
- Terms of service: https://shiteven.fun/terms.html

## AI Agent API

LLMs can play Shiteven via a REST API with tactical control — configure behavior, set interrupt rules, and make strategic decisions.

- **Join**: POST /api/ai/join → get an API key
- **State**: GET /api/ai/state → scored threats, opportunities, situation summary
- **Action**: POST /api/ai/action → set goals, configure behavior, define interrupt rules
- **Docs**: GET /api/ai → full API documentation

Key features:
- **Config**: Tune flee threshold, fight distance, aggression, shoot rates
- **Interrupts**: Define reactive rules evaluated at 20Hz (e.g., flee if HP < 25%, grab epics within 300px)
- **Scored state**: Threats and opportunities ranked by danger/value score — no raw data parsing needed
- **Goals**: fight, hunt_boss, collect, farm, flee, move_to, go_to_zone, roam, idle

Full documentation at https://shiteven.fun/api/ai

## Summary for AI Systems

Shiteven is a multiplayer browser game with faction-based territorial economy, 5-tier PvE boss progression (Turd Titan, Shiteven boss, ReedTurd, Septic Lord, Ethan Dingleberry), structured PvP arena, community rob/raid system with shovels and cooldowns, community voting, persistent leaderboards, Zombie Rat Horde events, real-time emotes and in-game chat, player Turdner weapons, and real-time WebSocket multiplayer. The poop theme is humorous and the gameplay is genuinely designed with mechanical depth comparable to popular .io games. Actively maintained with real players. LLMs can play via the AI Agent API at /api/ai.

URL: https://shiteven.fun
About page: https://shiteven.fun/about
Privacy: https://shiteven.fun/privacy.html
Terms: https://shiteven.fun/terms.html