->

Changelog

Track all material updates to the game design

This changelog documents all significant updates to Gridfall's game design. Use this to stay informed about new systems, balance changes, and design decisions as we refine the concept before development begins.

Pre-Development Phase

All content in this Design Hub is conceptual and subject to change. The goal is to align on design direction and get partner buy-in before any code is written.

48

Total Updates

v5.0.0

Current Version

15+

System Pages

Feb 2026

Last Updated

Asset Loading Screen & Draco Decoder

MAJOR
v5.0.0February 8, 2026

Key Highlights

  • 40MB of 3D assets now load with full visibility into download progress
  • Models cached by browser for instant subsequent loads

Added

  • Full-screen cyberpunk loading screen with real-time progress bar tracking all 18 GLB model downloads
  • Batch parallel downloading (3 at a time) with per-model status checklist and MB counter
  • Draco WASM decoder configured for KHR_draco_mesh_compression GLB models
  • Skip button appears after 3 models load — enter world with partial assets and wireframe fallbacks
  • Glitch text effect, animated grid background, scanlines, and floating hex particles
  • Browser cache tip — subsequent visits load instantly from cache
  • Failed model warning banner with count of wireframe fallbacks in use

Fixed

  • All 18 GLB models now served same-origin from /models/ — eliminates CORS fetch failures on published domains
  • Draco decoder files served from /draco/ — fixes silent model parse failures

Toast Notification System

FEATURE
v4.9.4February 8, 2026

Key Highlights

  • 12+ distinct event triggers across all game systems
  • Cyberpunk-themed glass-morphism toast cards with color-coded borders
  • Non-blocking design keeps gameplay uninterrupted

Added

  • Non-blocking toast notification queue: Up to 5 simultaneous toasts with slide-in animation
  • 6 toast types: success, warning, info, combat, resource, upgrade — each with distinct color and icon
  • Territory claimed: Toast confirms hex coordinates and biome on capture
  • Shield toggle: Toast indicates shield activation/deactivation with status message
  • Combat results: Victory loot breakdown, base defended, and base raided notifications
  • Troop training: Start and completion toasts with troop counts
  • Base upgrade: Start and completion toasts with new level stats
  • Resource gathering: Dispatch and completion toasts with resource type and amount
  • Scout system: Dispatch and intel received toasts
  • War events: Declaration, victory, and defeat toasts
  • Horde invasion: Event start toast
  • Click-to-dismiss: Tap any toast to remove it immediately
  • Auto-expire: Toasts fade out after 4 seconds with exit animation

Offline Resource Accrual

FEATURE
v4.9.3February 8, 2026

Key Highlights

  • Players earn resources while offline — up to 8 hours at 50% efficiency
  • Polished Welcome Back modal with animated resource breakdown
  • Smart shield detection prevents earnings during shield-active sessions

Added

  • Offline resource accrual: Resources accumulate while the player is away, based on production rates and territory bonuses
  • Welcome Back modal: Displays earned Energy, Metal, and Crypto with animated entrance and collect button
  • 8-hour offline cap: Earnings capped at 8 hours to incentivize daily logins
  • 50% offline efficiency: Offline production runs at half rate to reward active play
  • Shield-aware: No offline earnings if shield was active when player left
  • Minimum 60-second threshold: Modal only appears after meaningful absence
  • Duration display: Shows formatted time away (e.g., '2h 15m') with cap indicator

Game State Persistence

FEATURE
v4.9.2February 8, 2026

Key Highlights

  • Full game state persistence via localStorage — no backend required
  • Auto-save every 5 seconds + save on page unload
  • Reset button clears all progress with confirmation

Added

  • localStorage game save: Resources, troops, base level, defense bonus, resource rate, shield state, max troops, and territory claimed all persist between sessions
  • Territory map persistence: Player-owned hex territory keys serialized and restored on load
  • Auto-save every 5 seconds with beforeunload save on page close
  • Green pulsing 'Auto-saved' indicator in bottom status bar
  • Reset Progress button: Clears all game state, territory, and tutorial completion with confirmation dialog
  • Save versioning system for future-proof migration support

Changed

  • GameState initialization now checks localStorage before using defaults
  • Territory map initialization restored from save data when available

Tutorial & Onboarding System

FEATURE
v4.9.0February 8, 2026

Key Highlights

  • 15-step interactive tutorial guides new players through the complete gameplay loop
  • Smart auto-advance: tutorial progresses when players perform the expected action
  • Professional onboarding experience for investor/stakeholder demos

Added

  • Interactive tutorial overlay: 15-step guided onboarding for new players in the 3D world
  • Tutorial steps cover: Welcome, Navigation, Find Base, Select Base, Manage Base, Upgrade, Train, Find Resources, Gather, Find Enemy, Attack, Shield Economy, Alliance, Scout, and Completion
  • Auto-advance triggers: Tutorial progresses automatically when players perform expected actions (click base, open panels, gather resources, toggle shield)
  • Animated tutorial card with progress bar, step dots, and cyberpunk-themed UI
  • Spotlight effects: Pulsing ring on welcome step, toolbar highlight glow for highlighted buttons
  • Skip Tutorial button for experienced players
  • Tutorial restart button in toolbar after completion (GraduationCap icon)
  • Sound effects on tutorial navigation (select, collect, victory sounds)
  • Smooth CSS animations: fadeIn backdrop, slideUp card entrance, pulse effects
  • localStorage persistence: tutorial completion state saved locally so returning players skip the tutorial automatically
  • Tutorial restart clears localStorage, allowing players to replay the onboarding

Changed

  • POC version badge updated to v4.9
  • Toolbar buttons now integrate with tutorial auto-advance system
  • Action handlers (gather, shield toggle, base management) wired to tutorial progression

Alliance War Declaration & Event Calendar

MAJOR
v4.8.0February 6, 2026

Key Highlights

  • Full alliance war system with score tracking and battle log
  • Comprehensive event calendar with week/day views and 10+ scheduled events
  • 7 distinct event types with unique rewards and difficulty levels

