Build Games Where Every NPC Feels Alive

// Schema Definition (Before Simulation Starts)
// All schema definitions happen before Tick 0. The schema locks.

using Warweaver.UnityAdapter;
using UnityEngine;

public class GameController : MonoBehaviour
{
    private WarweaverManager _manager;
    private WarweaverAdapter _adapter;
    
    void Awake()
    {
        _manager = FindObjectOfType<WarweaverManager>();
        _adapter = _manager.Adapter;
        
        var greedHandle = _adapter.CreateAttribute("Personality_Greed", 0f, 100f, 50f);
        var reputationHandle = _adapter.CreateAttribute("Reputation_Player", -100f, 100f, 0f);
        var goldHandle = _adapter.CreateAttribute("Resource_Gold", 0f, 9999f, 100f);
        
        int scamOpId = _adapter.CreateOperator("Trade_Scam_Player");
        int fairTradeOpId = _adapter.CreateOperator("Trade_Fair_Price");
        
        int merchantId = _adapter.CreateArchetype("Merchant", new ArchetypeConfig
        {
            RequiredAttributes = new[] { greedHandle, reputationHandle, goldHandle },
            AllowedOperators = new[] { scamOpId, fairTradeOpId }
        });
        
        // Schema is now locked. Start simulation.
        _manager.StartSimulation();
    }
}

// Signal Injection
// The kernel processes these deterministically in the next tick.
// No immediate side effects. No Unity callbacks from kernel.

void OnPlayerEnterShop(Vector3 shopPosition)
{
    int playerProximitySignalId = _adapter.CreateSignal("Player_Proximity");
    
    _adapter.InjectSignal(
        signalId: playerProximitySignalId,
        position: new System.Numerics.Vector3(shopPosition.x, 0f, shopPosition.z),
        radius: 10f,
        duration: 60  // ticks
    );
    
    var merchantId = GetMerchantAgentId();
    var reputationHandle = GetReputationHandle();
    _adapter.SetAttribute(merchantId, reputationHandle, playerReputation);
}

// Telemetry Reading
// Simulation runs at a fixed TPS you choose. Rendering runs at 144fps.
// They don't block each other. Zero allocations.

void Update()
{
    _adapter.SwapTelemetryBuffers();
    var snapshot = _adapter.GetTelemetrySnapshot();
    
    for (int i = 0; i < snapshot.AgentCount; i++)
    {
        var agent = snapshot.Agents[i];
        UpdateAgentPosition(agent.AgentId, agent.X, agent.Y);
        UpdateAgentAnimation(agent.AgentId, agent.CurrentAction);
    }
}

// Forensic Debugging
// Get the reasoning trace for any agent at any tick.

void DebugAgentDecision(ushort agentId, int tick)
{
    var trace = _manager.Host.GetReasoningTrace(agentId, tick);
    Debug.Log(trace.ToString());
    
    /* OUTPUT:
    [Agent 42 "Merchant"] Tick 1247 Decision: "Refuse_Service"
    ------------------------------------------------
    > Candidate: "Trade_Fair_Price"
      - Base Score: 0.50
      - MODIFIER [Reputation_Player=-40]: -0.80
      - Final: 0.0 (Pruned)
    
    > Candidate: "Refuse_Service"
      - Base Score: 0.20
      - MODIFIER [Personality_Stubborn=80]: +0.60
      - Final: 2.30 (WINNER)
    */
    
    // Replay exact tick with same seed. Same result. Bit exact determinism.
    _manager.ResetSimulation(seed: originalSeed);
    _manager.StepSimulation();
}