ivx-live-ops

Files (1)

• SKILL.md

SKILL.md (first lines)

# IntelliVerseX Live Operations

## Overview

Live-ops in the IntelliVerseX SDK is powered by two server-side systems:

- **Hiro** — 33+ game systems (economy, energy, achievements, streaks, events, etc.)
- **Satori** — Analytics, feature flags, A/B experiments, live events, and messaging

Both are coordinated client-side through `IVXHiroCoordinator` and `IVXSatoriClient`, initialized automatically by `IVXBootstrap` after Nakama authentication.

---

## When to Use

Ask your AI agent any of these:

- "Add daily rewards with a 7-day calendar"
- "Set up a fortune wheel with weighted rewards"
- "Add achievements and a badge system"
- "Configure A/B testing for the onboarding flow"
- "Set up a 6-tier league system"
- "Add a season pass with free and premium tracks"
- "Set up daily missions that rotate every 24 hours"
- "Add login streaks with escalating rewards"
- "Enable feature flags for gradual rollout"

---

## What the Agent Does

```mermaid
flowchart TD
    A[You: "Add daily rewards"] --> B[Agent loads ivx-live-ops skill]
    B --> C[Verifies Hiro + Satori enabled]
    C --> D{Which system?}
    D -->|Engagement| E[Daily Rewards / Missions / Fortune Wheel / Streaks]
    D -->|Retention| F[Season Pass / Goals / Friend Streaks]
    D -->|Competition| G[Leagues / Tournaments / Leaderboards]
    D -->|Economy| H[Currency / Energy / Inventory / Store]
    D -->|Analytics| I[Events / Flags / A/B / Live Events]
    E --> J[Configures via IVXHiroCoordinator]
    F --> J
    G --> J
    H --> J
    I --> K[Configures via IVXSatoriClient]
```

---



## 1. Hiro Systems

### IVXHiroCoordinator

The coordinator initializes and manages all Hiro sub-systems. It is available after bootstrap:

```csharp
using IntelliVerseX.Backend;

IVXHiroCoordinator hiro = IVXHiroCoordinator.Instance;
```

### Core Systems

| System | Manager | Purpose |
|--------|---------|---------|
| **Economy** | `IVXEconomyManager` | Currencies, wallets, grants, purchases |
| **Energy** | `IVXEnergyManager` | Time-based energy with refill timers |
| **Inventory** | `IVXInventoryManager` | Items, stacking, consumption |
| **Achievements** | `IVXAchievementManager` | Progress-based unlocks with rewards |
| **Progression** | `IVXProgressionManager` | XP, levels, prestige |
| **Streaks** | `IVXStreakManager` | Login streaks, play streaks |
| **EventLeaderboards** | `IVXEventLeaderboardManager` | Time-limited competitive events |
| **Store** | `IVXStoreManager` | Virtual store with rotating inventory |
| **Challenges** | `IVXChallengeManager` | Daily/weekly/monthly challenges |
| **Teams** | `IVXTeamManager` | Clans, guilds, team-based play |
| **Unlockables** | `IVXUnlockableManager` | Progression-gated content |
| **Retention** | `IVXRetentionManager` | Day-N rewards, comeback bonuses |

### RPC Pattern

All Hiro calls follow the same pattern through `IVXHiroRpcClient`:

```csharp
using IntelliVerseX.Backend;

// Generic typed RPC call
var response = await IVXHiroRpcClient.Instance.CallAsync<AchievementList>(
    rpcId: "hiro_achievements_list",
    payload: new { }
);

if (response.Success)
{
    foreach (var achievement in response.Data.Achievements)
    {
        Debug.Log($"{achievement.Name}: {achievement.Progress}/{achievement.Target}");
    }
}
else
{
    Debug.LogWarning($"RPC failed: {response.Error}");
}
```

The `HiroRpcResponse<T>` wrapper provides `Success`, `Data`, `Error`, and `StatusCode`.

---

## 2. Satori Analytics & Live Config

### IVXSatoriClient

Satori provides real-time analytics, segmentation, and remote configuration.

#### Tracking Events

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

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