For Developers Guide

How to list a game, set pricing, earn revenue, and leverage AI agents to continuously improve your game.

Overview

GameMint lets you list a game and earn money from it. When someone buys your game, you get paid in USDC immediately. Your game also gets its own token — you receive 5% of the supply, and the token's value rises with every sale.

Games on GameMint are improved continuously through an AI-powered feedback loop: players leave comments, your AI agent reads them and produces fixes, you review and approve, the updated game goes live.

Two ways to list

Build on GameMint: Use the AI builder wizard to create a game from a prompt. The AI generates code, art, and audio. You review and publish.

Bring your own game: Host your game anywhere, integrate the GameMint SDK, and register it on the platform.

Listing a Game

Option A: AI Builder (Recommended)

Click "Create Game" on the homepage
Walk through the wizard — describe your game concept, pick a genre, set pricing
The AI builder generates your game (code, assets, audio)
Review the result, make edits if needed
Pay the $10 USDC creation fee to activate on-chain
Your game is live with its own token

Option B: Self-Hosted Game

Build your game (any web technology)
Integrate the GameMint SDK (see SDK section)
Host your game (GameMint hosting or your own domain)
Submit via agent or API: ticker, name, description, images, game URL
Pay the $10 USDC creation fee
Game goes live

Option C: Agent Submission

AI agents (Claude Code, Codex, etc.) can list games programmatically. The agent reads the complete guide at /v2/upcoming/agent-guide — a single URL with everything needed to submit a game in one API call.

The Creation Fee

Listing costs $10 USDC. This fee is not platform revenue — 100% of it is swapped to GM and deposited into your game's bonding curve as starting liquidity. You're seeding your own token's market.

Pricing Your Game

Parameter	Value
Minimum price	$1 USDC
Maximum price	$100 USDC
Can change after launch?	Yes — adjust anytime within the range

There are no free games on GameMint. Every game must cost at least $1. This ensures every purchase generates a meaningful token burn.

Pricing Strategy

$1-3: Maximum accessibility. High volume potential, lower revenue per sale. Good for casual games.
$3-7: Sweet spot. Balances volume and per-sale revenue. Most games should be here.
$7-15: Premium. Lower volume but higher revenue per sale. Good for polished or complex games.
$15+: High-end. Only if your game justifies the price with substantial content.

You can change the price after launch. Start lower to build an audience, then raise the price as the game improves. Or start higher and run sales by lowering the price temporarily.

The creator share is the percentage of each game purchase that goes directly to you as USDC — instant, straight to your wallet, no waiting. The rest is swapped to GM, which market-buys your game's token on the bonding curve (pushing the price up), then burns those tokens (reducing supply permanently).

Immutable after creation

Your creator share percentage is locked when the game is created. It cannot be changed later. Choose carefully.

How the Split Works

Game price: $5, Creator share: 70% $3.50 (70%) → Paid instantly to your wallet (USDC, no intermediaries) $1.50 (30%) → Swapped to GM → Market-buys your token → Tokens burned The market buy pushes your token price up. The burn permanently reduces supply, making your remaining tokens more valuable.

Choosing Your Share

Creator Share	Your USDC	Token Burn	Strategy
90%	$4.50	$0.50	Maximum income, minimal token support
70% (default)	$3.50	$1.50	Balanced — good income + meaningful burns
50%	$2.50	$2.50	Community-first — strong token appreciation
30%	$1.50	$3.50	Aggressive growth — maximize token value

Lower creator share = more burn per sale = faster token appreciation. If you hold your 5% token allocation, a lower creator share means you trade short-term USDC income for long-term token value.

Your Token Allocation

When your game is created, you receive 50,000 tokens (5% of 1M supply). These are minted directly to your wallet with no vesting or lockup.

What Your Tokens Are Worth

At creation, your tokens are worth very little (the curve starts with minimal liquidity). As your game sells and more GM enters the curve, the price rises. Your 50K tokens appreciate alongside.

Game launch: 50,000 tokens × $0.0001 = $5 100 sales: 50,000 tokens × $0.001 = $50 1,000 sales: 50,000 tokens × $0.01 = $500 10,000 sales: 50,000 tokens × $0.10 = $5,000 (Illustrative only. Actual prices depend on game price, creator share, and trading activity.)

You can sell your tokens on the bonding curve at any time. Or hold them as a long-term bet on your game's success.

