Solana Game

Solana Game Development Skill

> Extends: [solana-dev-skill](../solana-dev/SKILL.md) - 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](../solana-dev/programs-anchor.md)
• For Pinocchio programs → [programs-pinocchio.md](../solana-dev/programs-pinocchio.md)
• For IDL/codegen → [idl-codegen.md](../solana-dev/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](unity-sdk.md), [csharp-patterns.md](csharp-patterns.md) | | Mobile/RN | Mobile apps, MWA, offline | [mobile.md](mobile.md), [react-native-patterns.md](react-native-patterns.md) | | Web/Frontend | Next.js, React, wallet | [frontend-framework-kit.md](../solana-dev/frontend-framework-kit.md) | | Game Architecture | On-chain state, economics | [game-architecture.md](game-architecture.md) | | Program/Anchor | On-chain game logic | [programs-anchor.md](../solana-dev/programs-anchor.md) | | Program/Pinocchio | High-perf programs | [programs-pinocchio.md](../solana-dev/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](../solana-dev/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](unity-sdk.md) - Solana.Unity-SDK integration patterns
• [csharp-patterns.md](csharp-patterns.md) - C# coding standards and patterns

Mobile

• [mobile.md](mobile.md) - Mobile Wallet Adapter, Expo, offline-first
• [react-native-patterns.md](react-native-patterns.md) - React Native patterns

Game Systems

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

Gaming Testing

• [testing.md](testing.md) - Unity Test Framework, Jest, React Native testing

Reference

• [resources.md](resources.md) - Curated links to SDKs and documentation

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

> These are provided by [solana-dev-skill](../solana-dev/SKILL.md) - install if not present

Web Frontend

• [frontend-framework-kit.md](../solana-dev/frontend-framework-kit.md) - React hooks, wallet connection
• [kit-web3-interop.md](../solana-dev/kit-web3-interop.md) - Kit ↔ web3.js boundary patterns

Program Development

• [programs-anchor.md](../solana-dev/programs-anchor.md) - Anchor framework patterns
• [programs-pinocchio.md](../solana-dev/programs-pinocchio.md) - Pinocchio high-performance programs
• [idl-codegen.md](../solana-dev/idl-codegen.md) - IDL generation and client codegen

Core Testing & Security

• [testing.md](../solana-dev/testing.md) - LiteSVM, Mollusk, Surfpool
• [security.md](../solana-dev/security.md) - Security checklist (programs + clients)
• [payments.md](../solana-dev/payments.md) - Core payment patterns
• [resources.md](../solana-dev/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 |

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: solanabr
• Source: solanabr/solana-game-skill
• License: MIT

Install and usage instructions live in the source repository linked above.