⚔️ FateMMO Game Engine v2

[wFate]

The open-source FateDemo build now ships with the same editor-runtime control loop the proprietary game uses every
day — Play / Pause / Resume / Stop, Observe Mode, a Scene dropdown, a File menu, and Ctrl+S
atomic-write saves.

📦 Download FateMMO_Demo_v2.zip below — no build required.
🌐 FateMMO.com · 🎬 YouTube Showcase

---

🎬 What's New in v2

▶️ Scene Viewport Toolbar

• Play / Resume / Pause / Stop — green Play snapshots the ECS, red Stop restores it; Pause/Resume preserves camera
  state mid-session.
• 👁️ Observe Mode — runs the loaded scene live with editor chrome hidden so you see exactly what the player sees.
  Wire your own handler via AppConfig::onObserveStart / onObserveStop to swap in a network-spectate flow.
• 🗺️ Scene Dropdown — pick any assets/scenes/*.json from the toolbar; transitions are gated against in-flight
  Play state.
• FPS readout — right-aligned, color-muted.

📁 File Menu + Ctrl+S

• New Scene / Open Scene submenu / Save (Ctrl+S) / Save As… with name validation.
• Every editor-authored JSON write goes through engine/core/atomic_write.{h,cpp}::writeFileAtomic — .tmp + rename,
  parent-dir auto-create, copy+remove fallback for cross-volume targets, tmp cleanup on failure.

🌳 Quest Trees & Interact-Sites

• 126 dialogue-tree quests across 4 tiers with state-aware NPC pickers.
• Interact-site framework — ObjectiveType::Interact progresses via player click on cairns / altars / shrines,
  sets CharacterFlagsComponent flags, and triggers first-visit / revisit dialogue nodes.
• Tier 3 Investigation Chains — Gravestones (Greta, Lv 6-12), Altars (Brae, Lv 38-46), Umbra Remnants (Althea, Lv
  50-65).
• Honor + Opals on every turn-in via formula (5 + reqLvl×2 + chainLen×10) × tierMul.
• 8 milestone collections — Wayfarer (10) → Storyseeker (25) → Threadwalker (50) → Pathfinder (70) → Fate-Touched
  (75) → Loresworn (80) → Bearer of Stories (100) → Hand of Fate (150).

🎨 UI Overhauls

• BountyPanel — Active / My Bounties / History tabs, Place Bounty modal, surfaced via interact-site Bounty
  Boards in all 4 faction villages.
• FriendsPanel — Friends / Requests / Blocked tabs with inline Whisper / Party-invite / Remove / Accept /
  Decline / Cancel / Unblock actions.
• GauntletHUD + GauntletResultModal — live Wave/Score/Rank/Time HUD plus top-10 leaderboard on match end.
• DialogueAction::OpenScreen — dialogue trees can open any UI screen client-side.
• 64 widgets total, 42 theme styles, 14 chrome variants.

🔒 Protocol v12 — Hardened

• DB-backed auth_sessions (mig 089) with Postgres LISTEN/NOTIFY session_kicked cross-process kick —
  multi-process deployment ready.
• Encrypted CmdAuthProof (0xD8) — auth token never rides plaintext.
• AuthPhase state machine (HandshakePending → ProofReceived → Authenticated) gates non-system handlers.
• Fail-closed encrypt symmetry on both client + server send paths.
• CharacterFlags client mirror (SvCharacterFlagsSnapshot + SvCharacterFlagDelta) so dialogue HasFlag
  conditions evaluate locally.
• 64-bit ACK window, SvEntityEnterBatch coalesce, CmdAckExtended out-of-window recovery, 9-opcode
  critical-lane bypass.

📦 Pluggable VFS

• New IAssetSource abstraction with DirectFsSource (loose files) and VfsSource (PhysicsFS-backed .pak
  overlay).
• Behind option(FATE_USE_VFS …) so behavior is byte-identical until per-platform flip.
• Migrated readers: textures / JSON / shaders / scenes / audio / dialogue / server scene scans / shutdown config.

⚡ Performance & Reliability

• MetricsCollector sync DB → async DbDispatcher (eliminated ~6.5s mob-freeze stutter).
• UDP socket buffers 64KB → 1MB, pending-packet queue 256 → 2048, packet buffers 4KB → 16KB across 9 sites.
• MAX_STACK_SIZE = 9999 global removed — per-item max_stack honored everywhere; oversized drops split across
  slots.
• ArchetypeStorage reserve 256 → 4096 (relogin crash fix).
• Client frame pacer restored 94 → 250 FPS on Win11/DWM.

---

📊 Stats

Lines of Code	187,000+ across 834+ files
Engine	83K LOC (360 files)
Game	38K LOC (120 files)
Server	36K LOC (138 files)
Tests	29K LOC — 1,546 cases / 9,121 assertions, all green
Protocol	v12
Quests	126 dialogue-tree quests
Dialogue Trees	156 JSON files (quests + NPCs + sites)
Scenes	27 handcrafted (7 adventure + 5 villages + 1 Castle + 9 dungeon floors + 4 arenas + Beach)
Migrations	102 numbered SQL
Handlers	46 server handler files
DB Repos	23 repository files
Platforms	Windows / macOS (Metal) / iOS / Android / Linux

---

🚀 Quick Start

git clone https://github.com/wFate/FateMMO_GameEngine.git
cd FateMMO_GameEngine
cmake -B build
cmake --build build
./build/FateDemo          # Linux/macOS
build\Debug\FateDemo.exe  # Windows

The demo opens the full editor UI. Use ▶️ Play to enter a snapshot-protected play session, 👁️ Observe to live-preview,
 or pick a scene from the dropdown.



---
⚔️ Forged by Caleb Kious 
🌐 https://www.FateMMO.com · ⭐ https://github.com/wFate/FateMMO_GameEngine