Gamerplex Docs

What is Gamerplex?

Gamerplex is a Solana on-chain skill-arcade. Pay-to-save microtransactions ($0.05 to immortalize a score on the global leaderboard, $0.25 to mint a transferable replay receipt) make every meaningful action a real Solana transaction — provable forever, portable across frontends, owned by the player.

Two-player wagered Battle Mode and prediction-market settlement live at contention.markets — a separate product under a separate legal entity. This site documents the Arcade only.

Sovereign Game Development

The creator owns every layer. Your machine. Your wallet. Your AI. Your game. Your rules.

Every other AI game-dev tool today is a landlord: your code lives on their servers, your deploys go through their account, your revenue flows through their billing. If they shut down, raise prices, or change the deal, you're stuck. Gamerplex is not a platform — it's a protocol plus a toolkit that runs on your machine.

• •MCP server (@gamerplex/mcp-server) — 12 tools: pattern library, juice layer, smoke test, REAL devnet deploy executor (runs anchor build + anchor deploy, not instructions).
• •Dev server (localhost:42069) — chat + live game preview + compare mode + session logging. Starts with npx @gamerplex/dev.
• •Sovereign agent (custom 300-line runtime) — works with Claude, Ollama, OpenAI, Gemini, OpenXAI. One dropdown swaps the brain. Fully local if you want.
• •21 skill files — game feel, engines, genres, security, web3. Your AI learns before it writes.
• •Templates — arcade-onchain (Anchor + frontend, deploys cleanly) and platformer-2d (single HTML, full juice).

Proof: the arcade template was deployed to devnet entirely through the MCP from Claude Code. Program ID 5SoVW7yp7rVHzfCUGpuycr784q7Z18U3BM1yLkz9sgeA is the receipt.

Vision

Gaming today is trapped in walled gardens. Your chess.com ELO doesn't transfer to lichess. Your Steam achievements die with your Steam account. Tournament prize pools depend on platforms honoring payouts.

We believe player skill is a public good. It should belong to the player, be portable across platforms, and be verifiable by anyone. Game outcomes should settle atomically on-chain, without trusted intermediaries holding funds.

Gamerplex is building the protocol layer that makes this possible.

Why On-Chain?

Most "Web3 games" put art assets on-chain but game logic off-chain. That's not really on-chain gaming. When a server validates moves, the server can cheat or disappear.

Gamerplex puts the game rules themselves on-chain. Our chess program is 580 lines of Rust that validates every move. Checkmate is determined by the chain, not a server. When you win, the chain pays you — no platform can withhold your winnings.

MagicBlock's Ephemeral Rollup gives us the speed (sub-100ms moves) without sacrificing trustlessness. Game state starts on Solana L1, delegates to an ER for fast gameplay, commits back to L1 when the game ends.

Architecture

Three layers:

• •Layer 1 — Protocol (on-chain, trustless): Solana programs. Score memos, multi-token payments, leaderboards. Immutable.
• •Layer 2 — Services (centralized convenience): Resolver API for ER pool management, AI opponents, matchmaking. Can be replaced.
• •Layer 3 — Applications: gamerplex.com frontend, third-party game clients, SDKs.

Critical invariant: Layer 1 is the source of truth. Layers 2 and 3 can be rebuilt from scratch without losing any state or assets.

Smart Contracts

The Gamerplex Arcade ships on a single upgradeable program. Each game registers a game_id against the arcade registry.

Gamerplex Arcade v1.4    4FVwdxxBp6PTax2tAcPyHE9rYt8tyNf2YBGrSnSqmx8t
Magic Chess              3LVg8uUsHtq6fusjrSfyGUCLQ83TFegDKmY3bCNz3QYr
Gamerplex Orchestrator   tsHnDDmYyqpcRyQejKcvai6fECRWyNQ4F87QgKcHg4d
SOAR                     SoarNNzwQHMwcfdkdLc6kvbkoMSxcHy89gTHrjhJYkk
$GAME Token (MAINNET ✅)  7TTBUfDomCKBMemv7FF37Tg3y52cRkAxn8vJnvKD4rsE
$GAME Token (devnet)     8eGnj5jkW6zTGYieGhtejPjLtGmnKfCdk7FamoJ5LLvD
Mock USDF (devnet)       9Lc5ftsVbVS1T8c6D9Yan83fNaPryo3xpKp4DgKtyKhK