Added

  • Alliance War Declaration: Formally declare war on rival alliances from the Diplomacy tab
  • War Score tracking: Territory captures, troop kills, and resource raids contribute to war score
  • War Battle Log: Real-time feed of war events (territory flips, skirmishes, raids) with timestamps
  • War duration timer: 5-minute wars with automatic ceasefire and victory/defeat resolution
  • War rewards: Winner gets 25K energy, 15K metal, 5K crypto; loser gets consolation loot
  • Simulated enemy war actions: Rival alliances fight back with territory captures and raids
  • Event Calendar page: Full weekly schedule with 10+ recurring events across 7 event types
  • Week View: Visual time grid showing all events across 7 days with color-coded blocks
  • Day View: Detailed daily schedule with event descriptions, difficulty, and rewards
  • Live Status Bar: Shows currently active event, next upcoming event, and today's event count
  • Featured Events banner: Highlights the week's marquee events (Alliance Conquest, Shield Collapse, World Boss, etc.)
  • Event Detail Modal: Full event info with schedule, day indicators, and reward list
  • Event types: PvE Invasion, PvP Tournament, Resource Boost, Alliance War, Boss Raid, Shield Event, Special
  • Hub sidebar: Event Calendar link with orange-to-red gradient button

Changed

  • Alliance Diplomacy panel enhanced with War tab showing active war status and controls
  • Alliance relations now include 'War' state alongside Neutral, Allied, and Hostile

NPC Refactor — Zone-Based Scaling & Horde Invasion Event

FEATURE
v4.7.1February 8, 2026

Key Highlights

  • Horde Invasion is now a triggerable timed event, not the core game loop
  • NPCs scale by map zone (inner = harder) for 4X PvP balance
  • Core loop remains: Gather → Upgrade → Train → Attack players → Claim territory

Added

  • Horde Invasion: Triggerable PvE event (toolbar button) — 5-minute timed event with escalating waves every 45 seconds
  • 10 named horde wave tiers: Skirmish → Raid → Assault → Siege → Blitz → Onslaught → Rampage → Devastation → Annihilation → Apocalypse
  • Horde event summary modal: Shows waves survived, threat level reached, and duration after event ends
  • Zone-based passive NPC scaling: Inner-ring NPCs are 2× stronger, mid-ring 1.5×, outer-ring 1× (always active)
  • Horde Event toolbar button with pulsing animation and active state indicator
  • Event countdown timer and remaining event time in resource HUD
  • NPC Passive mode indicator when no horde event is active

Changed

  • BREAKING: Waves are no longer always-on — refactored from automatic escalation to triggerable event
  • NPC base aggression reduced in normal play (8% near / 2% far) — 4X PvP focus, not tower defense
  • During Horde event: NPCs become highly aggressive (25-70% attack chance scaling with wave)
  • ResourcePanel shows 'NPC Passive' indicator during normal play, switches to horde HUD during events

Performance Optimization — Frustum Culling & LOD

FEATURE
v4.6.0February 8, 2026

Key Highlights

  • ~80% reduction in rendered hex count at typical zoom levels
  • Shared geometry eliminates ~3,800 redundant Shape allocations
  • 3-tier LOD ensures smooth performance even on lower-end devices

Added

  • Frustum culling: Only hexes within camera viewport are rendered, checked at ~10Hz (every 6 frames)
  • 3-tier LOD system: Near (<25 units) = full 3D models/labels/particles, Mid (<45) = hex tile + structure dot, Far (<65) = flat hex only
  • Distance culling: Hexes beyond 80 units are completely skipped
  • Shared geometry: All hex tiles share SHARED_HEX_SHAPE and SHARED_HEX_GEO_FLAT instances
  • HexTileSimple component for mid/far LOD with minimal draw calls
  • Pre-indexed hex map for O(1) lookups in scene rendering

Changed

  • Ground plane expanded to 200x200 to cover full expanded map
  • HexTile no longer creates per-tile Shape geometry (uses shared instance)
  • Visibility recalculation throttled to ~10Hz to reduce CPU overhead
  • Typical render count reduced from ~3,800 to ~400-800 hexes depending on zoom level

World Map Overhaul — Biomes, Terrain & Expanded Grid

MAJOR
v4.5.0February 8, 2026

Key Highlights

  • World expanded to ~3,800 hexes across 8 unique biomes
  • Terrain decorations bring visual variety with Meshy 3D models
  • Biome zoom navigation enables instant travel across the map

Added

  • 8 distinct biomes replacing concentric zones: Neon Wastes, Crystal Caverns, Scrapyard, Data Swamp, Volcanic Core, Frozen Grid, Skyport, and central Nexus
  • Biome-based hex coloring with unique color palettes and emissive tints per biome
  • Biome-specific elevation profiles: volcanic peaks, frozen plateaus, swamp lowlands, skyport highlands
  • Terrain decoration models: Mountains (Volcanic/Frozen), Ruins (Scrapyard/Data Swamp), Crystal clusters (Crystal Caverns)
  • 3D Meshy terrain models placed on landscape — terrain_mountain and terrain_ruins GLBs integrated
  • Biome-specific resource distribution: energy in Neon/Volcanic, metal in Scrapyard/Frozen, crypto in Crystal/Data
  • Expanded NPC positions: 12 NPC bases spread across all biomes (up from 5)
  • 4 additional capitol positions in outer biome regions
  • Biome-colored minimap with per-biome dot coloring and terrain markers
  • Minimap legend toggle showing all 8 biome names and colors
  • Zoom-to-biome navigation: 8 biome icon buttons on minimap for instant camera travel
  • Seeded pseudo-random terrain placement for consistent world generation

Changed

  • Map radius expanded from 25 to 35 (~3,800 hexes, up from ~1,950)
  • Fog distance extended from 80 to 120 to accommodate larger map
  • Minimap scale updated to cover full expanded world (220px canvas, 70-unit range)
  • Minimap renamed to 'World Radar' with improved structure rendering
  • Resource nodes now color-coded on minimap by type (gold/silver/purple)
  • Nexus rendered as magenta dot on minimap for visibility

Alliance Diplomacy, Scouting & Hero Models

MAJOR
v4.4.0February 6, 2026

Key Highlights

  • Full alliance social system with chat, roster, and diplomacy
  • Scouting adds strategic recon mechanic before committing troops
  • Hero 3D models bring Meshy.AI assets directly into gameplay
  • 18-model gallery showcases the complete AI art pipeline

