AR AI RPG Engine
v2.0.0

AI RPG Engine Build worlds. Simulate them. Improve them.

The first RPG engine designed for experimentation. Deterministic simulation runtime + AI-assisted design studio.

Install

npm install -g @ai-rpg-engine/cli

Studio

ai chat

Onboard

/onboard

Core Capabilities

What makes AI RPG Engine different.

Deterministic Simulation

Tick-based engine with world state, events, perception, cognition, faction beliefs, rumor propagation, and seeded RNG. Every run can be replayed exactly.

AI-Assisted Worldbuilding

Scaffold rooms, factions, quests, and districts from a theme. Critique designs, repair schema errors, and guide multi-step builds. AI suggests — you decide.

Replay Analysis

Structured findings explain why events happened, where mechanics break down, and which systems create instability. Analysis feeds directly into tuning.

Experiment-Driven Balancing

Run batches of simulations across seeds. Detect variance, sweep parameters, compare tuned vs baseline. Turn world design into a testable process.

Studio Workflow

CLI design studio with dashboards, issue tracking, experiment browsing, session history, guided onboarding, and context-aware command discovery.

17 Built-In Modules

Combat, dialogue, cognition, perception, factions, rumors, districts, progression, environment, and more. All composable, all deterministic.

Genre-Agnostic

Same core runs dark fantasy, cyberpunk, or any setting. Genre belongs to rulesets and content packs, not the engine.

Quick Start

Install

npm install -g @ai-rpg-engine/cli

Start the studio

ai chat
/onboard

Build a world

create-location-pack haunted chapel district
critique-content
simulate

Analyze and improve

analyze-balance
tune paranoia
experiment run --runs 50

Built-In Modules

17 composable simulation modules.

Module
Description
combat-core
Attack/defend, damage, defeat, stamina
dialogue-core
Graph-based dialogue trees with conditions
inventory-core
Items, equipment, use/equip/unequip
traversal-core
Zone movement and exit validation
status-core
Status effects with duration and stacking
environment-core
Dynamic zone properties, hazards, decay
cognition-core
AI beliefs, intent, morale, memory
perception-filter
Sensory channels, clarity, cross-zone hearing
narrative-authority
Truth vs presentation, concealment, distortion
progression-core
Currency-based advancement, skill trees
faction-cognition
Faction beliefs, trust, inter-faction knowledge
rumor-propagation
Information spread with confidence decay
knowledge-decay
Time-based confidence erosion
district-core
Spatial memory, zone metrics, alert thresholds
belief-provenance
Trace reconstruction across perception/cognition/rumor
observer-presentation
Per-observer event filtering, divergence tracking
simulation-inspector
Runtime inspection, health checks, diagnostics

Design Workflow

Scaffold content

create-location-pack --theme "abandoned mine" \
  --factions miners_guild,deep_crawlers

Analyze balance

simulate
analyze-balance
suggest-fixes

Tune mechanics

tune rumor propagation
tune-step
tune-status

Run experiments

experiment run --runs 50
experiment compare baseline tuned
/findings