huge refactor

src/Roboto.Memory/States/WorldDataState.cs

@@ -0,0 +1,60 @@
+using System.Numerics;
+using Roboto.GameOffsets.States;
+
+namespace Roboto.Memory.States;
+
+/// <summary>
+/// Reads WorldData struct (168B, 1 RPM) and resolves the camera matrix.
+/// Primary camera source: WorldData.CameraPtr. Fallback: InGameState.CameraPtr (set via FallbackCameraPtr).
+/// </summary>
+public sealed class WorldDataState : RemoteObject
+{
+    private WorldData _data;
+
+    /// <summary>Camera pointer from InGameState, set by InGameStateReader before Update() is called.</summary>
+    public nint FallbackCameraPtr { get; set; }
+
+    public Matrix4x4? CameraMatrix { get; private set; }
+
+    /// <summary>Resolved address of the camera matrix for hot-path caching.</summary>
+    public nint CameraMatrixAddress { get; private set; }
+
+    public WorldDataState(MemoryContext ctx) : base(ctx) { }
+
+    protected override bool ReadData()
+    {
+        var mem = Ctx.Memory;
+        var offsets = Ctx.Offsets;
+
+        // Read the full WorldData struct (0xA8 = 168 bytes, 1 RPM)
+        _data = mem.Read<WorldData>(Address);
+
+        // Resolve camera: primary from WorldData, fallback from InGameState
+        if (offsets.CameraMatrixOffset <= 0)
+            return true;
+
+        var camPtr = _data.CameraPtr;
+        if (camPtr == 0)
+            camPtr = FallbackCameraPtr;
+        if (camPtr == 0)
+            return true;
+
+        var matrixAddr = camPtr + offsets.CameraMatrixOffset;
+        CameraMatrixAddress = matrixAddr;
+
+        var m = mem.Read<Matrix4x4>(matrixAddr);
+        if (float.IsNaN(m.M11) || float.IsInfinity(m.M11))
+            return true;
+
+        CameraMatrix = m;
+        return true;
+    }
+
+    protected override void Clear()
+    {
+        _data = default;
+        FallbackCameraPtr = 0;
+        CameraMatrix = null;
+        CameraMatrixAddress = 0;
+    }
+}