Added

  • v4.1 — Hero 3D Models in Combat: All 5 hero GLB models (NOVA, AEGIS, CIPHER, WRAITH, TITAN) now render as interactive 3D viewers in hero selection cards and combat popup
  • v4.1 — HeroModelViewer component with auto-rotation, ambient/directional lighting, and auto-fit scaling
  • v4.2 — 3D Model Gallery page: Dedicated showcase of all 18 Meshy.AI models with interactive 360° orbit controls
  • v4.2 — Category tabs (Heroes, Terrain, Structures, Resources, Gameplay) with featured model viewer
  • v4.2 — Pipeline info panel showing Meshy.AI generation stats (Image-to-3D, Draco compression, optimization)
  • v4.3 — Alliance Diplomacy & Chat: Full alliance panel with GRIDFALL VANGUARD roster (8 members with online status)
  • v4.3 — Real-time chat with simulated alliance members, system messages, and message input
  • v4.3 — Diplomacy tab: Manage relations with 3 rival alliances (PHOENIX ORDER, IRON LEGION, SHADOW SYNDICATE)
  • v4.3 — Diplomacy actions: Set Ally/Neutral/War status with each alliance, auto-announces in chat
  • v4.3 — Roster tab: View all alliance members, power rankings, roles (leader/officer/member), online status
  • v4.4 — Scouting System: Send scouts to fog-covered hexes to reveal them temporarily (30s intel window)
  • v4.4 — Scout Operations panel with available targets grid, active intel reports with countdown timers
  • v4.4 — Scout cost scales with distance from base (50 + 10 per tile), deducted from troop count
  • v4.4 — Scout intel reports with randomized recon data (structure detection, resource scanning, threat assessment)
  • v4.4 — Scout-revealed hexes integrate into fog of war system — reveals target + 6 adjacent hexes
  • New toolbar buttons: Alliance (green) and Scout (yellow) with active report badge counter
  • 3 new sound effects: scout ping, chat notification, diplomacy change

Changed

  • Hero selection cards now show spinning 3D models instead of flat colored circles
  • Combat popup displays 3D hero model alongside combat stats
  • Fog of war system now incorporates scout reveals alongside territory and march visibility
  • POC version bumped to v4.4 in toolbar badge
  • Model Gallery added to Hub sidebar navigation with Box icon

Ultra Neon Cyberpunk Art Overhaul

MAJOR
v4.0.0February 6, 2026

Key Highlights

  • Complete art direction overhaul — from dark cyberpunk to ultra-fun neon cyberpunk
  • Full Meshy.AI Image-to-3D pipeline: Concept art → Upload → 3D generation → Draco compression → CDN
  • 18 unique AI-generated 3D models totaling only 40 MB after optimization
  • Art style designed to appeal to all ages including children — bright, exaggerated, fun

Added

  • Complete art direction pivot — Ultra AI cyberpunk, exaggerated, fun, bright neon style across ALL assets
  • 19 new concept art pieces generated with ultra-fun neon cyberpunk aesthetic
  • 18 Meshy.AI Image-to-3D models generated from new concept art (heroes, terrain, structures, resources)
  • 5 hero character 3D models — NOVA, AEGIS, CIPHER, WRAITH, TITAN — each from unique concept art
  • 3 terrain 3D models — hex tile, mountain, ancient ruins — all in neon cyberpunk style
  • Shield dome and troop squad 3D models for gameplay elements
  • Loading screen with animated spinner while 3D models download
  • Draco mesh compression + WebP texture optimization — 732 MB raw → 40 MB optimized (95% reduction)
  • New hero banner image for website homepage in ultra-fun neon style

Changed

  • All website imagery updated to match new ultra-fun neon cyberpunk art direction
  • Homepage hero banner, showcase, base building, combat, and world map images replaced
  • All 3D models in HexWorld3D replaced with v2 Image-to-3D models from new concept art
  • Model count expanded from 8 to 18 (added heroes, terrain types, shield dome, troop squad)
  • Version bumped to v4.0.0 — major art direction milestone
  • Game description updated to reflect fun, vibrant, all-ages appeal

Meshy.AI 3D Model Integration

MAJOR
v3.5.0February 6, 2026

Key Highlights

  • First integration of external AI 3D model generation into the POC
  • 8 unique AI-generated models with full textures and PBR materials
  • Meshy.AI pipeline: Text prompt → Preview geometry → Refined textured model → GLB download → CDN hosting

Added

  • Meshy.AI integration — All 8 structure types now use AI-generated, fully textured 3D models via Meshy.AI Text-to-3D API
  • Player Base model — Futuristic cyberpunk command center tower with glowing cyan neon lights and antenna arrays
  • NPC Bunker model — Hostile red-lit military bunker fortress with mounted turret gun and aggressive angular design
  • Capitol model — Grand futuristic fortress with golden spire tower, surrounding buttresses, and ornate golden crown
  • Outpost model — Tall slim cyberpunk watchtower with observation platform and rotating radar dish
  • Energy Resource model — Cluster of glowing yellow energy crystals growing from rocky base
  • Metal Resource model — Raw metallic silver ore deposit with rough hewn steel-gray mineral rocks
  • Crypto Resource model — Floating purple holographic data cube structure with glowing wireframe edges
  • Nexus model — Massive energy spire obelisk with orbiting glowing ring and pulsing energy core
  • GLB model loader with auto-centering, normalization, and animation support
  • Model preloading for all 8 assets to minimize loading hitches

Changed

  • All procedural Three.js geometry replaced with Meshy.AI generated GLB models (~6-8 MB each, fully textured with PBR maps)
  • Models hosted on CDN for fast loading
  • Animations preserved — rotation, bobbing, and scale effects applied to loaded models
  • Version bumped to v3.5.0

Strategic Layer — Fog, Territory, AI, 3D Models

MAJOR
v3.4.0February 6, 2026

Key Highlights

  • Strategic depth: fog creates information asymmetry, territory gives alliances something to fight over
  • PvE content: AI opponents ensure there is always something to do
  • Visual upgrade: every structure now has a unique 3D procedural model

