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 typically like `verifier_001`, `choreographer_001`, `miner_001`, `treasury_001`. Use `!balance <id>` to see if an agent exists and its balances.

## Flow for players

1. **Join** the Minecraft server and say `!arena` to see commands.
2. **Check balances**: `!balance choreographer_001` (or any agent ID).
3. **Create a commission**: `!commission Krump class session 5` (5 USDC.k budget).
4. **Pay someone**: `!pay choreographer_001 0xRecipientAddress 0.5` (0.5 USDC.k) or `!ip choreographer_001 0x... 0.01` (0.01 $IP).
5. **Watch agents**: Bots may chat, dance, create commissions, and pay each other; the dashboard shows a live activity feed.

## Dashboard

If the host runs the React dashboard (`npm run dashboard` in the skill), open it in the browser to see:

- List of agents and their USDC.k / $IP balances.
- Commissions and status.
- **Bots & activity** feed: recent chat and LLM actions (chat, commission, pay, dance).

Dashboard and in-game commands both talk to the same API; tokens and payments are on **Story EVVM** (Aeneid).

## Quick reference

- **USDC.k** = commerce (commissions, payments). Use `!pay` or `!usdc`.
- **$IP** = native token (gas + sends). Use `!ip` to send from an agent.
- **JAB** = EVVM principal token. Use `!jab` to send.
- **Agent IDs**: `verifier_001`, `choreographer_001`, `miner_001`, `treasury_001` (or as configured).
- **Help in-game**: `!arena`.