● V1 FOR GAMES MMOs · player economies · agentic worlds

Your game economy
balances itself.

AgentE plugs into your game server, watches your economy every tick, detects imbalances, simulates fixes, and applies them — or recommends them for your approval.

$ npm install @agent-e/core Copy
View 60 Principles

You give it your economy data

Balances, transactions, inventories, prices — whatever your game tracks. AgentE connects to your database and reads it every tick.

It finds what's breaking

60 economic principles run against your live data. Inflation creeping up? Wealth concentrating? A sink drying out? It catches it and tells you why.

It fixes it — or tells you how

It simulates the fix (100+ Monte Carlo runs), proves it won't make things worse, then either applies it automatically or waits for your approval.

LIVE FEED — AgentE detecting and resolving violations in real time

agentE v1.8.1 — live

HOW IT WORKS

The 5-stage pipeline.

01
OBSERVE

Connects to your game database and reads balances, trades, inventories, and prices every tick.

02
DIAGNOSE

Checks 60 principles against live data. Catches violations and ranks them by severity.

03
SIMULATE

Before changing anything, it runs 100+ Monte Carlo simulations to prove the fix works. No guessing.

04
PLAN

Picks which lever to adjust and by how much. Respects locked parameters, bounds, and cooldowns.

05
EXECUTE

Applies the change to your game. Watches every tick after and rolls back anything that backfires.

THE RULES IT FOLLOWS

60 principles.
Zero guesswork.

AgentE doesn't use AI to guess what's wrong. It checks your economy against 60 hard rules — each one designed to catch a specific failure mode before it spirals.

P5
Profitability Is Competitive, Not Absolute
Profit formulas that ignore population cause stampedes. If one role pays a flat rate regardless of how many participants share it, the entire economy piles in.
P17
Grace Period Before Intervention
No intervention in the early ticks. Reacting to initial distributions before the economy stabilizes is overreach — every system needs time to bootstrap.
P40
Replacement Rate ≥ 2× Consumption
Respawn/production rate must be at least 2× consumption. At 1× you drift toward depletion. At 2× you have a buffer for demand spikes.
P43
Simulation Minimum (100 Iterations)
Never ship a balance change with fewer than 100 Monte Carlo iterations. Below that, variance swamps signal and the p10/p90 range is meaningless.
P49
Idle Asset Tax
Appreciating assets without holding cost → wealth concentration. Decay rates, storage costs, or expiry force circulation and prevent Gini runaway.
P27
Cooldowns Prevent Oscillation
A regulator that acts every tick will cause oscillation. Each parameter needs a minimum 15-tick cooldown between adjustments.
View all 60 principles →

INTEGRATION

Three lines to start.
Full control when you need it.

Tier 1 — Drop-in 3 lines
import { AgentE } from '@agent-e/core';

const agentE = new AgentE({ adapter });
agentE.connect(adapter).start();
// That's it.
Tier 2 — Configured recommended
const agentE = new AgentE({
  adapter,
  mode: 'advisor', // 'autonomous' on Pro
  gracePeriod: 50,
  cooldownTicks: 15,
  onDecision: (d) => log(d.reasoning),
});
Tier 3 — Full Control developer safeguards
agentE.lock('your_fee_param');
agentE.constrain('your_cost_param', {
  min: 0.5, max: 2.0
});
agentE.on('beforeAction', (plan) => {
  if (plan.targetValue > 2.0)
    return false; // veto
});

YOUR GAME, YOUR RULES

Add your own
principles.

Every game has rules unique to its design. Write your own principles and AgentE enforces them alongside the built-in 60 — same pipeline, same simulation proof.

agentE.addPrinciple({
  id:   'MY_RULE_1',
  name: 'Support roles must always exist',
  check: (metrics) => {
    const share =
      metrics.roleShares['support'] ?? 0;
    if (share < 0.05)
      return {
        violated: true,
        severity: 8,
        evidence: { share },
      };
    return { violated: false };
  },
});
ADVISOR MODE

Recommends.
You approve.

Not ready for autonomous? AgentE tells you what it would do — with simulation proof — and waits for your sign-off.

const agentE = new AgentE({
  adapter,
  mode: 'advisor' // ← never acts unilaterally
});

agentE.on('decision', (entry) => {
  console.log(entry.reasoning);
  // entry.plan.simulationResult has full proof

  if (youApprove(entry))
    agentE.apply(entry.plan);
});
SINCE V1.6

Built-in
dashboard.

Real-time charts, decision feed, alerts, persona distribution — all at localhost:3100. No extra setup.

import { startServer } from '@agent-e/server';

const server = await startServer({ port: 3100 });
// Open http://localhost:3100 — dashboard is live

// Health charts, decision terminal, alerts,
// persona distribution, violation history.
// WebSocket real-time. HTTP polling fallback.

// In advisor mode: approve/reject from the UI
// curl -X POST /approve -d '{"decisionId":"..."}'
NEW IN V1.8

LLM Intelligence
Layer.

AgentE explains its decisions in plain English. Optional — bring your own LLM provider. Zero cost to AgentE.

const agentE = new AgentE({
  adapter,
  llm: {
    provider: myLLMProvider, // any backend
    features: { anomalyInterpretation: true }
  }
});

agentE.on('narration',   (n) => console.log(n.narration));
agentE.on('explanation', (e) => console.log(e.explanation));
agentE.on('anomaly',     (a) => console.log(a.interpretation));

Diagnosis Narration

When a violation fires, the LLM explains it in plain language. "Inflation is spiking at 12% because faucets are outpacing sinks by 3:1."

Plan Explanation

Before applying a fix, the LLM explains what will change, what the simulation predicts, and what could go wrong.

Anomaly Interpretation

Detects statistical anomalies the principles don't cover. Rolling mean + stddev, then asks the LLM to interpret unexplained deviations.

ROADMAP

Three phases.
One vision.

LIVE NOW
PHASE 1

Game

The core economic intelligence engine — 60 principles, 5-stage pipeline, and Monte Carlo simulation. Built for game economies that need autonomous balancing.

Active
COMING SOON
PHASE 2

DeFi Protocol

Extending AgentE into decentralized finance — autonomous liquidity management, yield optimization, and protocol-level economic guardrails deployed directly on-chain.

Planned
COMING SOON
PHASE 3

Marketplace

A marketplace for economic intelligence — share principles, trade adapters, and license battle-tested configurations across every ecosystem.

Planned

Stop tuning
by hand.

Your players are online 24/7. AgentE watches the economy while you sleep, proves every fix before applying it, and rolls back anything that makes things worse.

$ npm install @agent-e/core Copy
View 60 Principles