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

| Layer | Examples | Skill File(s) | |-------|----------|---------------| | Unity/C# | Game mechanics, UI, wallet | unity-sdk.md, csharp-patterns.md | | Mobile/RN | Mobile apps, MWA, offline | mobile.md, react-native-patterns.md | | Web/Frontend | Next.js, React, wallet | frontend-framework-kit.md | | Game Architecture | On-chain state, economics | game-architecture.md | | Program/Anchor | On-chain game logic | programs-anchor.md | | Program/Pinocchio | High-perf programs | programs-pinocchio.md |

2. Pick the Right Agent

| Task Type | Agent | Model | |-----------|-------|-------| | High-level design | game-architect | opus | | Unity code | unity-engineer | sonnet | | Mobile code | mobile-engineer | sonnet | | Learning/tutorials | solana-guide | sonnet | | Documentation | tech-docs-writer | sonnet |

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

| User asks about... | Primary skill file(s) | |--------------------|----------------------| | Unity wallet connection | unity-sdk.md | | Unity NFT loading | unity-sdk.md | | Unity transaction building | unity-sdk.md, csharp-patterns.md | | C# async patterns | csharp-patterns.md | | React Native mobile game | mobile.md, react-native-patterns.md | | Mobile Wallet Adapter | mobile.md | | Offline sync | mobile.md | | Web wallet connection | solana-dev → frontend-framework-kit.md | | Kit vs web3.js | solana-dev → kit-web3-interop.md | | Game state architecture | game-architecture.md | | PSG1 console | playsolana.md | | PlayDex achievements | playsolana.md | | In-game purchases | payments.md | | Arcium rollups | payments.md | | Testing Unity | testing.md | | Testing React Native | testing.md, react-native-patterns.md | | Security review | solana-dev → security.md | | DeFi integration | solana-dev → payments.md | | Token standards | solana-dev → payments.md | | Anchor program | solana-dev → programs-anchor.md | | Pinocchio program | solana-dev → programs-pinocchio.md | | Program testing | solana-dev → testing.md |

Commands

| Command | Description | |---------|-------------| | /build-unity | Build Unity projects (WebGL, Desktop, PSG1) | | /test-dotnet | Run .NET/C# tests (Unity Test Framework) | | /build-react-native | Build React Native projects | | /test-react-native | Run React Native tests | | /quick-commit | Quick commit with conventional messages |

Agents

| Agent | Purpose | |-------|---------| | game-architect | Game design, architecture, on-chain state, token economics | | unity-engineer | Unity/C# implementation, wallet, NFT, transactions | | mobile-engineer | React Native, MWA, offline-first, deep linking | | solana-guide | Education, tutorials, concept explanations | | tech-docs-writer | README files, API docs, integration guides |