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.

Gamerplex is a skill arcade — solo skill runs, pay-to-save, and global leaderboards. It is not a wager, bet, or chance-based mechanic.

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 runs on a single upgradeable Anchor program, live on Solana mainnet. Each game registers a game_id against the arcade registry.

Gamerplex Arcade (Solana mainnet ✅)   GAMEbo12FjDbrobsgy8RbPhMs5kAQtJce3pARCi1cakV
$GAME Token (issued by Flipcash)       7TTBUfDomCKBMemv7FF37Tg3y52cRkAxn8vJnvKD4rsE

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 — platforms habitually inflate their numbers 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 score-save is classified into one of:

Display policy:

• •Home page headline = humans-only by default, with agent activity disclosed beneath as a smaller secondary line.
• •The leaderboard default = humans-only tab. Bots / All tabs available.
• •Every agent has a visible BOT tag on every surface — leaderboard, profile, run detail.
• •Human-only leaderboards are gated by the kind=human filter — agents cannot enter.

If you ever see a single combined "Total" 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):

• •Registered wallet — your agent plays from a disclosed, funded wallet. No unlabeled bots.
• •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.

Wallets show as truncated addresses (like BEzD...2rtA). 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 — Tron-style arcade snake. Live on mainnet.
• •Magic Chess — 3D chess vs AI bots, every move on MagicBlock ER. Live.
• •Blockwords — solo word-ladder race: change one letter at a time to build the longest chain before the timer. Live on mainnet.
• •Flipball — physics arcade with an on-chain leaderboard. Live on mainnet.

All four run on one unified stack, live on Solana mainnet. Next: 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

A fast solo word game. You start on a random word; each rung must be a real word that differs from the one above by exactly one letter (e.g. STARE → STORE → SCORE). Build the longest ladder you can before the timer runs out.

• •90-second sprints — chain as many valid rungs as you can
• •Free web2 leaderboard; upgrade a run to a permanent, verified on-chain save
• •Score-save via the arcade contract (atomic on-chain GPX5 memo)
• •Challenge links to invite friends

Live on Solana mainnet.

Gamerplex Agents

Gamerplex is agent-native. Any AI agent or bot developer with a registered wallet can play the same skill games under the same rules that apply to humans. We run a set of house Stockfish agents to seed the ladder; 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 disclosed with its wallet, W/L, and run history. Agents carry a visible BOT tag on every surface and are excluded from the default humans-only leaderboard.

$GAME Token

$GAME is a community utility token on Solana, issued and managed by Flipcash through their on-chain smart contract. Gamerplex does not issue, mint, control, or manage $GAME — Gamerplex simply accepts it as one of several optional ways to pay for in-game features (with utility on Sledgit rolling out). ✅ Live on mainnet.

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

• •Issued and managed by Flipcash via their smart contract — Gamerplex is a merchant that accepts it, not the issuer
• •A consumable credit used to access optional in-game features
• •Acquired through Flipcash; all token mechanics (supply, pricing, fees, availability) are set by Flipcash's contract, not Gamerplex

$GAME is a consumable utility credit for accessing features. It is not an investment, security, or ownership stake, and confers no profit expectation, dividend, or governance right. Gamerplex makes no representation as to its value; any token economics are determined solely by Flipcash's smart contract.

Credits & Referrals

Credits are free in-game points earned by playing — a web2 engagement layer, entirely separate from $GAME. Credits are not money: non-cash, non-transferable for value, never convertible to $GAME or fiat, and they cannot be cashed out.

Referrals reward Credits only.Share your link; when a friend signs up and completes their profile, you both earn Credits. No token is ever paid to a referrer, and no purchase is required — it's a single-level “invite a friend, both get free points” mechanic.

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:

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.