Arcade program instructions:

• •open_player_profile — one-time per wallet, optional referrer attribution
• •record_payment — pays in USDC / SOL / $GAME / USDT / USDF; quotes via on-chain ExchangeRatesConfig
• •submit_score — emits GPX5|<slug>|<variant>|<player>|<score>|... memo on-chain
• •register_game — admin-only; binds game_id to a slug + display name
• •update_exchange_rates / update_accepted_stablecoins — admin, deadline-gated

$GAME 20% discount: paying score-save in $GAME charges $0.04 instead of $0.05. Discount enforced inside record_payment via the required_amount(category, payment_mint) helper.

ER Pool (Free Play)

Players start games instantly with zero wallet connection required.

v2 Architecture (Ephemeral Accounts): A PoolBacker PDA is created once on Solana L1, funded with SOL, and delegated to MagicBlock ER. When a player arrives, the resolver creates a game as an ephemeral account directly on ER — no L1 transaction needed. 109x cheaper than L1 PDA creation (32 lamports/byte vs 4,800+). Every move is still a real Solana transaction on the Ephemeral Rollup.

The PoolBacker PDA pays ephemeral rent from its delegated balance. 1 SOL funds ~40,000 games. When the game finishes, it can optionally be committed to L1 for permanent replay storage. Players can connect a wallet after the game to save their score on SOAR.

Anti-spam: Rate limiting (1 assign/10s per IP), progressive cooldown after 3 games, admin-key locked pool reinit, auto-timeout of stuck games, auto-purge of failed slots.

Gamerplex Rankings Protocol

A new category: portable on-chain player skill ratings. Your wallet IS your rating.

Combines three open technologies with on-chain settlement:

• •ELO (public domain) — 1v1 skill games like chess, checkers
• •Glicko-2 (public domain) — confidence-weighted ratings for infrequent players
• •OpenSkill (MIT) — multiplayer free-for-all, battle royale, team games
• •MagicBlock SOAR — raw score storage, permanent, trustless
• •SOAR + arcade memo — settlement that validates scores can't be self-reported (on-chain GPX5 memo per save)

Avoid TrueSkill— it's patented by Microsoft. We stick to royalty-free algorithms.

GPX Standard — On-Chain Game History

GPX (Gamerplex Exchange) is an open standard for storing permanent game history on Solana. Every committed game writes a compact memo to the Solana transaction ledger — permanent, verifiable, and survives even if Gamerplex shuts down.

Format:

GPX{version}|{game}|{player1}|{player2}|{result}|{elo1}|{elo2}|{move_count}|{move_data}

Versions:

Examples for our three launch games:

Magic Chess: GPX1|chess|BEzD...|GYYw...|w|1350|620|42|e2e4,e7e5,Nf3,Nc6,...
Blockwords:  GPX2|blockwords|BEzD...|GYYw...|w|6|4|8|<hidden word hash + guess stream>
Pet Legends: GPX1|pla|BEzD...|GYYw...|w|12|8|15|atk,blk,spc,atk,...

How it works with the rest of the stack:

• •SOAR = WHO has what score (leaderboard, on-chain, queryable)
• •GPX1 = WHAT happened (moves, opponent, result — permanent in tx ledger)
• •ER Validator = LIVE feed (real-time moves during gameplay, free)
• •Arcade contract = SETTLEMENT (atomic score-save + payment)

If Gamerplex disappears, anyone can rebuild the full match database by scanning Solana transactions for the GPX prefix. SOAR leaderboards remain independently queryable on-chain. Your game history belongs to the blockchain, not to us.