Added

  • Fog of War system — Unexplored hexes are darkened until scouted; toggle fog on/off from toolbar
  • Alliance Territory Claiming — Claim hexes adjacent to your territory with visual ring overlays
  • Territory bonus — Each claimed hex increases resource production by +2%
  • AI Opponents — 5 NPC bases spread across the map with red bunker models and rotating turrets
  • NPC AI behavior — NPCs regenerate troops and periodically launch attacks on the player base
  • AI attack alerts — Incoming NPC attacks shown in HUD with red pulsing indicator
  • Auto-defense system — Player base automatically defends against AI attacks based on troop count and DEF bonus
  • 3D procedural models — Player base (multi-tier tower with beacon), NPC bunkers with turrets, alliance fortresses, capitols with golden spires, watchtower outposts with rotating radar
  • 3D resource nodes — Energy (yellow crystal clusters), Metal (silver ore chunks), Crypto (purple data cubes) with unique geometry
  • 3D Nexus model — Massive energy spire with orbiting ring and pulsing core sphere
  • 3D troop march groups — Animated capsule formations moving along march lines
  • Territory count in resource HUD
  • Sound effects for territory claiming and AI alerts

Changed

  • All flat colored shapes replaced with procedural 3D models
  • Minimap now shows fog of war and territory overlays
  • Action panel includes Claim Territory button for eligible hexes
  • Resource generation now scales with territory count
  • March lines show AI indicator for NPC attacks
  • Version badge updated to POC v3.4

Core Loop Polish — Harvest, Build, Train

MAJOR
v3.3.0February 6, 2026

Key Highlights

  • Full gameplay loop now playable: gather → build → train → attack
  • Resource economy with meaningful upgrade progression (Lv.15-20)
  • Three troop tiers with different cost/time/count trade-offs

Added

  • Resource harvesting system — Click resource nodes, send troops to gather with animated march lines
  • Gather job queue — Track active gather missions with progress bars and countdown timers
  • Collection particle effects — Animated green particles flowing from resource nodes back to player base
  • Base building/upgrade system — Upgrade Command Center from Lv.15 to Lv.20 with resource costs and timers
  • Construction particle effects — Golden sparkles animate around base during upgrades
  • Visual base scaling — Base structure grows in size with each level upgrade
  • Troop training queue — Train Infantry Squads, Mech Platoons, and Elite Battalions with timers
  • Base Management Panel — Tabbed UI (Upgrade/Train/Gather) for all base operations
  • Resource HUD enhancements — Active job indicators showing gather, train, and upgrade status
  • Sound effects for upgrade and train actions — New audio cues for building and training
  • Troop capacity system — Max troops scales with Command Center level

Changed

  • Action panel now includes 'Manage Base' button when player base is selected
  • Resource panel shows base level and active job count indicators
  • Gather marches now create persistent gather jobs with timed resource collection

3D Combat Evolution — Heroes, Shields & Sound

MAJOR
v3.2.0February 3, 2026

Key Highlights

  • First implementation of 3D particle systems and physics effects
  • Shield economy mechanic now playable in 3D world
  • Sound design foundation with Web Audio API

Added

  • Hero selection screen — Choose up to 3 heroes before combat with animated 3D preview cards
  • 5 unique heroes — NOVA (Striker), AEGIS (Tank), CIPHER (Support), WRAITH (Assassin), TITAN (Bruiser)
  • Shield toggle on player base — Raise/drop shield with particle effects and resource trade-off
  • Shield particle system — 60 animated particles orbiting protected bases
  • Explosion particle effects — Physics-based debris on combat impact
  • Screen shake — Camera shake on combat hits and explosions
  • Sound effects engine — Web Audio API with 8 distinct sound types (attack, shield, march, victory, defeat, collect, hit, select)
  • Sound mute toggle — Volume control button in header
  • Combat HP bars — Real-time player and enemy health tracking during battle
  • Combat log — Live damage numbers and skill usage during fights
  • Screen flash effects — Red flash on combat hits for visual feedback
  • Hero performance stats — Post-battle damage breakdown per hero

3D Hex World — Full Gameplay Loop

MAJOR
v3.1.0February 6, 2026

Key Highlights

  • Complete gameplay loop: Select → March → Combat → Results
  • First playable single-player experience

Added

  • March system — Animated troop movements between hexes with dashed path lines
  • Minimap radar — Real-time overview showing all structures, marches, and selection
  • Resource panel — Top HUD displaying Energy, Metal, Crypto, and Troop counts
  • Attack mode — Click player base → select target → watch troops march
  • Gather mode — Send troops to resource nodes to collect materials
  • Combat popup — Turn-based battle simulation with progress bar and results
  • Victory/defeat outcomes — Loot rewards on victory, troop losses on defeat
  • Target highlighting — Red glow on attackable structures when in attack mode
  • Player base marker — Green highlighted hex with unique structure model

3D Hex World POC — First Playable 3D Prototype

MAJOR
v3.0.0February 5, 2026

Key Highlights

  • First true 3D prototype validating Three.js approach
  • Foundation for full web app MVP development

Added

  • 3D Hex World page — Full Three.js/React Three Fiber implementation with ~1,900 hex tiles
  • Orbital camera controls — Rotate, zoom, and pan around the 3D world
  • 5 zone system — Outer Rim, Frontier, Warzone, Capitol Ring, Central Nexus with distinct colors
  • Structure types — Player bases, Sector Capitols, Warzone Outposts, Resource Nodes, Grid Core
  • Alliance visualization — Phoenix Legion (orange), Iron Dominion (blue), Shadow Syndicate (purple)
  • Shield dome effects — Animated translucent spheres over protected structures
  • Cyberpunk atmosphere — Fog, stars, colored accent lighting, metallic materials
  • Interactive hex selection — Click tiles to view coordinates, zone, structure details
  • Level indicators — 3D HTML labels showing structure levels

Map Architecture & Scaling Specifications

MAJOR
v2.14.0February 5, 2026

Key Highlights

  • Supports 10,000+ concurrent players from day one
  • Built-in expansion capability for future seasons

