Solana Game Development Skill

Extends: solana-dev-skill – Core Solana development (programs, frontend, testing, security)

What This Skill Is For

Use this skill when the user asks for:

Unity Game Development

• Unity game development with Solana integration
• Wallet connection in Unity (Phantom, Solflare, InGame, Web3Auth)
• NFT loading, display, and game asset integration
• Transaction building and signing in C#
• PlaySolana/PSG1 console development

Mobile Game Development (React Native)

• React Native mobile games with Solana
• Mobile Wallet Adapter integration
• Offline-first game architecture
• Deep linking with Solana wallets
• Cross-platform iOS/Android development

Web Frontend (Gaming Context)

• Next.js/React frontends with Solana
• Wallet connection with framework-kit
• NFT galleries and game UIs
• Transaction UX patterns

Game Architecture

• On-chain vs off-chain game state
• Player progression and achievements
• Token economics and in-game currencies
• Multiplayer architecture with blockchain validation

Program Development (Delegate to Core Skill)

• For Anchor programs → programs-anchor.md
• For Pinocchio programs → programs-pinocchio.md
• For IDL/codegen → idl-codegen.md

Default Stack Decisions (Opinionated)

1) Unity Games: Unity 6000+ LTS

• Solana.Unity-SDK 3.1.0+ via UPM
• Modern Input System, UI Toolkit
• .NET 9 / C# 13
• Assembly definitions for organization

2) Mobile Games: React Native 0.76+ with Expo

• Mobile Wallet Adapter 2.x
• Zustand 5.x for state
• MMKV 3.x for storage
• TanStack Query 5.x for RPC data

3) Web: framework-kit first

• @solana/client + @solana/react-hooks
• @solana/kit for transactions
• Next.js 15 with App Router

4) Testing

• Unity: Edit Mode + Play Mode tests
• React Native: Jest + RNTL + Detox
• Web: Vitest + React Testing Library
• Programs: LiteSVM, Mollusk, Surfpool (see core skill)

5) Platform Targets

• Default: Desktop (Windows/macOS) and WebGL
• Mobile: When explicitly specified
• PSG1: When explicitly targeting PlaySolana

Operating Procedure

1. Classify the Task Layer

2. Pick the Right Agent

3. Apply Platform-Specific Patterns

Unity:

• Use WalletService pattern with events
• TransactionBuilder for building transactions
• NFTService with texture caching
• Async/await for all blockchain operations

React Native:

• Mobile Wallet Adapter for wallet connection
• Zustand stores for game state
• MMKV for offline persistence
• Network-aware sync patterns

Web:

• framework-kit hooks for wallet/balance
• React Query for RPC data
• Zustand for app state
• Kit types for transactions

4. Add Tests

• Unity: Edit Mode for logic, Play Mode for MonoBehaviours
• React Native: Component tests, hook tests, E2E
• Web: Component tests, hook tests
• Programs: LiteSVM/Mollusk (see testing.md)
• Two-strike rule: If test fails twice, STOP and ask

5. Deliverables

When implementing changes, provide:

• Exact files changed with clear diffs
• Package dependencies (manifest.json, package.json)
• Build/test commands
• Platform considerations

Progressive Disclosure (Read When Needed)

Gaming-Specific Skills (This Addon)

Unity & C#

• unity-sdk.md – Solana.Unity-SDK integration patterns
• csharp-patterns.md – C# coding standards and patterns

Mobile

• mobile.md – Mobile Wallet Adapter, Expo, offline-first
• react-native-patterns.md – React Native patterns

Game Systems

• game-architecture.md – On-chain vs off-chain, state design
• playsolana.md – PSG1 console, PlayDex, PlayID
• payments.md – Commerce, token transfers, in-game economy, Arcium rollups

Gaming Testing

• testing.md – Unity Test Framework, Jest, React Native testing

Reference

• resources.md – Curated links to SDKs and documentation

Core Solana Dev Skills (from solana-dev-skill)

These are provided by solana-dev-skill – install if not present

Web Frontend

• frontend-framework-kit.md – React hooks, wallet connection
• kit-web3-interop.md – Kit ↔ web3.js boundary patterns

Program Development

• programs-anchor.md – Anchor framework patterns
• programs-pinocchio.md – Pinocchio high-performance programs
• idl-codegen.md – IDL generation and client codegen

Core Testing & Security

• testing.md – LiteSVM, Mollusk, Surfpool
• security.md – Security checklist (programs + clients)
• payments.md – Core payment patterns
• resources.md – Core Solana resources

Task Routing Guide

Commands

Agents