// readme

AresRPG is a browser MMORPG where every character, item, fight and trade is a Sui object — the client is a renderer of chain truth, with zkLogin onboarding and player-paid transactions. This repository is the whole game: frontend, 3D voxel engine, deterministic combat and its Move twin, SDK, indexer, server, protocol, immutable rules, and the authored seed corpus. Game content (items, mobs, spells, and worlds) lives in seed/ and is published on-chain.

Install / run / test

bun install
bun run dev            # frontend at localhost:5173
bun run lint           # eslint + prettier
bun run test           # every package's unit tests — same command CI runs

Committed pins.json describes mainnet. Local testnet uses ignored .dev/pins.json; it never falls back to mainnet. Run the frontend normally for the selected network.

Blast hosts the standalone KARES presale. The in-game card links to Blast and reads its funding progress when a presale is configured. The app’s /kares page hosts staking; the encyclopedia explains allocations, vesting and rewards.

Solana bridge reads use the same-origin /api/solana function. Set SOLANA_RPC_URL as a server-only secret in…