Added

  • Map Architecture page — Detailed specifications for 50×50 hex grid supporting 10K+ players
  • Zone layout system — 5 concentric zones: Outer Rim, Frontier, Warzone, Capitol Ring, Central Nexus
  • Season scaling roadmap — Grid expansion from 50×50 (S1) to 80×80 (S3+) for 25K players
  • POI distribution guide — 8 Capitols, 64 Trade Posts, 32 Warzone Outposts, 500 Resource Nodes
  • Performance architecture — Chunk-based loading, LOD, fog of war culling, instance batching
  • Viewport management — 4 zoom levels from strategic (50×50) to base view (3×3)
  • Competitive comparison — Launch with S5-equivalent scale to avoid early map expansions

Web App Development Plan & 3D Vision

MAJOR
v2.13.0February 5, 2026

Key Highlights

  • Validates technical approach before full build commitment
  • Estimated $300-500 external costs for complete MVP

Added

  • Web App Development Plan page — 12-week accelerated roadmap for 3D multiplayer web game MVP
  • 3D Vision concept gallery — 3 high-fidelity concept images showing target aesthetic
  • Interactive sprint timeline — 6 development phases with expandable deliverables
  • Tech stack recommendations — React, Three.js, Supabase, WebSockets architecture
  • Tool & resource guide — Essential tools for Manus-first development with cost estimates
  • External requirements breakdown — 3D assets, audio, and music sourcing guidance

Defeat Scenario & Consequences

FEATURE
v2.12.0February 5, 2026

Key Highlights

  • Demonstrates risk/reward of target selection
  • Shows consequences of poor strategic decisions

Added

  • Omega Fortress — New ultra-powerful enemy base (450K power, 85K troops) for defeat scenario
  • Elite enemy heroes — 5 legendary/epic defenders: Omega Warlord, Crimson Executioner, Shadow Reaper, Blood Priest, Doom Bringer
  • Danger warning system — Visual alerts for bases with power levels significantly higher than player
  • Power comparison display — Shows enemy power as multiplier (e.g., 4.7x) relative to player
  • Defeat consequences panel — Hospital capacity used, troop recovery time, commander XP lost
  • Strategic tip system — Contextual advice after defeat to help players learn

Alliance War Demo

MAJOR
v2.11.0February 5, 2026

Key Highlights

  • Demonstrates complete gameplay loop for investors
  • Shows how World Map and Battle Arena systems integrate

Added

  • Complete Alliance War demo — Full attack sequence from target selection to battle results
  • Target selection phase — Interactive map showing enemy bases with shield status
  • March animation phase — Real-time troop movement visualization with progress tracking
  • Battle phase — Turn-based combat simulation with hero cards, HP bars, and combat log
  • Results phase — Victory/defeat screen with loot summary, casualties, and hero performance
  • 4 enemy bases to attack — Iron Citadel, Steel Outpost (shielded), Shadow Nexus, Thunder Keep
  • 4 player heroes — Nova Prime, Titan-7, Cipher, Vex Hunter with unique classes
  • Battle speed controls — 1x, 2x, 4x speed options with pause/skip functionality

Shield Visualization & Tutorial Flow

MAJOR
v2.10.0February 5, 2026

Key Highlights

  • Demonstrates the 45% D1 retention target through clear onboarding
  • Shows investors how new players learn core mechanics

Added

  • World Map shield status indicators — Visual icons showing protected (🛡️) vs farming (⚡) bases
  • Shield bubble animation — Pulsing cyan glow around shielded structures
  • Tile info panel shield status — Shows current shield state with production rate
  • Tutorial Flow Demo — 7-step interactive onboarding for Shield Economy mechanic
  • Interactive shield simulator — Toggle shield in tutorial to see resource changes
  • Attack warning system — Visual alert when enemies approach unshielded bases
  • Optimal farming windows guide — Risk levels by time of day
  • Alliance coordination tips — Team strategies for safe farming

Shield Economy System

MAJOR
v2.9.0February 5, 2026

Key Highlights

  • Creates compelling risk/reward decisions for players
  • Discourages passive play while rewarding active engagement
  • Balances whale spending with F2P progression

Added

  • Shield Economy page — Risk/reward mechanic where resource generation is tied to shield status
  • Core concept section — Shield ON (0% production, protected) vs Shield OFF (250% production, vulnerable)
  • Detailed resource generation rates — Per-hour breakdown for all resource types
  • Time comparison analysis — Always shielded vs balanced vs aggressive playstyles
  • Timing considerations — Shield cooldowns, optimal farming windows, daily cycle visualization
  • Alliance warfare interactions — Coordinated farming, war mode override, strategic scenarios
  • Monetization impact — Shield-related purchases and economic balance analysis
  • Interactive simulator — Toggle shield status to see resource projections

Community Feedback Loop

FEATURE
v2.8.1February 4, 2026

Key Highlights

  • Shows investors the player-developer feedback loop
  • Demonstrates community engagement strategy

Added

  • Community Feedback Loop tab added to Off-Season Activities page
  • Feedback pipeline visualization — Submit → Vote → Review → Implement
  • Feedback categories — Gameplay Balance, Quality of Life, New Features with response times
  • Community Wins showcase — 4 implemented player ideas with vote counts and impact metrics
  • Contributor rewards system — Rewards for idea submission and voting participation
  • Developer communication schedule — Weekly Dev Diary, Monthly AMA, Bi-weekly Response Posts
  • Feedback impact stats — 12,847 ideas submitted, 47 implemented, 2.3M votes, 94% response rate

Off-Season Activities & Stylized PDF

MAJOR
v2.8.0February 4, 2026

Key Highlights

  • Off-Season page shows investors the full 20-week season cycle
  • Stylized PDF creates professional investor-ready documentation
  • Demonstrates attention to detail in all deliverables

Added

  • Off-Season Activities page — Comprehensive guide to 8-week off-season period
  • Catch-Up Systems section — 2x XP, resource abundance, hero fragments shop, gear catch-up
  • Limited Events section — 4 unique 2-week events (Proving Grounds, Alliance Olympics, Lore Expedition, Pre-Season Tournament)
  • Preparation Phase section — Season prep checklist with resource stockpiling, hero preparation, alliance readiness
  • Head-Start Bonuses — Bronze/Silver/Gold/Platinum tiers for off-season completion
  • Off-Season Rewards section — Exclusive cosmetics and progression rewards
  • Off-Season Monetization breakdown — Revenue streams and expectations
  • Stylized PDF export — Professional cyber-themed PDF with cover page, table of contents, section dividers
  • PDF progress indicator — Real-time generation progress bar
  • PDF features checklist — Shows all PDF enhancements

