gamemantra.aigamemantra.ai|Developer Docs
Reference

Game Genres

Each game genre has a different economy, different player psychology, and different high-CVR moments. When you set your game's genre, the platform automatically loads the right event types and offer templates.

Genres are database-driven: The platform loads all available genres from the database at startup. New genres can be added by your platform team without code changes (migration 000035 removed all hardcoded genre constraints). You can also add custom event types for your specific game via the Live Ops dashboard.

All 16 Supported Genres

🧩

Puzzle

Candy Crush, Gardenscapes, Homescapes, Two Dots

puzzle
Economy type
Lives + Moves + Boosters
How to monetise
Near-miss offers when moves run low or lives depleted. Boosters between levels.
Top offer at a glance
Extra moves pack ($0.49–$0.99) at near-miss moment
Key trigger events
level_fail_near_missmove_count_lowlives_depletedlevel_completehard_level_fail
Best-performing segments
stucknever_purchasedactive
⚔️

RPG

Raid: Shadow Legends, AFK Arena, Dragon City, Marvel Contest

rpg
Economy type
Gold + Gems + Hero XP
How to monetise
Bundles before boss raids. Hero summon packs on collection milestones. Season passes.
Top offer at a glance
Boss Preparation Bundle ($4.99–$9.99) before major boss raids
Key trigger events
boss_raidguild_warhero_summonlevel_completeupgrade_blocked
Best-performing segments
payingwhalenever_purchased
🏰

Strategy

Clash of Clans, Rise of Kingdoms, Evony, Game of War

strategy
Economy type
Resources (Wood/Stone/Gold) + Troops
How to monetise
Speed-ups and resource packs when attack/defense blocked. Alliance event offers.
Top offer at a glance
Resource Boost Bundle ($3.99–$7.99) during resource_war event
Key trigger events
resource_waralliance_eventterritory_conquesttech_rushupgrade_blocked
Best-performing segments
payingwhalemid_game
🎪

Casual

Subway Surfers, Temple Run, Talking Tom, My Talking Angela

casual
Economy type
Coins + Energy + Stars
How to monetise
Daily streak savers. Power hour deals. First-purchase one-time offers.
Top offer at a glance
Daily Streak Saver ($0.49–$0.99) when streak is at risk at midnight
Key trigger events
daily_streak_at_riskenergy_emptystreak_bonusfirst_launchsession_start
Best-performing segments
never_purchasednewactive

Hyper-Casual

Flappy Bird-type, Ball Sort, Stack, Helix Jump

hyper_casual
Economy type
Score + Coins (very light)
How to monetise
Ad removal, cosmetics, score boosters. Very low prices ($0.49–$1.99). Ad-free is the top IAP.
Top offer at a glance
Ad-Free Pack or Score Booster ($0.49) after a high score run
Key trigger events
high_score_runcombo_chainspeedrun_eventdaily_missioncomeback_run
Best-performing segments
never_purchasednewbinge_session
🏙️

Simulation

Hay Day, Township, SimCity BuildIt, FarmVille

simulation
Economy type
Coins + Premium Currency + Building Materials
How to monetise
Expansion packs when city/farm grows. Seasonal festival events. VIP subscriptions.
Top offer at a glance
Expansion Bundle ($4.99–$9.99) when player's city/farm hits a size gate
Key trigger events
expansion_eventseasonal_festivalupgrade_blockedtrade_faircity_contest
Best-performing segments
payingmid_gamewhale

Sports

FIFA Mobile, NBA 2K Mobile, Dream League Soccer

sports
Economy type
Coins + Player Cards + Stamina
How to monetise
Transfer market packs. Championship season bundles. Player card upgrades.
Top offer at a glance
Championship Bundle ($7.99–$14.99) during season finale events
Key trigger events
championship_eventtransfer_marketrivalry_matchmvp_challengecup_run
Best-performing segments
payingwhalecompetitive
🎯

Shooter

PUBG Mobile, Free Fire, Call of Duty Mobile

shooter
Economy type
Coins + Ammo + Weapon Skins
How to monetise
Cosmetics and weapon bundles during ranked season. Comeback packs after deaths.
Top offer at a glance
Ranked Season Bundle ($9.99–$19.99) at start of new ranked season
Key trigger events
ranked_seasoneliminationweapon_eventclan_warteam_deathmatch
Best-performing segments
payingwhalenever_purchased
🥊

Action

Shadow Fight, Marvel Strike Force, MARVEL Future Fight

action
Economy type
Energy + XP + Power-ups
How to monetise
Boss fight preparation bundles. Combo streak booster packs. Weekly mission rewards.
Top offer at a glance
Combat Pack ($2.99–$4.99) before a major boss fight event
Key trigger events
boss_fightcombo_streakdaily_challengepvp_matchupgrade_blocked
Best-performing segments
payingstuckactive
🏎️

Racing

CSR Racing, Asphalt 9, Need for Speed Mobile

racing
Economy type
Coins + Car Parts + Premium Tokens
How to monetise
Car unlock packages. Season start bundles. Tournament entry packs.
Top offer at a glance
Season Start Bundle ($3.99–$7.99) at beginning of new racing season
Key trigger events
race_winseason_startnew_car_unlocktournament_entrypodium_finish
Best-performing segments
payingmid_gamenever_purchased
🎰

Casino

Zynga Poker, Slotomania, House of Fun, DoubleDown Casino

