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
Converts points to tokens
Minimum tokens for premium rewards
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:
- Launch your game to get a reward pool address
- Send additional tokens to this address to fund more rewards
- Players receive tokens directly from this pool when they play
- 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
- Create: Start with a clear prompt describing your game concept
- Test: Play your game in the preview window to check mechanics
- Iterate: Use chat to refine gameplay: "Make targets bigger" or "Add particle effects"
- Configure: Set up token rewards, multipliers, and game duration
- Launch: Publish your game with its token to start earning rewards
- Share: Post on Farcaster and watch players compete for tokens
Publishing & Sharing
Once your game is ready, you can launch it with a token:
Your game will be playable directly in a Farcaster mini app, and players will automatically receive tokens based on their scores.