Changed

  • GDD download now generates stylized PDF instead of plain text
  • PDF includes branded cover page with stats boxes
  • PDF has page headers, footers, and section numbers
  • Document version updated to v2.8.0

Season Timing Update

UPDATE
v2.7.1February 3, 2026

Key Highlights

  • Longer seasons give players more time to progress and compete
  • Extended off-season allows for meaningful catch-up and preparation
  • More sustainable content cadence for development team

Changed

  • Season length updated from 8 weeks to 12 weeks (84 days)
  • Off-season period updated from 3-5 days to 8 weeks (56 days)
  • Annual seasons reduced from 6 to 2-3 per year (20-week cycles)
  • Mid-season update moved from Week 4-5 to Week 6-7
  • Double XP weekends adjusted to every 3 weeks (from every 2 weeks)
  • Catch-up period extended to final 2 weeks (from 1 week)
  • Annual Battle Pass revenue projection adjusted to $1.1-1.3M

A/B Thumbnail Testing

MAJOR
v2.7.0February 3, 2026

Key Highlights

  • Demonstrates data-driven creative optimization
  • Shows commitment to maximizing ad performance
  • Investors see scientific approach to UA spend

Added

  • A/B Thumbnail Testing dashboard — Compare thumbnail variants for each video
  • Multi-variant support: 2-3 thumbnail variants per video ad
  • Click-through rate (CTR) tracking per variant
  • Statistical confidence level indicator (95% threshold)
  • Control vs variant comparison with percentage difference
  • Impressions share visualization with progress bars
  • Winner declaration when confidence threshold reached
  • Simulate button to test click tracking in real-time
  • Shuffle A/B button to randomize displayed variants
  • Test status indicators: Running, Completed, Paused

Changed

  • Video cards now show active A/B variant badge
  • Header displays number of running A/B tests
  • Document version updated to v2.7.0

Video Analytics Dashboard

FEATURE
v2.6.1February 3, 2026

Key Highlights

  • Investors can see actual performance data for each ad
  • Demonstrates data-driven UA optimization approach
  • Shows ROI potential with engagement and CTR metrics

Added

  • Performance Analytics dashboard — Comprehensive metrics for all video ads
  • View counts with trend indicators (+/- percentage)
  • Engagement metrics: likes, shares, clicks per video
  • Completion rate tracking with color-coded thresholds
  • Average watch time and CTR (Click-Through Rate) display
  • Total aggregated metrics: 446K+ views, 35K+ likes, 18K+ clicks
  • Performance by Video table with sortable columns
  • Real-time view tracking when watching videos
  • Metrics overlay in video player modal

Changed

  • Video cards now display engagement metrics on hover
  • Hero section shows total views and weekly growth
  • Document version updated to v2.6.1

Marketing Assets Page

MAJOR
v2.6.0February 3, 2026

Key Highlights

  • Investors can preview actual promotional content
  • Demonstrates mobile-first vertical video strategy
  • Shows UA (User Acquisition) planning and metrics

Added

  • Marketing Assets page — Showcase for promotional video content
  • 4 short-form video ads (15-18 seconds each)
  • Video gallery with hover-to-preview functionality
  • Full-screen video player with custom controls
  • Progress bar, play/pause, mute controls
  • Platform badges (TikTok/Reels) on each video
  • Ad Strategy section explaining marketing approach
  • Target metrics display (CPI, CTR, ROAS goals)

Changed

  • Added Marketing Assets link to sidebar navigation
  • Document version updated to v2.6.0

Alliance Chat Integration

FEATURE
v2.5.2February 3, 2026

Key Highlights

  • Demonstrates the social/multiplayer feel of alliance gameplay
  • Shows how players coordinate attacks and celebrate victories
  • Investors can see the community engagement loop in action

Added

  • Alliance Chat panel — Simulated real-time chat feed alongside Battle Log
  • Tabbed interface switching between Battle Log and Alliance Chat
  • Auto-generated chat messages from alliance members
  • Member roles displayed: Leader (crown), Officer (star), Member
  • Role badges for leaders and officers
  • Online members indicator with avatar previews
  • Chat reactions to battle events (victories, defeats, scout reports)
  • Message types: coordination, warnings, celebrations, general chat
  • Disabled chat input placeholder for demo purposes
  • Clear Chat button to reset message history

Changed

  • Battle Log and Alliance Chat now share a unified tabbed container
  • Event completion triggers chat reactions from alliance members
  • Document version updated to v2.5.2

Real-Time Battle Log

FEATURE
v2.5.1February 3, 2026

Key Highlights

  • Investors can now see the full battle feedback loop in action
  • Scout intel shows strategic value of reconnaissance marches
  • Victory/defeat outcomes demonstrate risk/reward combat mechanics

Added

  • Battle Log panel — Real-time event feed for completed marches
  • Attack outcomes with victory/defeat status and damage dealt
  • Scout reports showing enemy troop counts, power, and structures
  • Reinforcement arrival notifications with troop counts
  • Color-coded events by outcome (green=victory, red=defeat, cyan=intel, blue=arrived)
  • Timestamp tracking showing time since each event
  • Clear Log button to reset event history
  • Scrollable event list with max 50 events stored

Changed

  • March completion now generates detailed battle outcomes
  • Document version updated to v2.5.1

March Visualization & Hero Recruitment Demo

MAJOR
v2.5.0February 3, 2026

Key Highlights

  • World Map now visualizes real-time warfare with animated marches
  • Hero Recruitment demo showcases full gacha mechanics with pity system
  • 5 playable prototypes now available for investor demonstrations
  • Complete monetization loop visible: currency → pulls → heroes → combat

Added

  • March/Attack Visualization — Animated troop movements on World Map
  • 4 march types: Attack (red), Scout (cyan), Reinforce (green), Rally (orange)
  • Real-time march progress with pulsing visual effects
  • Troop count labels and progress percentages on marching units
  • Auto-spawning demo marches between alliance structures
  • March control panel with play/pause and active march list
  • Hero Recruitment Demo — Interactive gacha summoning system
  • 6 rarity tiers: Common, Uncommon, Rare, Epic, Legendary, Mythic
  • 20 heroes across 3 classes and 3 weapon types
  • Pity system with soft pity at 75 pulls and hard pity at 90 pulls
  • Banner system with featured hero rate-ups
  • Pull animations with sound effects and reveal sequences
  • Collection tracking and pull history
  • Quantum Cores premium currency integration

