ivx-economy-simulator

Files (1)

• SKILL.md

SKILL.md (first lines)

# IntelliVerseX Economy Simulator

## Overview

The Economy Simulator provides tools for designing, testing, and monitoring virtual game economies. It builds on top of the Hiro economy system to add currency flow modeling, Monte Carlo simulation, inflation detection, reward curve design, and real-time economy health monitoring.

```
Economy Design (offline)          Live Economy (runtime)
┌──────────────────────┐         ┌──────────────────────┐
│ Currency Flow Model  │         │ IVXEconomyMonitor    │
│ Reward Curve Design  │  ────►  │ Health Dashboard     │
│ Monte Carlo Sim      │  deploy │ Inflation Alerts     │
│ Pricing Optimizer    │         │ Player Wealth Dist.  │
└──────────────────────┘         └──────────────────────┘
         │                                │
         ▼                                ▼
  Hiro Economy Config              Satori Metrics
  (hiro_configs/economy)           (economy events)
```

---

## 1. Currency Flow Model

### Defining Sources and Sinks

```csharp
using IntelliVerseX.Economy;

var model = new IVXCurrencyFlowModel("coins");

model.AddSource(new CurrencySource
{
    Name = "level_reward",
    AveragePerDay = 500,
    Variance = 100,
    PlayerSegment = "all",
});

model.AddSource(new CurrencySource
{
    Name = "daily_login",
    AveragePerDay = 200,
    Variance = 0,
    PlayerSegment = "retained",
});

model.AddSource(new CurrencySource
{
    Name = "rewarded_ad",
    AveragePerDay = 300,
    Variance = 200,
    PlayerSegment = "ad_viewers",
});

model.AddSink(new CurrencySink
{
    Name = "store_purchase",
    AveragePerDay = 400,
    Variance = 150,
});

model.AddSink(new CurrencySink
{
    Name = "energy_refill",
    AveragePerDay = 150,
    Variance = 50,
});

model.AddSink(new CurrencySink
{
    Name = "gacha_pull",
    AveragePerDay = 200,
    Variance = 300,
});
```

### Flow Analysis

```csharp
var analysis = model.Analyze();

Debug.Log($"Daily net flow: {analysis.NetFlowPerDay:+#;-#;0}");
Debug.Log($"Source total: {analysis.TotalSourcesPerDay}/day");
Debug.Log($"Sink total: {analysis.TotalSinksPerDay}/day");
Debug.Log($"Balance ratio: {analysis.SinkToSourceRatio:F2}");
Debug.Log($"Inflation risk: {analysis.InflationRisk}");
```

Recommended sink-to-source ratio: **0.8–1.2** for a healthy economy. Below 0.8 indicates inflation risk.

---

## 2. Monte Carlo Simulation

### Running Simulations

```csharp
var sim = new IVXEconomySimulator();

sim.AddCurrency(model);
sim.SetPlayerCount(1000);
sim.SetDurationDays(90);
sim.SetIterations(100);

sim.SetPlayerBehavior(new PlayerBehaviorProfile
{
    DailySessionProbability = 0.6f,
    PurchaseProbability = 0.05f,
    AdViewProbability = 0.3f,
    ChurnCurve = ChurnCurve.Exponential(halfLifeDays: 14),
});

var results = await sim.RunAsync();

Debug.Log($"Day 30 median balance: {results.GetMedianBalance(30)}");
Debug.Log($"Day 30 P90 balance: {results.GetPercentileBalance(30, 90)}");
Debug.Log($"Day 60 Gini coefficient: {results.GetGiniCoefficient(60):F3}");
Debug.Log($"Day 90 inflation rate: {results.GetInflationRate(90):P1}");

From intelli-verse-x/Intelli-verse-X-SDK, MIT.

More from intelli-verse-x/Intelli-verse-X-SDK