Skip to content

AIventure

AIventure is an Angular + Phaser game from bebechien/AIventure. Its VifuHub integration brings the project into the VifuHub release flow and Agent Runtime while preserving the game's own structure and identity. VifuHub provides the single game-to-runtime interface for model-driven NPC play and the wider set of host-managed capabilities an Agent Runtime game can use.

Open The Game

bash
git clone --recurse-submodules https://github.com/vifudotdev/awesome-open-source-ai-native-games
cd awesome-open-source-ai-native-games/games/aiventure
npm install

What It Uses

AIventure is a bundled Angular project with Phaser gameplay:

  • npm run build builds the browser artifact.
  • dist/template-angular/browser is the deploy output.
  • index.html is the runtime entry inside that output.
  • VifuHub connects the game to host-managed AI agents and tools, game state, runtime resources, world sessions, events, and approved capabilities through one runtime interface.
  • AIventure uses that interface for NPC dialogue and game tools.
  • Visible NPC/game interactions are passed as executable tools to hub.ai.generateText(...).
  • Model routing is selected by the host session, so the game does not hardcode a provider id.
  • The game does not embed direct provider credentials or host transport code.

The manifest identifies the game, while the VifuHub CLI resolves the Angular build command, output directory, runtime entry, and available host features from the project and its VifuHub calls.

json
{
  "name": "AIventure"
}

Use the manifest reference only when a project needs to override detected defaults or disable a host feature.

Deploy It

bash
vf deploy

The deploy check blocks remote executable code and direct browser calls to external AI providers. Keep model calls behind hub.ai.generateText(...) or hub.run(...) so the game uses the runtime AI service.