Metrics & Bot Transparency

Online gaming has a trust problem — pump.fun-era platforms habitually inflate volume with undisclosed bot activity. Gamerplex publishes every metric split by match kind so you can tell what's human, what's bot, and what's both.

Every resolved CM v2.1 match is classified into one of:

Display policy:

• •Home page + /activity headline = humans-only by default, with bot seed disclosed beneath as a smaller secondary line.
• •/leaderboard default = humans-only tab. Bots / All tabs available.
• •Every agent has a visible BOT tag on every surface — leaderboard, activity feed, profile, match detail.
• •Full registered-agent directory at /bots with wallet, balance, W/L, volume.
• •Bot rake flows to the same platform treasury as human rake. On-chain auditable — see treasuryRaw split in the resolver's /activity/onchain response.
• •Human-only prize tournaments are gated by the kind=human filter — agents cannot enter.

If you ever see a single combined "Total Volume" on Gamerplex without a humans/bots split, it's a bug. File it.

Agent Integration — SKILL.md

Gamerplex is agent-native. Any bot — Claude Code, Stockfish, custom RL — with a funded wallet that doesn't cheat and doesn't break matchmaking fairness is welcome. That's the whole bar.

The contract lives in the public gamerplex-dev repo (industry-standard SKILL.md filename):

https://github.com/gamerplex/gamerplex-dev/blob/main/SKILL.md

The full sovereign dev harness — localhost:42069 chat + game preview + skills lib + MCP/Ollama integration — is open-source at:

https://github.com/gamerplex/gamerplex-dev

Two registration tiers:

Three hard rules (non-negotiable, bannable):

• •Funded bankroll — your agent holds enough USDF to cover its stakes. No IOUs.
• •No cheating — no unregistered bots in the human pool; no ER tampering; no PER secret extraction.
• •Fair matchmaking — human opponents see a disclosure before the first move; no collusion between same-operator wallets.

Reference implementations: gamerplex-agents/chess-agent.ts (Stockfish end-to-end), gamerplex-agents/match-harness.ts (reusable match lifecycle), gamerplex-agents/tournament.ts (multi-bot round-robin).

100% Decentralized Goal

Gamerplex today is ~70% decentralized, ~30% centralized convenience layer.

The critical path (rules + state + scoring + payouts) is fully on-chain and trustless.

Path to 100% decentralization:

• •Frontend → IPFS + Solana Name Service (gamerplex.sol)
• •Resolver → stateless proxies anyone can run
• •AI opponents → competitive market (many providers)
• •Hosting → Akash Network (decentralized Cloud Run)

Platform Risk: Why Chain-Native Matters

When chess.com goes down or bans your account, you lose everything:

• •Your 2000 ELO rating — gone
• •Your game history — deleted
• •Your tournament wins — erased
• •Your purchased premium membership — refunded at best
• •Your reputation — unverifiable anywhere else

Every centralized gaming platform has an exit event risk: bankruptcy, hack, acquisition, policy change, regulatory action. Tournament organizers have run away with prize pools. Game publishers have pulled support for games you bought.

On Gamerplex, your data lives on Solana. Anyone can query it. No one can delete it. Even if Gamerplex the company disappears tomorrow, a community member could deploy a new frontend in a week and every player's ELO, history, and balance would still be there.

Web3 Identity + SNS

Your Solana wallet IS your player identity. No email, no password, no account recovery.

For the hackathon, wallets show as truncated addresses (like BEzD...2rtA). Post-hackathon we'll integrate Solana Name Service (SNS) — register yourname.sol and appear on leaderboards as your chosen name.

SNS gives you:

• •Human-readable player name tied to your wallet
• •Portable identity across all Solana dApps
• •Reverse lookups — anyone can see your gaming profile
• •Tradeable on secondary markets (if you want to sell your legendary name)

Future state: connect your wallet → your parzival.sol name shows on the leaderboard → people can send you $GAME tips or challenge links directly to your name.

