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 World Kit

Open licences. Full provenance. AI-agent-first game building.The Sovereign World Kit lets your coding agent (Claude Code, Codex, Cursor) build original 3D worlds from open parts. Every output ships with a licence and a provenance record, and the kit refuses to recreate other people's games, characters or logos.

• •Install in Claude Code: /plugin marketplace add gamerplex/sovereign-world-kit, then /plugin install sovereign-world-kit@gamerplex. Ask: "build a neon street with Gamerplex, 24 bays".
• •Output: a GLB scene (any glTF engine; Unreal builds the same modules natively), a provenance.json with every input's source, licence and hash, and a LICENSE (CC0 1.0).
• •Licence gate: the build refuses any input without a known CC0 origin.
• •Walk it: every street opens as a web walkthrough on desktop and phone.
• •Or chat with a live preview: in gamerplex-dev (localhost:42069, any AI brain), type "build a neon cyberpunk street with gamerplex" and the street appears in the preview in about a minute. The kit builds straight into your game folder.
• •Status: streets ship today; the full CC0 world kit is about 5% built and growing. Next: buildings, whole districts, and anchoring provenance on Solana as proof of creation.

Step-by-step guide with the demo: gamerplex.com/build →

Provenance is not a token and nothing is traded. It records where an asset came from and what you may do with it. // copy-guard-allow: states what we do NOT do

Build with Gamerplex: the full stack, all open source

"Use Gamerplex" means a deployed, monetised game, not just files. Your agent picks integrations from a catalogue; each one is a skill plus a template.

• •Infrastructure: a NixOS flake you self-host anywhere (or we host), PostgreSQL, FerretDB, Valkey, Nakama, Colyseus, PocketBase, and MagicBlock real-time rollups.
• •Monetisation on Solana: the Gamerplex arcade (pay per play, live on mainnet), Wallet Adapter, Gamerplex Challenge Links, Squads treasuries, and $GAME payments via Flipcash, with free Credits for players.
• •Never in official skills: per-game tokens, DeFi yield, wagers or marketplaces. Builders are free to wire anything themselves (MIT / CC0).

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, or any OpenAI-compatible endpoint. 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.

Saving Your Score

Every game is free to play with no sign-in. Saving is the only place the account types differ, so here is exactly what each one does.

Why the split. The arcade contract records a score against the player's own signature — player: Signer. A Solana wallet (Phantom, Solflare, Backpack and other Solana wallets) can produce that signature. A Flipcash balance cannot: it is held inside Flipcash's own payment network rather than as an ordinary Solana account, so it can pay us but it cannot sign a transaction for you. Flipcash is the payment rail; a wallet is the signer. They do different jobs and you can use both.

What an on-chain save proves. That your key vouched for the result, and that the record is permanent — we cannot purge it and it outlives Gamerplex. It does not by itself prove the run was genuine, because scores are reported by the game client. That is what the verified tiers exist for — see Rankings Protocol and Fees & Revenue.

What this looks like on the board. Everyone who signs in appears on the leaderboard — Flipcash included. Scores that were also saved on-chain carry a Verified badge, and the board has a filter to show only those.

Email is optional. It is used only for account recovery, lives in your profile settings, and is never required to play, save or pay.

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
• •Yours for as long as you hold it — names are not traded

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.

10+ Games, One Stack

10+ games live on gamerplex.com, all registered on the same Gamerplex Arcade contract on Solana mainnet (11 game IDs: 10 games + 1 reserved). Same stack, same economics, different games.

• •Omega City: a war for a city, played on a 2D map, with a 3D flagship in Unreal.
• •Pet Legends Global: raise and battle AI pets.
• •Blockwords: a word-ladder race against the clock.
• •VRFC: Muay Thai, the art of eight limbs.
• •Cyber Snake, Magic Chess Puzzles, Flipball, Time Gate, Netherlevel and TCG Quiz.

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.