Game Creation Guide

Mini Games Studio lets you create tokenized games that run in Farcaster. Understanding the constraints and token mechanics will help you build successful games that players love.

Game Constraints

Technical Limits

  • Duration: 0-60 seconds per game session (0 = unlimited)
  • Display: 400×750px mobile-optimized canvas
  • Scoring: 1-100 points maximum, increase 1 point at a time
  • Input: Mouse/tap only (no keyboard, swipes, or gestures)
  • Environment: Sandboxed iframe with no external dependencies
  • Performance: Use simple shapes and colors for best results

Creator Requirements

  • Farcaster Account: Valid account required for authentication
  • Neynar Score: Minimum score of 0.7 to create games

Token Economics

How Token Rewards Work

When you publish a game, you create a token with a reward pool. Players earn tokens based on their performance:

Token Formula

Tokens Earned = Player Score × Token Multiplier

Example: 25 points × 1,000 multiplier = 25,000 tokens

Configuration Options

Token Multiplier1x - 1,000,000x

Converts points to tokens

Premium Threshold1 - 10,000,000 tokens

Minimum tokens for premium rewards

Daily Play Limit1 - 100 games

Maximum games per player per day

Reward Pool Management

Each game gets its own reward pool wallet address. You can add more tokens to increase rewards:

  1. Launch your game to get a reward pool address
  2. Send additional tokens to this address to fund more rewards
  3. Players receive tokens directly from this pool when they play
  4. Monitor your pool balance in the Rewards dialog

Writing Effective Prompts

Essential Elements

1. Core Mechanics

Be specific about how players interact with your game.

Good: "Click falling circles to score points"
Bad: "Make it fun"

2. Scoring System

Define how points are earned and when the game ends.

Example: "1 point per successful click, game ends after 45 seconds"

3. Visual Style

Specify colors, themes, and visual effects.

Example: "Neon colors with particle effects on a dark background"

4. Difficulty Progression

Describe how the game gets more challenging over time.

Example: "Speed increases every 10 points, smaller targets after 20 points"

Example Prompts

✓ Excellent Prompt

"Create a bubble-popping game where colorful bubbles float up from the bottom. Players tap bubbles to pop them for 1 point each. Bubbles move faster every 15 points. Game lasts 45 seconds. Use pastel colors with smooth pop animations and gentle background music."

Includes mechanics, scoring, progression, duration, and style.

✗ Poor Prompt

"Make a platformer like Mario with levels and power-ups"

Too complex, requires keyboard, doesn't fit mobile format.

Development Workflow

  1. Create: Start with a clear prompt describing your game concept
  2. Test: Play your game in the preview window to check mechanics
  3. Iterate: Use chat to refine gameplay: "Make targets bigger" or "Add particle effects"
  4. Configure: Set up token rewards, multipliers, and game duration
  5. Launch: Publish your game with its token to start earning rewards
  6. Share: Post on Farcaster and watch players compete for tokens

Publishing & Sharing

Once your game is ready, you can launch it with a token:

Token Name & SymbolChoose memorable branding
Game ConfigurationSet duration, points, multipliers
Reward PoolGets unique wallet address
Farcaster IntegrationShare directly in feed

Your game will be playable directly in a Farcaster mini app, and players will automatically receive tokens based on their scores.