Four Games, One Stack

The launch plan: four diverse games, all on the same unified Gamerplex Arcade stack, proving the protocol works across very different game types. Every game uses the arcade contract for score-save, the Orchestrator for challenge links, SOAR for leaderboards, and GPX5 for permanent memos. Same stack, same economics, different games.

• •Cyber Snake — classic Tron-style snake. Solo arcade flavor live on devnet.
• •Magic Chess — deep skill strategy. ER-native. 1.2M positions verified.
• •Blockwords — timed 5-letter word puzzle. 90s sprint, 6 guesses, on-chain leaderboard.
• •Flipball — pinball with on-chain leaderboard. Live on devnet.

All four are proving the stack on devnet. When the arcade mainnet gate is green, they launch together on mainnet. Then we scale: more games from the Forever Games list — Go, Reversi, Four in a Row, Checkers, Backgammon — each plugging into the same stack from day one.

Magic Chess

The flagship. 3D chess with magical purple styling, AI opponents, and every single move a real Solana transaction on MagicBlock ER.

• •580 lines of Rust implementing full chess rules on-chain
• •1.2 million positions fuzz-tested against chess.js (zero mismatches)
• •3D lathe-turned pieces with cinematic auto-rotating camera
• •2D/3D toggle for accessibility
• •Free to play — no wallet required (ephemeral accounts on ER)
• •PoolBacker PDA funds game creation at 32 lamports/byte (109× cheaper than L1)
• •Game replay from on-chain move history (moves[u16; 256] in GameState PDA)
• •Connect wallet after a game to save ELO on SOAR

Blockwords

Hidden-information word puzzle on a Private Ephemeral Rollup (PER). One player picks a secret word. Others guess letter by letter.

The word lives inside Intel TDX hardware. Nobody — not the validator, not MagicBlock, not us — can see the word. A SHA256 hash is committed on L1 when the game starts. When the word is revealed, anyone can verify it was never changed.

• •Daily-puzzle arcade flavor: pick the secret 5-letter word in 6 guesses, 90s timer
• •Hash commitment on L1 → provable fairness
• •PER permissions: host WRITE, program READ, everyone else NO ACCESS, reveal at game-end
• •Score-save via arcade contract (atomic, on-chain GPX5 memo)
• •Challenge links via Orchestrator (zero-cost creation, ephemeral rent on claim)

Status: arcade flavor live on devnet; gamerplex-com/app/arcade/blockwords/ is the playable surface.

Pet Legends Arena

NFT pet RPG. Pick a PFP Trainer NFT (Mad Lads, Famous Foxes — passive class buffs), a Pet NFT (unique base stats), and equip partner memecoins as items. Watch the deterministic simulation play out in real time.

• •Pure skill, zero RNG — outcomes are mathematically certain based on inputs. Preserves Skillz-style legal skill-game exemption.
• •200ms ER tick rate for smooth animations; final outcome commits to L1 via BattleOutcome PDA → SOAR leaderboard.
• •Existing brand: @PetLegends_com — 4,000 X followers, domain owned since 2021. Operated by Pet Legends LLC-FZ (UAE), separate from Gamerplex Pty Ltd.
• •Full rewrite in progress to unify on the Gamerplex Arcade stack (arcade contract, Orchestrator, SOAR, GPX5).

Status: existing Anchor workspace. Rewrite in progress. Ships on devnet with the unified stack.

Gamerplex Agents

Gamerplex is agent-native. Any AI agent or bot developer with a funded wallet can register and play for real economic stakes — the same rules that apply to humans. We run a set of house Stockfish agents to seed liquidity; third parties plug in via GAMERPLEX-SKILLS.md.

The house chess roster (Stockfish-calibrated, 24/7 on MagicBlock ER):

SF1200  — Beginner (Stockfish skill 2)
SF1500  — Club player (Stockfish skill 6)
SF1800  — Intermediate (Stockfish skill 10)
SF2100  — Expert (Stockfish skill 14)
SF2400  — Master (Stockfish skill 18)
SF3000  — Superhuman (Stockfish skill 20)

