OpenGameAgent
DEVELOPERSv0.3.0-alpha.1

An agent framework
for game runtimes.

Use C#/.NET to integrate agent characters with continuous tool use, long-term memory, game time, multi-character execution, and game-confirmed state changes.

GitHub ↗Getting started ↗
01INSTALL

Install the runtime package.

Add the runtime to an existing C# game, then configure the abilities characters may use according to game rules.

.NET 8 · netstandard2.1
PACKAGE / TERMINAL
$ dotnet add package OpenGameAgent --version 0.3.0-alpha.1

Currently alpha. Core contracts are stabilizing; public APIs and persistence formats may still change.

02RUNTIME CAPABILITIES

Character execution requires continuous goal interpretation, tool use, and result feedback.

TOOL LOOPAGENT CORE

Goal planning, tool use, and result inspection

Characters interpret goals, generate execution steps, use game tools, inspect results, and adjust subsequent plans.

GAME CLOCKAGENT CORE

Plan and act in game time

Characters understand turns, day and night, dates, and phases—and can schedule work in future game time rather than merely follow message order.

DURABLE OPSAGENT CORE

Recoverable actions across scenes

Movement, trade, combat, or building can continue across scenes and sessions, then recover from durable operation receipts after disconnection or interruption.

MEMORYGAME RUNTIME

Long-term memory, skills, and workflows

Characters retain experiences, relationships, and commitments, formalize repeatable tasks as skills, and advance goals through messages, schedules, and delegation.

AUTHORITYGAME RUNTIME

Structured actions and game-state control

Characters generate structured action intents. Game code confirms permissions, conditions, and parameters, executes approved actions, and returns state results.

MODEL BUSGAME RUNTIME

Connect models, MCP, and multimodal tools

Connect multiple model providers, add tools through MCP and Agent Plugins 1.0, and handle text, images, audio, and video through one interface.

SERVER AUTHORITYHow action intent becomes game state
01 / PROPOSECharacter generates action intentIntent, parameters, context
RULE CHECK
03 / COMMITThe game executes and returns the resultState updates after rule confirmation
03GAME-STATE CONTROL

Game code confirms and executes state changes.

After a character submits structured action intent, the game checks permissions, resources, distance, cooldowns, ownership, and other rules, then returns the execution result.

TESTED IN EDITORSGODOT 4.7 .NETUNITY 6

Run directly inside the game or self-host the optional .NET 8 JSON/SSE service, then connect OGA Agent Cloud when the project needs production capacity, realtime interaction, and long-term operations.

Integrate the OpenGameAgent runtime into your game project.

View source ↗Discuss integration services →