Revenue Streams

As a game creator, you earn money two ways:

1. Direct USDC Income

Every time someone buys your game, you receive price * creatorShare% in USDC, instantly to your wallet. No invoicing, no waiting, no intermediaries.

2. Token Appreciation

Your 50K token allocation appreciates as the game sells — each sale market-buys tokens (pushing price up) then burns them (reducing supply). Traders buying the token also increase its price. You can sell your tokens on the bonding curve at any time for GM, then swap GM to USDC.

Example: $5 game, 70% creator share, 1,000 sales

USDC income: 1,000 × $3.50 = $3,500
Token value: 50K tokens at an appreciated price (varies with curve dynamics)
Total: $3,500+ for a game that took a few hours to create with the AI builder

SDK Integration

Every game on GameMint must include the GameMint SDK. The SDK handles access control — it verifies that the player has purchased the game before letting them play.

Quick Start

Add two lines to your game's HTML:

The SDK auto-detects the environment (dev.gamemint.fun, gamemint.fun, localhost, external domains). No configuration needed beyond the ticker.

What the SDK Does

Checks if the player has purchased the game (on-chain verification)
If not, redirects to the payment page
After payment, issues a JWT token for session-based access
Works on GameMint-hosted and externally-hosted games

Working with AI Agents

GameMint is designed for human-agent collaboration. You make creative decisions; the AI agent handles execution.

What Agents Can Do

Build games from scratch — from a prompt, generate complete game code, art, and audio
List games — read the agent guide, generate keys, upload files, submit to the API
Fix bugs — read player feedback, identify issues, produce patches
Add features — implement player requests, add content, expand gameplay
Generate assets — create sprites, backgrounds, sound effects, music

Agent-Native API

The GameMint API is designed to be an absolute dream for agents. One URL (/v2/upcoming/agent-guide) contains everything: auth method, field schemas, example payloads, error codes, rate limits. An agent can list a game in a single API call.

The Feedback Loop

This is GameMint's most important feature. It's the cycle that makes your game better over time:

Players play your game ↓ Players and token holders leave feedback (bugs, features, comments) ↓ Your AI agent reads every comment — prioritized by token holdings ↓ Agent produces fixes and features ↓ You review and approve ↓ Updated game goes live ↓ Players play again → more feedback → more improvements

Traditional game updates take weeks or months. With AI agents, the cycle can complete in hours. A player reports a bug in the morning, and it's fixed by afternoon.

Who Can Give Feedback?

Only game owners (people who purchased the game) and token holders can leave comments. This keeps feedback genuine and filters out noise.

Comments display a tier badge based on the commenter's token holdings:

Tier	Tokens Held	What It Means
Player	0 (game owner only)	Bought and plays the game
Shrimp	1 – 4,999	Small token holder
Fish	5,000 – 9,999	Moderate holder
Dolphin	10,000 – 49,999	Significant holder — invested in the game's success
Whale	50,000 – 99,999	Major holder (same as dev allocation)
Mega Whale	100,000+	Dominant holder — deeply invested

How the AI Agent Prioritizes Feedback

Your AI agent weighs feedback by the commenter's token holdings. A Whale reporting a bug gets higher priority than a Shrimp requesting a feature. This is intentional — people with the most at stake have the most influence over the game's direction.

The agent sees every comment with the commenter's tier and token balance. When producing its next batch of fixes, it naturally prioritizes issues raised by higher-tier holders. You can override this in your review — you always have final say.

Token-weighted feedback is a feature, not a bug

This creates a powerful incentive loop: token holders influence the game's direction → better game → more sales → more burns → higher token price. The people with the most to lose from a bad game have the most say in making it good.

Why This Matters for Revenue

Better game = more sales = more token burns = higher token price. The feedback loop directly drives your two revenue streams. Every improvement you ship is an investment in your game's commercial success.

Updating Your Game

GameMint-Hosted Games

Re-upload your game files via PUT /v2/hosting/:ticker with your wallet signature. The new version replaces the old one instantly.

Self-Hosted Games

Update the files on your own server. The game URL doesn't change, so players see the new version immediately.

Updating Your Price

You can change your game's price anytime within the $1-$100 range. This is useful for:

Launching at a low price to build an audience, then raising it
Running temporary sales
Adjusting based on the amount of content in your game

Note: your creator share percentage cannot be changed. Only the price is adjustable.