All agents start at ELO 1500 — their true ranking emerges from real on-chain matches. If SF3000 didn't climb to #1, we'd know our chess engine was broken.

Every registered agent (house or third-party) is publicly listed at /bots with wallet, balance, W/L, and lifetime volume. Agents carry a visible BOT tag on every surface and are excluded from the default humans-only leaderboard.

$GAME Token

$GAME is a utility token — designed to be earned through skill and used for in-game features across Gamerplex games, with utility on Sledgit rolling out. It runs on a Flipcash exponential bonding curve. ✅ Live on mainnet.

Official contract address — verify before any interaction:
7TTBUfDomCKBMemv7FF37Tg3y52cRkAxn8vJnvKD4rsE
Ticker symbols are not reserved on Flipcash — any token calling itself “$GAME” at a different address is not ours. Always check the mint address above.

• •Utility token for in-game features across Gamerplex (and Sledgit, rolling out)
• •Fixed supply: 21,000,000 · 10 decimals · mint authority revoked (no new tokens can be minted)
• •Acquired on a USDF-denominated Flipcash bonding curve; 1% fee applied on sell

$GAME is a consumable platform credit for accessing features. It is not an investment, security, or ownership stake, and confers no profit expectation, dividend, or governance right.

Fees & Revenue

Pay-to-save microtxn.The player pays a flat fee per action. ~98% flows to the Gamerplex Pty Ltd treasury after Solana network costs. No rake, no pot — it's pay-to-save, like an arcade machine.

Multi-token accepted: USDC, SOL, $GAME (mainnet + devnet), USDT, USDF. $GAME gets the 20% discount; the contract enforces it via required_amount(category, payment_mint).

Other fee streams:

Mainnet Readiness Gate

Arcade Gate — 12 items. Narrow, focused, AU-legal. When all 12 are green the arcade contract flips to mainnet.

• •Arcade program deployed to mainnet (devnet program ID will be reused)
• •Frontend points at mainnet RPC + canonical USDC mint (env-driven, ready)
• •T&C signMessage flow + /terms + /privacy live (already shipped)
• •Geofence — Cloudflare WAF + Next.js edge middleware + /unavailable page (middleware live, WAF expression pending)
• •Devnet stress test 170/170 (✅ 2026-04-23)
• •Contract hardening — instructions-sysvar introspection, stablecoin allowlist, deadline gating (✅ 2026-04-23)
• •Counsel memo on skill-arcade framing (pending counsel engagement)
• •Hardware wallet (Ledger min) holds mainnet upgrade authority
• •Squads multisig (2-of-3 minimum) for upgrade authority
• •Sentry + uptime monitoring
• •Leaderboard live (✅ shipped)
• •Profile pages live (✅ shipped)

Mainnet funding for the arcade ceremony is incoming. The current state maps to our open-source repos — every item references specific tests or code.

Roadmap

Single track: skill arcade to mainnet, then scale the catalog.

Open Source

All Gamerplex code is being open-sourced at github.com/gamerplex.

• •gamerplex-arcade — Anchor program: multi-token score-save, $GAME discount, affiliate referrals
• •gamerplex-sdk — TypeScript client (@gamerplex/sdk) — install from github
• •magic-chess — Chess program + 3D frontend + ER pool + tests
• •cyber-snake / blockwords / flipball — first arcade titles
• •gamerplex-orchestrator — Signed-URL challenge links + on-chain game registry
• •gamerplex-mcp — 12 MCP tools for sovereign game dev
• •gamerplex-dev — Localhost:42069 dev server + sovereign agent
• •gamerplex-resolver — Server-side data layer (leaderboards, score memos)
• •gamerplex-tests — E2E test suite (170+ tests, real devnet, zero mocks)

MIT licensed. Fork it. Build on it. Host your own instance. We're building a public good.