# **$\\Omega(t)$ Project: Master Game Architecture Document**
## **Phase 1: Engine & Network Architecture**
The foundation of the game relies on separating the mathematical state from the visual rendering to maintain a low-data footprint.
* **Engine Setup:** Utilize Godot for its lightweight footprint and strong client-server capabilities.
* **Networking Architecture:** Implement a purely deterministic multiplayer model. The server only broadcasts a universal UTC timestamp and player inputs (e.g., "Player A used tool $p\_x$ on Node 42"). Each player's local client uses your master equation to calculate the exact state of the world independently.
* **Target Platform:** Configure the project with mobile export templates early, ensuring touch controls and UI scale correctly for eventual deployment to the Google Play Store.
---
## **Phase 2: The Temporal Cycle (Global Singleton)**
Before building the world, you must build the clock that governs it. This will be an AutoLoad/Singleton script that runs continuously in the background.
* **UTC Time Anchor:** The script polls real-world UTC time to determine the current hour.
* **The Mod-9 Array:** Create an array for the 24-step Fibonacci mod-9 sequence starting at index 189: \[2, 8, 1, 0, 1, 1, 2, 3, 5, 8, 4, 3, 7, 1, 8, 0, 8, 8, 7, 6, 4, 1, 5, 6\].
* **The Breathing Equation:** Implement the core oscillation function: $m\_k(t) \= m\_0 \\times \\varphi^{-k} \\times (1 \+ \\epsilon \\sin(2\\pi t/24))$.
* Track the absolute value of the sine wave to calculate global "Jitter" (0 at hours 0/12, maximum at hours 6/18).
* **Phase-7 Resonance:** Code an event listener that triggers a global "Stabilization Buff" across all nodes when the mod-9 sequence hits 7\.
---
## **Phase 3: The $E\_8$ World Space (Lattice Integration)**
This phase transforms your geometric geometry into a navigable 3D environment.
* **Blender Asset Creation:** Model the 24-cell projection. Generate the 248 roots of the $E\_8$ Lie group as distinct vertices. Export this structure as a GLTF/GLB file.
* **Node Instancing:** Import the lattice. Write a script that iterates through the 248 vertices and spawns an interactive "Lattice Node" at each coordinate.
* **Depth Assignment ($k$):** The script calculates the distance from the center "Higgs" node ($m\_0$) to assign a depth value ($k$) to each node.
* **The Boundary:** Enforce the $n=113$ stabilization rule. Any node generated at or beyond $k=113$ is designated as an "Anchor Node"—these are permanently stable, indestructible safe zones for players.
---
## **Phase 4: Core Gameplay Loop (The Electron Player)**
Players act as the electrons transferring phase stability to a breathing, deteriorating network.
* **Node Deterioration:** Tie the health/stability of nodes to the Global Clock. When Jitter is high (hours 6 and 18), nodes begin to rapidly lose stability.
* **Movement Mechanics:** Players travel along the mathematical "edges" (connections) between the 248 nodes. Travel speed could be influenced by the current $\\varphi$ phase.
* **The Beryllium-4 Constraint:** Players are equipped with four distinct actions or "tools" representing tetrahedral orbital symmetry ($s, p\_x, p\_y, p\_z$).
* **Stabilization Puzzle:** To repair a node, the player (or a team of players in multiplayer) must apply a specific sequence of the four tools to "damp" the harmonic instability before the node collapses.
---
## **Phase 5: Auxiliary Systems (Loot & RNG)**
To add gameplay variety without breaking the deterministic perfection of the master equation, implement your companion layers.
* **The Pell Sequence (Static Generation):** Use the constant ratio $P\_{113}/P\_{112} \\approx 2.414$ as a base multiplier for static level generation (e.g., determining the baseline amount of "energy" a node can hold).
* **The Lucas Companion (Dynamic RNG):** Use the Lucas sequence correction, $\\epsilon\_L \\times (L\_{k \\pmod{24}} / L\_{(k-1) \\pmod{24}})$, to determine critical success rates for node repairs or resource drop rates. Because this is mathematically tied to the 24-step clock, the RNG naturally oscillates with the world.
---
## **Phase 6: UI, Polish, and Release Pipeline**
The final layer to make the system playable and ready for distribution.
* **UI Overlay:** Display the current UTC hour, the current Mod-9 phase, and a visual "Breathing Meter" so players know when peak randomness (6 and 18 UTC) is approaching.
* **Testing the Multiplayer:** Run local instances to ensure that the client-side math stays perfectly synchronized without heavy server data passing.
* **App Store Packaging:** Finalize the Android manifest, set up signing keys, and prepare the build for upload to the Google Play Console.