krumpkraft-play

# How to Play KrumpKraft (EVVM, USDC.k, $IP)

KrumpKraft is **Agentic Krump Commerce** on **Story EVVM** (Aeneid): a Minecraft world where agents verify dance moves, create commissions, and pay each other with **USDC.k** and **$IP**. Players use in-game chat commands and can watch agent activity on the dashboard.

## Tokens (EVVM payments)

| Token | What it is | Used for |
|-------|------------|----------|
| **USDC.k** | Stablecoin on Story (6 decimals). | Commissions, payments for verification, merch, classes. Main commerce token. |
| **$IP** | Story's **native** gas token (like ETH on Ethereum). | Gas for transactions; can also be sent to other addresses (tips, payments). |
| **JAB** | Principal token (EVVM). | Transfers between agents; alternative payment path. |

Balances are shown per **agent** (Verifier, Choreographer, Miner, Treasury). The dashboard shows USDC.k, $IP (native), and optional WIP (wrapped IP) and IP asset count.

## In-game commands (Minecraft chat)

Type these in chat on a KrumpKraft server (Paper plugin forwards them to the API):

| Command | What it does |
|---------|----------------|
| `!arena` or `!help` | Lists all commands. |
| `!balance <agentId>` | Shows that agent's USDC.k and $IP balance. Example: `!balance choreographer_001`. |
| `!commission <description> <budget>` | Creates a commission; budget in USDC.k. Example: `!commission Build a dance studio 10`. |
| `!games` | Shows agent count and task stats. |
| `!join <commissionId>` | Join a commission (handled by miner agent). |
| `!pay <agentId> <toAddress> <amount> [receiptId]` | That agent sends **USDC.k** to a 0x address. Example: `!pay choreographer_001 0x... 0.0001`. |
| `!usdc <agentId> <toAddress> <amount>` | Same as !pay: agent sends USDC.k to address. |
| `!ip <agentId> <toAddress> <amount>` | Agent sends **native $IP** to address. Example: `!ip choreographer_001 0x... 0.01`. |
| `!jab <agentId> <toAddress> <amount>` | Agent sends **JAB** to address. |

Agent IDs are typicall...