EAHA Operations Manual

Welcome to the definitive knowledge base for the Elys Astra Helper Application. This documentation details the mathematical algorithms, strategic mapping protocols, and data synchronization engines utilized by the system to provide you with absolute tactical superiority in Path of Titans.

1. Architecture & Cloud Synchronization

The EAHA utilizes a dual-layer, hybrid storage architecture designed for rapid deployment, offline resilience, and secure data integrity.

  • Parallel Cloud Fetching: When initializing, the system triggers simultaneous Firebase queries. By executing requests for rules, lineages, and baselines concurrently rather than sequentially, initial payload times are drastically reduced.
  • The Global Baseline: Server rules, administration release notes, and base creature statistics are pushed globally. The application automatically downloads these changes without overwriting your localized edits.
  • Encrypted Personal Profiles: Your tactical maps, custom dinosaur modifiers, and family trees are bound strictly to your UID. This data is continuously cached locally via IndexedDB to ensure zero data loss during network interruptions.
  • The Smart Latch Protocol: There is no manual "Save" button. The system utilizes an auto-sync engine that saves in the background. If you attempt to navigate away while data is actively transmitting to Firebase, a 2.5-second expiration safety latch will intercept your browser, warning you to stay on the page. The latch auto-expires to prevent false-positive lockups.

2. The Operations Dashboard

The Dashboard serves as your live tactical HUD, centralizing immediate combat threats, active vitals, and overarching faction statistics.

Combat Analytics Engine

Every logged encounter generates data for your Overall Faction K/D and your Active Creature K/D. The system utilizes a specialized Chart.js radial graph to map casualty distribution (e.g., PvP vs. Starvation vs. Drowning). The Engagement Split ledger isolates exactly how lethal your current session is.

Elysian Lifeline & Upkeep

  • Active Dinosaur Briefing: Engaging the active dropdown pulls your designated creature from the database. This instantly injects their Adult Base Damage, True DPS, Dietary needs, and assigned Roles/Mutations directly into the dashboard.
  • Vital Decay Timers: Input a minute value to simulate real-time decay on your Satiation, Comfort, and Hygiene. The system provides visual, color-coded alerts when thresholds hit critical levels (0%). Click 'Reset' to pause the timer and manually adjust the sliders after completing an upkeep task.
  • Eldering Tracker: Use the plus/minus toggles to log successful server migrations. The system will track your progress through the 4 Eldering Stages, automatically applying the respective statistical decays or buffs to the briefing panel. At 16 migrations, Rebirth token selection is unlocked.

3. Profiles & Matrix Importer

The Creature Profiles database relies on a 5-Stage Data Matrix to fuel the Threat Assessor. This is where you configure the raw numbers for every species.

✨ Magic Auto-Fill (Optical Character Recognition)

Drop an image of a creature's Discord profile card directly into the designated drop zone. The OCR engine reads the raw pixel data, filters out visual noise, and extracts the Name, Tier, Diet, Habitats, and Behaviors, converting it into database text to save you from manual data entry.

⚡ 5-Stage Data Matrix Importer

To power the Threat Assessor, you must import the game's actual code variables. Paste raw configuration strings into the Matrix Importer. The engine uses a Regular Expression scanner to hunt for arrays formatted exactly like this:

BiteDamage",Values=(20,30,40,50,60))
Core.MaxHealth",Values=(150,262.5,375,487.5,600))
  • Order Independence: Paste massive, unorganized walls of text directly from the server files. The engine isolates what it needs.
  • The 5-Stage Array: Values represent the growth stages: Hatchling, Baby, Adolescent, Sub-Adult, Adult.
  • Smart Categorization: Any imported variable with "Damage", "Bleed", "Bonebreak", or "Cooldown" is automatically isolated and flagged as a Primary Combat Statistic, prioritizing it in the UI and the DPS calculator.

4. Threat Assessor Mathematics

The core of EAHA's intelligence lies in the Threat Assessor (located on the Stats page). It mimics the game's actual backend formulas to provide an objective combat verdict.

The Scenario Sandbox

Select a stat (e.g., Health) and input a percentage modifier (e.g., +15%). The engine unpacks the creature's entire 5-stage growth array, calculates the buff simultaneously across all life stages, and outputs the brand-new matrix.

How the Assessor Calculates Lethality

  1. Weight & Deflection: The engine takes the Attacker Combat Weight, divides it by the Defender Combat Weight, and factors in the Defender's Armor multiplier. Formula: (Attacker CW / Defender CW) / Defender Armor. This yields the Master Damage Multiplier.
  2. True DPS Parsing: The algorithm scans the creature's data for any string containing "Damage". It finds the corresponding Cooldown, applies the Weight Multiplier, and calculates exactly how much Health is stripped away per second (DPS).
  3. Sprint Endurance: The system divides Core.MaxStamina by StaminaSprintCostPerSecond to output exactly how many seconds a creature can sustain pursuit before complete exhaustion.
  4. Agility Scanners: The engine checks TurnRadiusMultiplier for both combatants, issuing warnings if you are at risk of being tail-ridden.
  5. The Tactical Banner: Finally, the engine weighs your total DPS against your Combat Weight advantage, combining them into a final AI-generated tactical verdict (e.g., "OVERWHELMING ADVANTAGE" or "LETHAL THREAT").

