asti-z/ai-game-framework

ai-game-framework, called arcade in its own README, is a small Python framework for building text based simulator games meant to be played by AI agents rather than humans. Instead of building one game, it acts as a lobby that lets several separate text games share things like gold, energy, and trophies, while routing whatever the player types to whichever game is currently active. To plug a game into arcade, you drop a folder into a games directory containing just two files: a manifest.json describing the game's name, icon, and how much energy each action costs, and an engine.py file that exposes a single cmd(text) function which takes a text command and returns a text response. There is no base class to inherit and nothing else to register, arcade discovers games automatically from that folder structure. The lobby itself handles a handful of commands, like listing installed games, switching between them, checking your overall status, and viewing or editing configuration values such as energy costs and starting gold. Energy is spent per action according to each game's settings, regenerates slowly over time, and some commands can be marked free. Trophies can be defined per game or shared across all games, with support for trophies that have multiple levels. The author is direct about the project's current state: it is an early experimental prototype, and a companion README section lists several known bugs, such as a lobby command accidentally overriding a game's own command with the same name, and save files not actually being isolated between games as intended, discovered during third party testing. The author explains these are not being fixed here because the lessons learned were carried into a separate, more complete implementation called three-daily, which is the actual playable example of this framework in action, combining a fishing game, a stock trading game, and a bead bracelet game that share energy, gold, and trophies. The license is PolyForm Noncommercial 1.0.0, allowing personal, educational, and research use but not commercial use.