Changed

  • World Map now shows live troop movements between territories
  • Playable Prototype section expanded to 5 demos
  • Document version updated to v2.5.0

Interactive World Map Prototype

MAJOR
v2.4.0February 3, 2026

Key Highlights

  • Third playable prototype demonstrates alliance territory warfare
  • Hex-grid map with procedural terrain generation
  • Visual influence system shows how structures expand territory
  • Multi-alliance competition with Phoenix Legion vs Iron Dominion demo

Added

  • World Map Demo — Interactive hex-grid territory control prototype
  • Alliance HQ placement and expansion mechanics
  • Banner Tower system for territory extension
  • 5 structure types: Alliance HQ, Banner Tower, Watchtower, Resource Outpost, Fortress
  • 6 terrain types with different buildability and defense bonuses
  • Territory influence visualization with alliance colors
  • Contested territory indicators for disputed zones
  • Resource nodes (Steel, Circuits, Power, Rare Materials) scattered across map
  • Real-time territory statistics showing alliance control percentages
  • Structure placement validation with influence radius preview

Changed

  • Playable Prototype section now features three demos: Battle Arena, Base Builder, and World Map
  • Document version updated to v2.4.0

Base Builder & Enhanced Battle Arena

MAJOR
v2.3.0February 3, 2026

Key Highlights

  • Two playable prototypes now available for investor demos
  • Base Builder demonstrates city management and resource economy
  • Battle Arena now features immersive audio feedback
  • Strategic swap phase fully functional

Added

  • Base Builder Demo — Interactive city management prototype with 8x8 grid
  • 9 building types across 5 categories (Core, Military, Resource, Development, Defense)
  • Building placement, upgrade, and demolition mechanics
  • Resource management system (Steel, Circuits, Power)
  • Command Center progression unlocking new buildings
  • Battle Arena sound effects — Attack impacts, critical hits, counter bonus sounds
  • Victory and defeat fanfares with volume control
  • Reserve hero swapping — Full swap functionality in the swap phase with visual feedback

Changed

  • Playable Prototype section now features both Battle Arena and Base Builder demos
  • Document version updated to v2.3.0

Playable Battle Arena Prototype

MAJOR
v2.2.0February 3, 2026

Key Highlights

  • First interactive gameplay demonstration for investors
  • Validates core counter-based hero mechanics
  • Partners can experience the strategic depth firsthand
  • Foundation for future prototype expansions

Added

  • Battle Arena Demo — First playable prototype of the Counter Hero battle system
  • Team Selection phase — Choose 5 active heroes + 3 reserves from 11-hero roster
  • Scout Phase — Analyze enemy team composition before battle
  • Swap Phase — 30-second timer to swap up to 2 heroes to counter enemy lineup
  • Battle Simulation — Real-time combat with counter bonuses (Class +30%, Weapon +20%, Mod +15%)
  • Results Screen — Victory/defeat with damage breakdown, MVP calculation, and team performance stats
  • Counter System visualization — Interactive legend showing all counter relationships
  • 11 unique heroes across 3 classes (Vanguard, Striker, Technomancer) with different weapons and mods

Changed

  • Sidebar now features prominent 'Playable Prototype' section with Battle Arena Demo link
  • Document version updated to v2.2.0

Battle Pass & Seasonal Content

MAJOR
v2.1.0February 3, 2026

Key Highlights

  • 15-20% Premium Pass conversion target
  • $9.99 Premium Pass / $24.99 Premium Pass+ / $4.99 Prestige Upgrade pricing
  • Season cosmetics NEVER return — creates FOMO and exclusivity
  • ~9% of total Year 1 revenue from Battle Pass system

Added

  • Battle Pass page — Complete seasonal content system with 12-week seasons (8-week off-seasons), 100+20 prestige tiers, and comprehensive reward tracks
  • Free Track rewards — Epic Season Hero at Tier 100, avatar frames, emotes, and progression resources
  • Premium Track rewards — Legendary Season Hero, Mythic gear sets, exclusive cosmetics, and 15,000+ Quantum Cores
  • Prestige Track (Tiers 101-120) — Animated avatar borders, mythic hero shards, and prestige titles
  • Season Themes — The Awakening, Iron Tide, Fractured Alliances, The Deep Grid, Crimson Protocol, Endgame (2-3 seasons per year)
  • Season Shop with Season Tokens — Previous season heroes, gear materials, exclusive emotes
  • Catch-up mechanics — Tier skips, Double XP weekends, late joiner protection
  • Revenue model projections — $435K per season, $1.1-1.3M annual from Battle Pass (2-3 seasons)

Changed

  • System Designs section now includes Battle Pass link with 'NEW' badge
  • Document version updated to v2.1.0

Server Lifecycle & Operations

MAJOR
v2.0.0February 3, 2026

Key Highlights

  • Target 18+ month average server lifespan before merge
  • 70%+ D30 retention post-merge with comprehensive compensation
  • Power-based matchmaking ensures fair cross-server competition
  • NOVA servers create recurring engagement for veteran players

Added

  • Server Lifecycle page — Complete server launch cadence, health monitoring, merge mechanics, and cross-server systems
  • 5-phase server launch schedule from Soft Launch to Maintenance
  • 4-stage server age phases (Genesis, Expansion, Dominion, Legacy) with unique mechanics
  • Server health metrics dashboard with weighted scoring system
  • 30-day merge process timeline with compensation packages
  • Cross-server matchmaking tiers (Bronze, Silver, Gold, Diamond)
  • NOVA fresh-start server concept with spending caps and accelerated progression

Changed

  • System Designs section now includes Server Lifecycle link with 'NEW' badge
  • Document version updated to v2.0.0

Quest System & Social Systems

MAJOR
v1.9.0February 3, 2026

Key Highlights

  • Complete engagement loop design targeting 70%+ daily quest completion rate
  • Session design optimized for 3 daily touchpoints (morning/midday/evening)
  • Social features designed to drive 10-12% D30 retention target
  • Moderation system with AI filtering and escalation paths