5. Tactical Map & Recon Radar

The Gondwa Map Room is engineered for precise spatial coordination and pack-level intelligence sharing.

System Directive: Auto-Plotting To instantly find your coordinates, press Ctrl+V to paste a raw X=... Y=... text string, or paste a fully zoomed-out screenshot of your in-game map. The engine will calculate the map scale and seamlessly drop a tactical marker at your precise location.

GPS Navigation & Tracking

  • Live Coordinates: A tactical HUD in the top-left corner dynamically translates your mouse position into precise Unreal Engine coordinates. Click the HUD to instantly copy the data to your clipboard.
  • Distance Ruler: Activate 📏 Measure mode. Click to anchor a start point, and move your cursor to see the exact distance in meters. The HUD will simultaneously calculate the estimated travel time in seconds assuming a 10m/s sprint.

Markers, Routes, and Danger Zones

  • Danger Zone Radii: When placing a marker, input a radius in meters (e.g., 500) and select a tactical color swatch. The engine draws a perfectly scaled, semi-transparent border around the point—ideal for outlining territories or Quest Zones.
  • Interactive Route Drawing: Engage 🛤️ Draw Route to map out migration paths. Every click deploys a highly visible waypoint node. Click and drag nodes to adjust the path dynamically, or right-click a node to erase it.
  • Recon Base64 Sharing (Export/Import): Your map data is highly valuable. Click Export to compress your active pins, zones, and routes into a secure, encrypted text string. Paste this into Discord; allies can hit Import to seamlessly merge your tactical layout directly onto their screens.

6. Pack Lineage Tracker

Designed for complex roleplay and pack history, the Lineage Tracker archives family bloodlines across generations using advanced visual rendering.

  • Visual Node Tree: The lineage workspace utilizes dynamic SVG mathematics to draw curved connection lines linking assigned Sires (Blue) and Dams (Pink) to their respective offspring, creating an interactive, flowing family tree.
  • Dynamic Pack Hierarchy: Assign roles to members (Alpha, Beta, Scout, Subordinate). Members designated as 'Alpha' receive golden tactical borders, a crown emblem, and are automatically prioritized to the top of their generational row.
  • The Trophy Case: Click the 🏅 icon on any living member to open the Milestone Editor. Award custom Legacy Titles (e.g., "Firstborn", "Survivor") which render as specialized chips on their profile card.
  • The Memorial Hall: Death is permanent. Clicking the ☠️ icon prompts you to record a member's Cause of Death and Location. They are subsequently removed from the active SVG tree and permanently archived in the Memorial Hall tab for historical RP tracking. (Mistakes can be corrected using the ❤️‍🩹 Revive button in the archive).

7. Communications & Rulebook

Administrative and operational tools to streamline out-of-game coordination.

  • Discord Post Builder: A comprehensive text editor featuring syntax highlighting for Discord markdown (bold, italics, code blocks), quick-inject templates for LFG and Trading, and a Unicode text converter to deploy stylized fonts (e.g., 𝔊𝔬𝔱𝔥𝔦𝔠).
  • Rules Database: The complete server rulebook is cached locally. Use the search bar to instantly query specific keywords during active disputes, retrieving the exact administrative phrasing without dropping your game frame rate to check Discord.

8. Troubleshooting & FAQ

Hardware Calibration (Multi-Monitor & Ultra-Wide) The Gondwa map boundaries can shift, and utilizing different resolution arrays (such as spanning between an MSI G32 165Hz and a secondary Acer 2k display) can slightly distort coordinate math.

Fix: Click the ⚙️ Calibrate GPS button on the Map page. Paste your exact /loc, then drag the gear icon to your exact visual location to permanently lock in a corrected global offset for your specific hardware.

Q: I'm in the Map Room, but I can't click or drag my markers anymore.
A: You are likely locked in "Draw Route" or "Measure" mode. Click the 🤚 Nav button in the top toolbar to re-engage standard interaction protocols.

Q: My Lineage Tree lines are disconnected or floating in space.
A: The SVG engine relies on the scroll position of the workspace container. If you rapidly resize the window, the math may temporarily desync. Simply scroll the window slightly or refresh the page to force the geometry engine to recalculate the anchor points.

Q: The Threat Assessor says "No primary damage stats found in matrix."
A: The simulator hunts specifically for custom variables containing the word Damage. If your dinosaur's imported code is missing those lines, the engine cannot auto-calculate the DPS. Ensure you paste the full array list into the Importer.

Q: The OCR Auto-Fill is extracting gibberish or merging words incorrectly.
A: The OCR engine reads raw pixel data. If your Discord screenshot contains complex background UI elements or reaction emojis, the engine will attempt to translate them into text. Crop your screenshot tightly around the text block before importing.