Game implementations for Keymaster's Keep maintained by eiron
- Universal Game Tester
- Include Option Standards
- Integration Guides
- Meta-Game Implementations
- Individual Game Implementations
- Work in Progress
- Recent Updates
The Universal Game Tester (located in UniversalGameTester/) is a comprehensive testing and analysis tool that works with ANY Keymaster's Keep game implementation.
- 🔍 Automatic Discovery: Scans directory for game implementation files
- 🎯 Universal Compatibility: Works with any game module and custom option types
- ⚖️ Authentic Simulation: Reproduces Keep's weighted objective selection system
- 📊 Comprehensive Analysis: Provides detailed metrics on objectives, weights, features
- 🎮 Interactive Testing: Menu-driven interface for testing individual games or full suites
# Test all discovered game implementations
cd UniversalGameTester
python universal_game_tester.py
# Test a specific game
python universal_game_tester.py stardew_valley_game.py
# Test with shortened filename
python universal_game_tester.py hadesAll game implementations follow a standardized approach for include Toggle options:
- Basic Content: Fundamental options default to
Truefor comprehensive objective generation - Specialized/Harder Content: Speedruns, difficulty challenges default to
False - Cursed/Tedious Modules: Games like "Cursed Red Dead Redemption 2" default to
True(players deliberately opt-in)
Generate objectives from your Playnite games database.
Requirements:
- Export database using Json Library Import Export add-on
- Set path in KMK YAML:
playnite_library_json_path: C:/path/to/games.json
Generate objectives from your Steam library via API.
Requirements:
- Get API key: https://steamcommunity.com/dev/apikey
- Set environment variable
STEAM_API_KEY - Configure Steam ID in YAML options
Real-world location-based exploration via Geoapify API.
Requirements: See ARCHIPELOCAL_SETUP.md for detailed instructions.
File: adventure_experience.py
Transform real-world adventure backlog into objectives.
Categories: Local Exploration, Cultural Experiences, Outdoor Activities, Culinary Adventures
Sample: "VISIT Downtown District", "ATTEMPT Rock Climbing", "TRY International Restaurant"
File: archipelago_multiworld_randomizer_game_with_multiplayer.py
Create objectives for participating in Archipelago multiworld sessions.
Categories: Multiworld Participation, Item Progression, Helper Activities, Community Engagement
Sample: "Complete your sphere 1 progression items", "Send 10 useful items to other players"
File: archipelocal_game.py
Real-world exploration using Geoapify Places API. Powered by Geoapify
Categories: Food & Drink, Leisure & Tourism, Entertainment & Culture, Natural & Man-Made Sights, Shopping, Services
Sample: "Visit Starbucks @ 40.78509, -73.96829 – 0.42 km • Cafe", "Visit your 3rd-closest Park near your home"
Features: Live place suggestions, lazy loading, flexible strategies, customizable distances, privacy-friendly
File: archipelagourmet_game.py
Recipes, restaurants, and random ingredient cooking challenges.
Categories: Recipes, Restaurants, Random Ingredient Challenges
Sample: "Make [Recipe Name]", "Make a meal using each of the following ingredients: {3-5 random ingredients}"
Features: Dietary filtering, ingredient blacklist, customizable ingredient pool (1-10)
File: board_game_collection.py
Physical board game exploration and mastery.
Categories: Strategy Games, Party Games, Solo Gaming, Learning New Games, Game Night Hosting
Sample: "Learn and play 3 new games from your collection", "Host a game night with 4+ different games"
File: chapter_quest_game.py | Docs: CHAPTER_QUEST.md
Transform reading list into gaming objectives with chapter-specific goals.
Categories: Individual Chapters, Book Completion, Genre Challenges, Author Challenges
Sample: "[Fantasy Fiction] The Hobbit by J.R.R. Tolkien -> Read chapter 7", "Genre Challenge: Read 2 chapters from a Science Fiction book"
Features: Book configuration, meta-challenges, difficulty scaling, smart generation
File: chart_attack_game.py
Follow ranked charts (music, books, films, games, etc.) and pick specific positions.
Sample: "Follow Billboard Hot 100 #7", "Read Goodreads Fantasy #42"
Features: Custom charts/verbs, position ranges, weighted selection, chart weighting
File: christmas_holiday_challenges.py
Holiday activities from your seasonal backlog.
Categories: Decorations, Gifts, Baking, Traditions
Sample: "SET UP Christmas Tree", "MAKE Handmade Gift", "CREATE Gingerbread House"
File: creative_challenges.py
Art projects, writing, photography, crafts from your creative backlog.
Categories: Art Projects, Writing, Photography, Crafts
Sample: "CREATE Watercolor Painting", "WRITE Short Story", "CAPTURE Portrait Session"
File: custom_categories_game.py | Docs: CUSTOM_CATEGORIES.md
Fully customizable categories with weighted sub-tasks for personal goals.
Sample: "[Fitness & Health] Complete a 30-minute workout", "[Learning & Skills] Complete 3 tasks"
Features: Category weight (0-100+), task weight (0-100+), task properties (difficult, time_consuming), 8 default categories
File: keymasters_keep.py
Ultimate meta module for generating Keymaster's Keep challenges to play within Keep!
Game Modes: Keymaster's Challenge, Magic Key Heist
Sample: "Complete a Keymaster's Challenge including the games: Celeste, Hollow Knight, and Slay the Spire"
Features: Customizable game pool (120+ games default), challenge type selection, game count range (1-10)
File: music_listening.py
Albums, artists, and playlists from your music backlog.
Categories: Albums, Artists, Playlists
Sample: "LISTEN TO Album Title", "EXPLORE Artist Name", "COMPLETE Playlist Name"
File: physical_health_challenges.py
Exercise, wellness, nutrition, movement from your fitness backlog.
Categories: Exercise, Wellness, Nutrition, Movement
Sample: "COMPLETE Push-up Challenge", "MAINTAIN Sleep Schedule", "TRY Healthy Recipe"
File: playnite_library.py
Generate objectives from your Playnite games database.
Features: All Playnite metadata support (tags, genres, features, platforms, categories, sources, series, scores, playtime), multiple ordering options
Requirements: See Integration Guides
File: real_world_scavenger_hunt_game.py
Comprehensive real-world exploration encouraging outdoor discovery and community engagement.
Categories: Photography, Location Hunting, Object Collection, Interaction, Nature, Cultural Discovery, Seasonal Activities, Community Engagement
Sample: "Take a photo of A street musician", "Find and visit A hidden garden", "Collect 10 different Interesting rocks"
Features: 500+ objectives, difficulty levels, travel scope options, constraints (transportation, time, weather)
File: really_boring_challenges_game.py
Deliberately mundane everyday routine activities gamified.
Categories: Household Maintenance, Personal Organization, Digital Housekeeping, Routine Optimization, Administrative Tasks
Sample: "Organize 50 digital files", "Clean one room thoroughly", "Update 3 different passwords"
File: social_connections.py
Friend meetups, family activities, community events, networking from your social backlog.
Categories: Friend Meetups, Family Activities, Community Events, Networking
Sample: "ARRANGE Coffee Meetup with Best Friend", "VISIT Family Dinner with Family Member"
Features: Customizable people lists (friends, family, colleagues)
File: steam_achievements_game.py
Generate objectives from your Steam library and achievement progress via API.
Categories: Game Completion, Progress Goals, Mastery
Sample: "Beat Elden Ring", "Unlock at least 25% of the achievements in Hollow Knight"
Features: Automatic library fetching, playtime filtering, smart filtering, exclusions, percentage ranges
Requirements: See Integration Guides
File: watchlist.py
Films and TV shows from your watchlist.
Categories: Films, TV Shows
Sample: "WATCH Film Title", "BINGE TV Series Title"
Alphabetically organized game-specific implementations.
File: alina_of_the_arena_game.py
Roguelike deck-building combat game with branching arenas, multiple classes, and difficulty-based progression.
Categories: Class Runs, Challenge Objectives, Hardcore Difficulty
Sample: "Win a run", "Deal 300+ damage in a single attack"
Features: 8 playable classes (Slave, Warrior, Mercenary, Bandit, Hunter, Pyromancer, Samurai, Deprived), hardcore mode toggle, configurable objective groups
File: american_truck_simulator_game.py
Trucking simulation covering deliveries, exploration, business management across USA.
Categories: Interstate Delivery, State Exploration, Truck Ownership, Long Haul, Heavy Haul, Business Objectives, DLC Content
Sample: "Transport Electronics from Los Angeles to Phoenix", "Complete deliveries to 3 different cities in Nevada"
Features: Comprehensive DLC support (California to Missouri), specialized hauling, business management, realistic constraints
File: animal_crossing_new_horizons_game.py
Island life simulation focusing on development, social interaction, decoration, seasonal activities.
Categories: Island Development, Social Interaction, Decoration & Design, Collection & Catalog, Seasonal Events
Sample: "Develop 5 different Residential Areas", "Achieve Best Friends relationship with 3 villagers"
File: apex_legends_game.py
Battle royale team-based shooter with character abilities, weapon loadout management, and legend-specific challenges.
Categories: Match Wins, Legend Challenges, Weapon Restrictions
Sample: "Win a Battle Royale match", "Deal 1000 Damage in a single match"
Features: 25+ playable legends, 5 legend classes (Assault, Skirmisher, Recon, Support, Controller), weapon type restrictions, finisher challenges
File: astronarch_game.py
Tactical roguelike party-based dungeon crawler with ascension difficulty levels and hero recruitment.
Categories: Run Completion, Ascension Levels, Hero Composition
Sample: "Win a run", "Defeat the final boss"
Features: Ascension scaling (5+, 10+, 20), 4 hero classes (Warrior, Rogue, Mage, Support), 16+ unique heroes, shop interaction modifiers
File: atomicrops_game.py
Agricultural roguelike with seasonal progression, character-specific runs, and boss encounters.
Categories: Character Runs, Year Progression, Boss Encounters
Sample: "Win a run as Lavender", "Defeat the Corpse-a-Copia (Nuclear Winter Boss)"
Features: 6 playable characters (Lavender, Rye, Robusta, Thyme, Dandelion, Crow), year difficulty scaling, biome tiers, marriage system
File: baba_is_you_game.py
Rule-manipulating puzzle game where objects defining level rules can be physically rearranged.
Categories: Level Completion, World Progression, Transformations, Custom Levels
Sample: "Complete 3 levels", "Complete a level by reaching the FLAG"
Features: 12 worlds (Lake, Island, Temple, Forest, Cavern, etc.), 6 playable characters with transformations, 20+ custom level codes, undo/restart restrictions
File: backpack_hero_game.py
Inventory management roguelike where backpack organization and item synergy determines combat effectiveness.
Categories: Character Runs, Challenge Objectives
Sample: "Win a run (Defeat the Grandmaster) as Purse", "Defeat a Boss without taking damage"
Features: 5 characters (Purse, Satchel, Tote, CR-8, Pochette), Hard Mode, inventory manipulation constraints
File: baldurs_gate_3_game.py
Deep RPG covering character builds, story choices, companion relationships, tactical combat.
Categories: Character Builds, Story Progression, Companion Quests, Exploration, Combat Challenges, Social Encounters
Sample: "Complete Act 1 with a Paladin/Warlock multiclass build", "Achieve Romance relationship with Shadowheart"
File: beyond_the_long_night_game.py
Survival roguelike with NPC rescue quests and vertical storm layer exploration.
Categories: Run Completion, NPC Rescue, Challenges, Upgrades, Hats
Sample: "Win a run (Reach the surface)", "Reach Layer 3 of the Storm"
Features: NPC rescue system with quest chains, meta upgrades, hat equipment objectives, storm modifier constraints, speedrun challenges
File: bloodstained_ritual_of_the_night_game.py
Comprehensive Metroidvania covering shard collection, exploration, boss battles, alchemy.
Categories: Shard Collection, Exploration, Boss Challenges, Alchemy & Crafting, Equipment Mastery, Speedrun Challenges
Sample: "Collect 20 Conjure shards", "Reach 90% map completion", "Defeat Bloodless without using healing items"
File: bloons_td_6_game.py
Tower defense strategy with monkey tower types, upgrade paths, and extensive constraint-based challenges.
Categories: Beginner/Intermediate/Advanced/Expert Levels, Difficulty Modes, Tower Restrictions
Sample: "Complete a level on Normal Mode without using PRIMARY, MILITARY, MAGIC, SUPPORT", "Beat a level on Hard Mode using only one monkey type"
Features: Tower type restrictions, hero disabling, tier 5 upgrade restrictions, Monkey Knowledge disabling, single-tower-type runs
File: bpm_bullets_per_minute_game.py
Rhythm-based roguelike where combat actions must be synced to the music beat.
Categories: Difficulty Runs, Character Runs, Boss Encounters, Dungeon Levels
Sample: "Complete a run on Hard as a character", "Complete multiple rooms without taking damage"
Features: Rhythm timing mechanics, multiple difficulty tiers (Easy/Medium/Hard/Hellish), boss encounter variations, equipment restrictions, shop constraints
File: brotato_game.py
Arena wave-based roguelite focused on weapon builds, character diversity, scaling economy.
Categories: Character Unlocks, Weapon Synergy Runs, Wave Survival, Boss & Elite Clears, Economic Scaling, Danger Levels
Sample: "Clear Danger Level 5 with Ghost character", "Reach 200% attack speed before wave 15"
Features: Build diversity, difficulty scaling, resource economy, character progression, optional constraints
File: brutal_orchestra_game.py
Tactical turn-based combat game with procedural party composition and difficulty modifiers.
Categories: Boss Defeats, Party Challenges, Battle Challenges, Zone Completion, Difficulty Runs
Sample: "Defeat a boss", "Complete a run with a specific party member"
Features: Difficulty modes (Normal, Hard, Hellmode), party size variations, combat restrictions (no items, no healing), boss-specific win conditions
File: caves_of_qud_game.py
Science-fantasy roguelike capturing mutation-driven exploration, faction dynamics, emergent survival.
Categories: Mutation Acquisition, Exploration & Biomes, Faction Reputation, Artifact Identification, Survival Milestones, Legend Hunts
Sample: "Acquire 4 new mutations without visiting a Grit Gate vendor", "Reach reputation Trusted with the Mechanimists"
Features: Mutation depth, faction systems, biome exploration, artifact mastery, survival challenges, legendary hunts
File: chess_com_game.py
Competitive chess objectives from live, rapid, blitz, bullet, puzzle, thematic training activities.
Categories: Rating Milestones, Time Control Diversity, Opening Exploration, Puzzle Streaks, Accuracy Goals, Win Condition Variety
Sample: "Achieve 5-day puzzle streak", "Reach 1450 Blitz rating", "Play 10 rapid games using the French Defense as Black"
Features: Multi time control targets, opening coverage, puzzle/tactics, accuracy metrics, improvement tracking
File: circadian_dice_game.py
Dice-building roguelike emphasizing scenario strategy, face crafting, relic combinations.
Categories: Scenario Clears, Class Mastery, Relic Unlocks, High Score Targets, Status/Combo Challenges, Perfect/Efficient Turns
Sample: "Clear Forest scenario with Alchemist at 3+ relics", "Reach 25,000 score in Temple run"
Features: Scenario variety, class progression, dice engineering, scoring milestones, efficiency challenges
File: cook_serve_delicious_2_game.py
Time management cooking game with two distinct gameplay modes and progressive difficulty.
Categories: CSD Mode, Chef for Hire Mode
Sample: "Get a Perfect Day in a shift", "Get a Perfect Day in Cook Serve Delicious in Stress mode"
Features: Yum level progression (0-100), Stress vs Normal modes, 33+ restaurants with shift progression, configurable entree/side/drink counts
File: crypt_of_the_necrodancer_game.py
Rhythm-based roguelike spanning zone clears, character completion, boss mastery, DLC expansions.
Categories: Zone Progression, Character Victories, Boss Defeats, Rhythm/Cadence Challenges, Item/Shop Interaction, Mode Variants, DLC Content
Sample: "Clear Zone 4 with Cadence without missing a beat", "Defeat Dead Ringer using only shovel damage (Monk)"
Features: DLC toggles (Amplified, Synchrony, Hatsune Miku, Shovel Knight), character depth, rhythm mastery, boss variants
File: cult_of_the_lamb_game.py
Unique cult management and action covering cult building, follower management, combat crusades.
Categories: Cult Management, Combat & Crusades, Follower Care, Base Building, Resource Collection, Ritual Performance
Sample: "Recruit 15 new cult followers", "Defeat Leshy in combat", "Perform 5 different Blessing rituals"
File: cuphead_game.py
2D bullet-hell boss rush platformer with weapon customization and charm power-ups.
Categories: Base Game Bosses, DLC Bosses
Sample: "Beat a boss with specific weapons, charm, and super", "Beat a DLC boss with a charm equipped"
Features: DLC support (The Delicious Last Course with 5 additional bosses), 9 weapon types, 8 charm power-ups, air/ground boss variants, Expert Mode constraints
File: cursed_red_dead_redemption_2_game.py
Deliberately chaotic and humorous take on Wild West epic with absurd objectives.
Categories: Absurd Combat, Ridiculous Exploration, Chaotic Social Interactions, Silly Customization, Nonsense Activities
Sample: "Kill 50 enemies using only throwing knives while wearing a fancy hat", "Ride your horse backwards for 10 minutes straight"
File: danganronpa_decadence_game.py
Visual novel murder mystery collection. Supports all four games in Decadence collection with per-game separation.
Supported Games: Trigger Happy Havoc (+ School Mode), Goodbye Despair (+ Island Mode, Magical Girl Monomi), V3: Killing Harmony (+ Death Road of Despair, Love Across the Universe, Casino), Ultimate Summer Camp (Development Mode, Tower of Despair)
Categories: Investigations, class trials, free time, report cards, skills, presents, collectibles (Hidden Monokumas), bonus modes
Sample: "Achieve S rank in the Chapter 3 Class Trial (DR1)", "Max out friendship with Kyoko Kirigiri (DR1)", "Clear floor 100 in Tower of Despair (DRS)"
File: date_everything_game.py
Whimsical dating simulation romancing household objects and abstract concepts with 100+ voice-acted characters.
Categories: Structural Objects, Furniture & Decor, Kitchen Appliances, Bathroom Items, Laundry Items, Office & Bedroom, Miscellaneous, Special Concepts, DLC
Sample: "Achieve LOVE with Rebel (Rubber Duck)", "Get 5 structural elements to FRIENDS status"
File: dead_cells_game.py
Challenging metroidvania focused on combat mastery, weapon experimentation, biome progression.
Categories: Combat Mastery, Weapon Experimentation, Biome Progression, Mutation Builds, Speed Running
Sample: "Defeat 25 different Elite enemies", "Complete a run using only Survival weapons", "Reach 3BC difficulty level"
File: dead_estate_game.py
Roguelike survival horror with character selection and multiple ending paths.
Categories: Character Runs, Ending Objectives, Challenge Objectives
Sample: "Complete the normal ending (Exit Realm) as a character", "Obtain the true ending (defeat Diavola)"
Features: Character selection toggle, challenge objectives toggle
File: death_road_to_canada_game.py
Zombie survival road trip with party mechanics, character selection methods, and difficulty modes.
Categories: Survival Runs, Party Composition, Difficulty Modes
Sample: "Reach Canada in Standard Mode with your choice of character", "Reach Canada solo"
Features: Party size range configuration, multiple character selection methods (player choice/random/KMK assigned), difficulty modes
File: despots_game.py
Entity management roguelike with Campaign, Endless, and King of the Hill game modes.
Categories: Campaign, Endless, King of the Hill, Challenge Modifiers
Sample: "Beat the campaign with a build theme focus", "Win an Endless run with a preset active"
Features: Campaign/Endless/King of the Hill mode toggles, challenge modifiers toggle
File: dicey_dungeons_game.py
Tactical deck-building dungeon crawler with six playable characters and chapter progression.
Categories: Character Runs, Chapter Progression, Special Events
Sample: "Complete a chapter as a character", "Win a run as a character"
Features: Six characters with multiple chapters each, Tennis mod support toggle, Halloween event
File: dungreed_game.py
Roguelike dungeon crawler with weapon diversity, boss encounters, and trial-based challenges.
Categories: Difficulty Objectives, Weapon Objectives, Boss Objectives, Character Objectives, Trial Objectives
Sample: "Complete a full dungeon run as a character", "Defeat Ericha (Final Boss)"
Features: Configurable objective group toggles (difficulty, weapon, boss, character, trial)
File: euro_truck_simulator_2_game.py
Trucking simulation covering deliveries, exploration, business management across Europe.
Categories: Delivery Objectives, Country Exploration, Truck Ownership, Long Distance, Special Transport, Business Objectives, DLC Content
Sample: "Deliver Medical Supplies from Berlin to Paris", "Complete the challenging 1800km route from London to Rome"
Features: Comprehensive DLC support (Going East! to Greece), specialized hauling, business management, skill challenges
File: forward_escape_the_fold_game.py
Roguelike action game with Classic, Expert, and Journey difficulty modes.
Categories: Resource Challenges, Challenge Modes, Playstyle Constraints, Achievement Objectives
Sample: "Complete a full run in Classic mode as a character", "Complete a full run in Expert mode"
Features: Resource challenges/challenge modes/playstyle constraints/achievement objective toggles
File: hades_game.py
Roguelike action covering escape attempts, weapon mastery, relationship building, Zagreus's journey.
Categories: Escape Attempts, Weapon Mastery, Relationship Building, Boon Collection, House Upgrades, Narrative Progress, Challenge Runs
Sample: "Complete 5 successful escape attempts", "Master the Stygian Blade weapon", "Max out relationship with Megaera"
File: harvestella_game.py
Farming RPG bringing full breadth of farming, exploration, combat, relationships, story, crafting, seasonal systems.
Categories: Farming Objectives, Exploration & Adventure, Combat Challenges, Relationship System, Story Progression, Crafting & Cooking, Seasonal & Collection
Sample: "Harvest 50 crops across all seasons", "Defeat 10 unique monsters in Quietus dungeons", "Complete Chapter 5"
Features: Dynamic crop/farming, exploration/dungeons, combat/jobs, relationships, story progression, crafting, collections
File: inscryption_game.py
Deck-building card game with campaign acts, card collection objectives, and Kaycee's Mod roguelike mode.
Categories: Campaign Acts, Card Objectives, Kaycee's Mod
Sample: "Complete Act I: Defeat Leshy in his cabin", "Complete Act III: Defeat P03 and all Uberbots in the factory"
Features: Campaign mode toggle, card objectives toggle, Kaycee's Mod with ascension levels and challenge modifiers
File: into_the_breach_game.py
Turn-based tactical mech game with squad-based combat, pilots, and island liberation.
Categories: Squad Runs, Pilot Objectives, Island Objectives, Achievement Objectives, Difficulty Objectives
Sample: "Win a run with a squad", "Liberate an island"
Features: Squad/pilot/island/achievement/difficulty toggles, Advanced Edition support toggle, difficulty preference setting
File: just_dance_game.py
Comprehensive rhythm gaming covering entire Just Dance franchise 2014-2025.
Game Coverage: Just Dance 2014-2025, Just Dance Unlimited, Just Dance+, Regional Exclusives
Categories: Base Game Completion, Subscription Service Mastery, Regional Content Exploration, Score Achievement
Sample: "Perfect 25 songs from Just Dance 2023 base tracklist", "Complete 15 dances from Just Dance Unlimited"
Features: Comprehensive song libraries, accurate track lists, regional exclusives, subscription services, granular customization
File: just_king_game.py
Tactical unit-based battler with army synergy systems and ranked challenge progression.
Categories: Campaign, Army Objectives, Challenge Objectives
Sample: "Complete a zone", "Complete a level"
Features: Campaign/army/challenge objective toggles, unit unlock and upgrade tracking, ranked progression
File: minecraft_game.py
Expansive sandbox covering building projects, exploration, resource gathering, redstone, farming, combat.
Categories: Building Projects, Exploration & Adventure, Resource Gathering, Redstone Engineering, Farming & Automation, Combat Challenges
Sample: "Build a 50x50 Castle structure", "Explore 10 different Ocean Monuments", "Create an automated Crop farm"
File: monster_roadtrip_game.py
Road trip adventure with resource management, character recruitment, and multiple destination endings.
Categories: Endings, Resource Goals, Challenge Runs
Sample: "Win a run reaching a destination", "Win a run on a higher difficulty reaching a destination"
Features: Endings/resource goals/challenge run toggles, multiple difficulty presets, secret hitchhiker recruitment
File: neophyte_game.py
Action roguelike dungeon crawler with spell loadouts and escalating challenge levels.
Categories: Difficulty Objectives, Loadout Objectives, Challenge Levels
Sample: "Complete a full run", "Defeat the final boss"
Features: Difficulty/loadout toggles, 5 challenge levels, spell rarity system, run condition modifiers
File: one_step_from_eden_game.py
Roguelike deck-building action game with spell combos and multiple routes to Eden.
Categories: Character Runs, Routes, Deck Builds, Boss Objectives
Sample: "Reach Eden on a route with a character", "Win a run using a specific deck as a character"
Features: Boss/pacifist/flawless objective toggles, character selection set
File: pawnbarian_game.py
Chess-themed deck-building roguelike with dungeon progression and escalating chain challenges.
Categories: Character Runs, Dungeon Clears, Chain Levels, Floor Counts
Sample: "Win a dungeon with a character", "Reach a target number of floors cleared"
Features: Character runs toggle, chain challenges toggle
File: revita_game.py
Roguelike action platformer with area progression, relics, curses, and shard difficulty modifiers.
Categories: Area Progress, Boss Clears, Variants, Shard Difficulty, Relics, Curses
Sample: "Reach an area", "Defeat a boss"
Features: Area progress/boss clears/shard difficulty toggles, 40+ shard difficulty combinations
File: rocksmith_2014_game.py
Music learning game for guitar with song playback, DLC packs, and multiple game modes.
Categories: Songs, Arrangements, Techniques, Lessons, Game Modes, Mastery Levels
Sample: "Play a song on an arrangement", "Reach a mastery percentage on a song"
Features: DLC pack selection, custom song overrides, RS1 import songs, Score Attack/Lessons/Session Mode/Guitarcade/Missions toggles, CDLC support
File: spelunky_game.py
Roguelike platformer with biome progression, optional hell route, and eggplant run challenges.
Categories: Biome Runs, Character Runs, Hell Route, Eggplant Runs, No Gold Runs
Sample: "Complete successful runs by defeating Olmec", "Defeat Olmec while playing as a specific character"
Features: Hell/eggplant/no-gold objective toggles, biome and character selection, configurable run count
File: spelunky_2_game.py
Roguelike platformer sequel with expanded content including Sunken City, Cosmic Ocean, and challenge routes.
Categories: Biome Runs, Character Runs, Sunken City, Cosmic Ocean, Eggplant Runs, No Gold Runs
Sample: "Complete successful runs by defeating Tiamat", "Reach the Sunken City and defeat Hundun"
Features: Sunken City/Cosmic Ocean/eggplant/no-gold toggles, biome and character selection, configurable run count
File: stardew_valley_game.py
Comprehensive farming simulation covering all aspects of Pelican Town life.
Categories: Farm Management, Relationship Building, Exploration & Combat, Crafting & Collection, Seasonal Activities, Community Goals
Sample: "Earn 50000g through Crop sales", "Reach 8 hearts relationship level with Abigail", "Complete 15 different Community Center bundles"
File: super_dungeon_maker_game.py
Dungeon creation and completion game with themed levels, boss fights, and community challenges.
Categories: Themed Dungeons, Boss Fights, Golden/Silver Eggs, Puzzles, Combat, Community Content
Sample: "Collect the golden egg from a themed dungeon", "Defeat a boss in a themed dungeon"
Features: Theme and boss selection, difficulty preference, 15+ community dungeon challenges
File: the_binding_of_isaac_rebirth_game_plus_unlock_conditions.py
Massive roguelike covering extensive content of Rebirth and DLCs (Afterbirth, Afterbirth+, Repentance).
Categories: Character Victories, Boss Defeats, Challenge Runs, Item Collection, Transformations, Specific Achievements, Modded Characters
Sample: "Defeat The Lamb as The Lost", "Complete Challenge #34 (Ultra Hard)"
Features: Full DLC support (auto-adjusts), all 34 characters including Tainted, deep integration, hardcore constraints, modded character support via OptionSet
File: the_binding_of_isaac_wrath_of_the_lamb_game.py
Module for original Flash game covering base game, Wrath of the Lamb expansion, Eternal Edition.
Categories: Character Victories, Boss Defeats, Challenge Runs, Eternal Edition Challenges
Sample: "Defeat Satan as Judas", "Complete Challenge #6 (The Doctors Revenge!)", "Defeat Mom in Hard Mode (Eternal Edition)"
Features: Classic content, expansion toggles (WotL, Eternal Edition), Eternal challenges, character & boss tracking
File: the_sims_4_game.py
Comprehensive life simulation covering all aspects of Sim life across base game and expansions.
Categories: Skill Mastery, Career Progression, Relationship Building, Aspiration Completion, Creative Building, Emotional Challenges, Collection Goals, Life Events, Expansion Content
Sample: "Master the Painting skill to level 10", "Build a SOULMATE relationship with another Sim", "Experience the MORTIFIED emotion"
Features: Comprehensive coverage of skills, careers, aspirations, collections, emotions from base game + DLC, auto-adapts based on content
File: void_rains_upon_her_heart_game.py
Bullet-heaven roguelike with multiple heart characters, game modes, and boss encounters.
Categories: Heart Runs, Boss Challenges, Game Modes, Difficulty Levels, Motes, Medals
Sample: "Defeat a set of bosses", "Win a Story run on a difficulty as a heart character"
Features: Hearts/modes/boss challenges/difficult challenges toggles, Story/Quickplay/Endless Nightmare modes
File: wario_ware_get_it_together_game.py
Microgame party game with story campaign, variety pack co-op/versus modes, and Wario Cup competition.
Categories: Story Stages, Microgames, Characters/Crews, Variety Pack, Wario Cup
Sample: "Play a story stage with specific characters and earn a target score", "Win consecutive microgames in a variety mode"
Features: Story progress/variety pack/Wario Cup toggles
File: wikipedia_game.py
Web-based article-hopping challenge with difficulty tiers and click limit progression.
Categories: Article Paths, Difficulty Tiers, Click Limits, Random Challenges
Sample: "Connect articles in order within a click limit", "Find a path between 3 articles in a generous number of clicks"
Features: Difficulty selection (Easy/Standard/Hard/Expert), trending/featured/popular article pack toggles, random path toggle, configurable click thresholds
File: wipeout_hd_fury_game.py
Futuristic anti-gravity racing with speed classes, team ships, and multiple competitive modes.
Categories: Tracks, Speed Classes, Teams, Race Modes, Zone Challenges, Time Trials
Sample: "Win races on a track", "Reach a target zone number on a track"
Features: Team and speed class selection, zone/eliminator/weapon challenge toggles, multiple constraint toggles (weapons, shields, autopilot, assists)
Games currently under development in the WIP/ directory.
Directory: WIP/The Ranch of Rivershine/
Cozy horse ranch simulation — care for horses, train skills, compete in events, breed foals, farm crops, and explore Rivershine.
Categories: Horse Training, Horse Care, Competitions, Breeding, Exploration, Farming, Wild Horses, Social, Crafting, Riding Arena, Ranch Upgrades
March 2026:
- README cleanup: removed deployment-only entries not present in this repo, added 5 missing game entries (Dungreed, Forward: Escape the Fold, Into the Breach, Rocksmith 2014, Spelunky 2)
- Added file reference for Cook, Serve, Delicious! 2!!
- Removed broken file references (Against the Storm, Awaria — files not in this repo)
- Added Work in Progress section (The Ranch of Rivershine)
January 2026:
- README reorganized with table of contents, alphabetized game lists, clearer sections
- All game files mapped to implementations for easier navigation
November 2025:
New Modules:
- Brotato: Arena roguelite with character unlocks, weapon synergy, danger levels
- Circadian Dice: Dice-building roguelike with scenario clears, class mastery, relic unlocks
- Crypt of the NecroDancer: Rhythm roguelike with zone progression, DLC content (Amplified, Synchrony, Hatsune Miku, Shovel Knight)
- Chess.com Integration: Competitive chess with puzzle streaks, rating milestones, accuracy goals
- Caves of Qud: Science-fantasy roguelike with mutation acquisition, faction reputation, survival milestones
Systemic Improvements:
- Binding of Isaac Modded Characters: Added OptionSet for user-defined modded characters
- Toggle Standardization: Converted older DefaultOnToggle to consistent Toggle patterns
- Constraint Reclassification: Caves of Qud limb dismemberment moved to optional constraint
Benefits: Improved extensibility (user-supplied characters), clarity (uniform toggle access), accuracy (constraint vs objective classification)