Added

  • Quest System page — Daily quests (4 categories, 8 quests), weekly quests (10 quests), monthly narrative chains, and 28-day login calendar
  • Social Systems page — Chat channels (World, Alliance, Team, Private), real-time translation (14 languages), friend system, and moderation tools
  • Premium login track monetization ($4.99/month)
  • R4/R5 weekly highlight system for alliance recognition
  • Best Friends system with special perks (up to 3 best friends)
  • Emote and expression system with free, unlockable, and premium tiers

Changed

  • System Designs section now includes Quest System and Social Systems links with 'NEW' badges

Competitive Landscape Analysis

FEATURE
v1.8.0February 3, 2026

Key Highlights

  • Clear visual differentiation showing Gridfall's strengths vs competitors
  • Hover-to-reveal insights explain why each advantage matters
  • Four key differentiator cards: Counter System, Fragmentation, Retention-First, Theme/IP

Added

  • Competitive Landscape page — Visual side-by-side comparison of Gridfall vs Last War, WhiteOut Survival, and Rise of Kingdoms
  • Feature comparison matrix with 16 metrics across 4 categories (Core Mechanics, Monetization, Retention, Market Position)
  • Interactive category tabs with hover insights explaining Gridfall's advantages
  • Market opportunity section with $6.8B market size visualization

Changed

  • Partner Collaboration section now includes Competitive Landscape link with 'NEW' badge

Executive Summary & Development Roadmap

MAJOR
v1.7.0February 3, 2026

Key Highlights

  • Scannable investor pitch format with key metrics prominently displayed
  • 5-phase development timeline with expandable milestone details
  • Critical path milestones: MVP (Month 3), Feature Complete (Month 6), Soft Launch (Month 9), Global Launch (Month 10)

Added

  • Executive Summary page — One-page investor overview with key metrics, differentiators, revenue model, and financial projections
  • Development Roadmap page — Interactive timeline from MVP (Month 1-3) through Global Launch (Month 10+) with milestone tracking
  • Risk factors and mitigation strategies section in roadmap

Changed

  • Partner Collaboration section now includes Executive Summary and Roadmap links
  • Added 'NEW' badge to Executive Summary for visibility

Research Tech Tree & Partner Collaboration Tools

MAJOR
v1.6.0February 3, 2026

Key Highlights

  • Interactive tech tree with selectable nodes and dependency visualization
  • Structured feedback system with status tracking (Open/Discussed/Resolved)
  • Priority indicators for high-impact design decisions

Added

  • Research Tech Tree page — Interactive visualization of Economy, Military, and Development branches with unlock dependencies
  • Questions & Feedback page — 14 open design questions organized by category for partner input before development
  • Partner Collaboration section in sidebar with prominent feedback link

Changed

  • Sidebar reorganized with new 'Partner Collaboration' section
  • Added open question counter badge for visibility

Building System, VIP System & Revenue Projections

MAJOR
v1.5.0February 3, 2026

Key Highlights

  • Interactive VIP tier explorer with real-time stat calculations
  • Month-selectable revenue dashboard with growth trajectory charts
  • Complete build queue monetization breakdown

Added

  • Building System page — 10 building types across 5 categories with upgrade requirements and production rates
  • VIP System page — Interactive explorer for all 20 tiers ($250-$500K) with cumulative stat calculator
  • Revenue Projections page — ARPDAU curves, conversion funnels, and 3-year $190M financial forecast
  • Changelog page — Track all material updates for partner visibility

Changed

  • VIP tier thresholds rebalanced — VIP 1 now requires $250 (up from $50)
  • Added new VIP 16 tier at $125,000 to bridge gap between $100K and $175K
  • Updated all VIP-related documentation across the site

Troop System, Events Calendar & Gear Comparison Tool

MAJOR
v1.4.0February 3, 2026

Added

  • Troop System page — Four unit types with interactive counter triangle and 10-tier progression
  • Events Calendar page — Daily/weekly/monthly event cycles with reward breakdowns
  • Gear Comparison Tool — Side-by-side comparison with enhancement power curves

Alliance System & Gear Crafting

FEATURE
v1.3.0February 3, 2026

Added

  • Alliance System page — R1-R5 ranks, permissions matrix, territory control mechanics
  • Gear & Crafting page — 6 quality tiers, 4 gear slots, 3 mythic sets, crafting recipes

PvP System & Interactive Diagrams

MAJOR
v1.2.0February 3, 2026

Added

  • PvP Combat System page — Structured (Alliance Duel, Sector War, Arena) and unstructured (raids, burns, territory) PvP
  • Interactive counter-triangle diagrams for Counter Hero System
  • Team Composition Builder demo with scout/swap phase simulation

Core System Design Pages

MAJOR
v1.1.0February 3, 2026

Key Highlights

  • Flexible team composition (5 active + 3 reserve) with strategic swap phase
  • Alliance Resurrection Pool — social spending mechanic
  • Defensive subscription model (players pay to protect, not just attack)

Added

  • Counter-Based Hero System — RPG-style counters with class/weapon/mod triangles
  • Fragmentation System — Thematic troop recovery mechanics (replaces generic 'hospital')
  • Five-Pillar Monetization Framework — Time Acceleration, Insurance, Priority, Prestige, Events

IP Cleanup

FIX
v1.0.1February 3, 2026

Removed

  • All explicit references to copyrighted properties (Terminator, Cyberpunk, Fallout, etc.)
  • Direct competitor name mentions in game design sections

Changed

  • Art direction now uses original 'Neon Urban Decay' + 'Post-Apocalyptic Survival' + 'Rogue AI Threat' pillars
  • Competitive analysis documents remain for internal benchmarking (appropriate for investor discussions)

Initial Design Hub Launch

MAJOR
v1.0.0February 2, 2026

Key Highlights

  • Cyber-Fall aesthetic established
  • 8 hero archetypes defined across 3 classes
  • $28M Year 1 revenue target set

Added

  • Core GDD overview with design pillars and target metrics
  • Hero Gallery with 8 launch heroes
  • Blackout War interactive map concept
  • Downloadable GDD document
  • Responsive sidebar navigation

Questions about any changes? Reach out to discuss design decisions before we commit to development.

Return to Design Hub