casino
Economy type
Chips + VIP Status + Coins
How to monetise
Daily bonus packs. VIP unlock bundles. Jackpot event participation packs.
Top offer at a glance
VIP Bundle ($9.99–$29.99) at winning_streak peak to lock in the momentum
Key trigger events
jackpot_eventvip_unlockdaily_bonuswinning_streakhigh_roller_invite
Best-performing segments
whalepayingbinge_session
⚙️

Idle / Clicker

Adventure Capitalist, Tap Titans, Idle Heroes, Merge Dragons

idle
Economy type
Production Rate + Prestige Multiplier + Offline Earnings
How to monetise
Speed-ups when production hits a bottleneck. Prestige boosters. Offline earnings multipliers.
Top offer at a glance
Production Booster ($0.99–$2.99) right when production bottleneck hits
Key trigger events
production_bottleneckprestige_readyoffline_earnings_peakedidle_milestoneupgrade_chain_complete
Best-performing segments
stuckmid_gamewhale
🔮

Merge

Merge Dragons, Merge Mansion, Merge Gardens, EverMerge

merge
Economy type
Board Slots + Energy + Rare Items
How to monetise
Board expansion when board fills. Inventory expansion packs. Rare item seeder bundles.
Top offer at a glance
Board Expansion Pack ($0.49–$1.99) immediately when board is full
Key trigger events
board_fullmerge_blockedrare_item_emergedinventory_overflowmerge_chain_complete
Best-performing segments
stucknever_purchasedactive
💎

Match-3

Candy Crush Saga, Bejeweled, Cookie Jam

match3
Economy type
Lives + Boosters + Extra Moves
How to monetise
Extra moves when moves run low. Booster refill packs. Lives bundles between sessions.
Top offer at a glance
5 Extra Moves ($0.49) when player is at 2 moves left — near-perfect clear moment
Key trigger events
move_count_lowhard_level_failbooster_depletednear_perfect_clearobstacle_blocking
Best-performing segments
stucknever_purchasedactive
🎖️

Battle Royale

PUBG Mobile (battle royale mode), Fortnite Mobile, Apex Legends Mobile

battle_royale
Economy type
Battle Credits + Cosmetics + XP
How to monetise
Cosmetics and seasonal skins. XP boosters during kill streaks. Season pass bundles.
Top offer at a glance
Season Pass Bundle ($9.99) at start of new season — highest recurring IAP for this genre
Key trigger events
kill_streakranked_placementloadout_lockedfinal_circlesquad_wipe
Best-performing segments
payingwhalecompetitive
🃏

Card / CCG

Hearthstone Mobile, Legends of Runeterra, Marvel SNAP

card_ccg
Economy type
Gold + Card Packs + Crafting Dust
How to monetise
Targeted card packs when deck is incomplete. Ranked entry during ranked decay. Meta packs after meta shifts.
Top offer at a glance
Deck Completion Kit ($9.99–$14.99) when player needs one specific card
Key trigger events
deck_incompleteranked_decaypack_openingcollection_milestonemeta_shift
Best-performing segments
whalepayingnever_purchased

Genre vs. subgenre

Neither Apple's App Store nor Google Play has a genre/subgenre hierarchy — both list flat categories, and neither even has "Shooter" as a category of its own (it's classified under Action on both). The genre/subgenre split below exists purely so a subgenre game automatically inherits its parent genre's FSR band, offer templates, and event types whenever it doesn't have its own — instead of silently falling back to the generic "Other" defaults.

Six subgenres are recognized today:

Match-3 and Merge — children of Puzzle

Battle Royale — child of Shooter

Hyper-Casual — child of Casual

Card / CCG — child of Strategy

Idle — child of Simulation

Pick the parent genre on step 1 of the game wizard, then (if one of the six above applies) pick the subgenre from the second dropdown that appears. Leave it blank if none applies.

What if my game is a hybrid?

Many games combine mechanics outside the genre/subgenre pairs above. If your game is primarily one genre, pick that. If it's a true hybrid, pick the genre that drives the most player decisions (usually the core loop).

Hybrid examples:

RPG + Match-3 (like Puzzle & Dragons): Pick rpg as the genre — the progression system drives the economy. Add match3 events as custom events (match3 is a subgenre of puzzle, not rpg, so it can't be selected alongside rpg).

Idle + Merge (like Merge Dragons): Pick simulation as the genre and idle or merge's parent (puzzle) as needed — whichever mechanic is the primary constraint. Add the other's events as custom events.

Casual + Strategy (like Clash Mini): Pick strategy if PvP drives play; pick casual if solo progression dominates.

You can also add custom event types in Live Ops → Event Types for mechanics unique to your game that don't appear in any genre list.

My genre isn't listed

All genres are stored in the database, not hardcoded. Your platform team can add a new genre by running a database migration — no code changes or service restarts needed.

-- To add a new genre, insert into genre_event_types:

INSERT INTO genre_event_types (genre, name, color, sort_order) VALUES

('tower_defense', 'wave_failed', '#ef4444', 1),

('tower_defense', 'base_hp_critical', '#dc2626', 2),

('tower_defense', 'special_wave_incoming', '#f97316', 3);

-- The genre 'tower_defense' is now available in game creation dropdown

-- No service restart needed — GenreRegistry reloads at startup

The genre dropdown in the Games wizard (Dashboard → Games → New Game) loads genres live from the database via GET /v1/platform/genres. It updates automatically after the migration.