🧠 AI-Powered Dynamic Quest System ("Procedural Dungeon Master")
- Procedural Quest Generation: Procedural dungeon master synthesizes themed quests, lore, objectives, and map targets based on player progression, nearby landmarks, and inventory.
- 4 Core Dynamic Quest Types:
- ⛏️ The Gather & Deliver Quest: Collect raw materials from real-world locations with golden street navigation lines.
- 👹 The Hunt & Clear Quest: Cleanse monster nests in local parks and crossroads with pulsing red danger perimeters.
- 📦 The Timed Courier Run: Deliver fragile crystals across town before a ticking countdown timer expires.
- 🛡️ The Caravan Escort: Defend traveling allied caravans along roads from roadside monster ambushes.
- Quests Tab & HUD Banner: Full in-game quest journal, step tracker, and map overlay.
🏛️ Tag-Based Real-World POI Loot & Landmarks (OSM Overpass Integration)
- Live Overpass POI Scanner: Queries nearby real-world establishments within 500m (Pharmacies -> Health Elixirs, Banks -> Gold Caches, Parks -> Herbal/Timber Groves, Taverns -> Provisions, Hardware Stores -> Iron Ingot Chunks).
- Interactive 40m Scavenging: Approach within 40m to scavenge landmark supplies with animated notifications.
🏰 Dynamic World Boss Strongholds & Mob Dens
- Fortified Boss Dens: Spawns fortified Stronghold markers at major road intersections with high-tier Elite Bosses (Orc Chieftain, Ancient Golem, Shadowfang Alpha).
- Elite Boss Battles & Blueprint Drops: Defeat world bosses to earn massive Gold, XP, and rare structure blueprints.
🚧 Road Barricades & Outpost Fast Travel
- Deployable Road Barricades (
tool_barricade): Fortify intersections with 50m safe-zone perimeters that completely suppress monster aggro.
- Deployable Road Outposts (
tool_outpost): Establish road checkpoints enabling instant Fast Travel between your Cozy Home Base Safehouse and Outposts.
🛡️ Equipment Exclusivity Engine (No Shared Equips)
- Strict Gear Exclusivity: A weapon or armor piece equipped by the player or an ally cannot be equipped simultaneously by anyone else unless extra unequipped copies exist in inventory.
- Roster & Backpack Integration: Backpack item lists indicate which companions hold specific gear (e.g.
IN USE (Willow (Weapon))) and prevent duplicate equipping with clear warning alerts.
- Companion Equipment Suite: Both Fighters and Harvesters can now equip weapons and armor from the backpack. Added dedicated
[Unequip Weapon] and [Unequip Armor] buttons to retrieve gear at any time.
🏹 Companion Bow Ranged Combat & Arrow Ammo
- Long-Distance Engagement (60m): Companions equipped with a Bow fire arrows from up to 60m away, holding position without walking into melee danger.
- Arrow Ammo Requirements: Each bow shot consumes 1 Wooden Arrow (
ammo_arrow) from inventory.
- Melee Immunity from Distance: When attacking from afar (> 25m), the companion takes zero retaliation damage from melee monsters.
- Empty Quiver Safety: If arrows run out, companions notify the player and fall back to low-damage unarmed melee strikes if engaged up close.
⚔️ Harvester Hostile Encounter Decisions (Push Through vs. Run Away)
- Random 50/50 Encounter Roll: When a Harvester on patrol encounters a hostile monster within 45m, it rolls a decision:
- Push Through: Continues steadily along its route to destination; fights back with equipped weapon/tool/fists only if struck in melee range (< 20m).
- Run Away: Turns and retreats 80m in the opposite direction along the road to safety before resuming patrol.
- Locked Commitment (Anti-Flip-Flop): The decision is locked for the duration of that encounter so Harvesters never jitter or alternate between running and walking.
🧭 Natural Long-Range Wander Patrol & Smart Obstacle Foraging
- Consistent Road Patrol Routes: Companions now establish 500m–750m forward street patrol routes, maintaining steady heading and realistic travel across the map.
- Visual Corridor Opportunistic Scanning (65m): As harvesters patrol along roads, they visually scan for valid matching resource nodes within a 65m corridor.
- Target Lock-In (Zero Distractions): When a node is spotted, the harvester commits to that node and approaches it directly along streets without abandoning it.
- Anti-Obstacle Watchdog & Unreachable Node Avoidance: If an approach is blocked (e.g. node inside a building, private yard, or impassable fence), the companion retries up to 2 times. If still blocked, it marks the node as unreachable for 90s, alerts the player, and smoothly resumes its long-range patrol.
- Dynamic Cargo Return State: Harvesters with full cargo switch status to
Dropping off load 📦 and return to the player/vault to deposit before resuming patrol.
🎯 Companion Task Persistence & Focused Goal Commitment
- Persistent Target Locking: Harvesters and Fighters lock onto their chosen target resource node or monster upon selection and stay committed to that exact goal until completion.
- Eliminated Mid-Route Distraction: Companions no longer re-scan and abandon targets mid-walk when another node/monster happens to be slightly closer.
- Depletion & Completion Cleanup: When a resource node is completely harvested or a monster is defeated, the companion cleanly disengages its commitment and chooses the next nearest target.
- Threat Evasion Priority: If an immediate hostile threat approaches within danger range, companions evade temporarily while preserving their general objective.
🛰️ Real-Time GPS Driving Tracking
- Smooth Real-Time Coordinate Following: Removed testing teleport locks on Android, enabling full continuous GPS tracking while driving in the car.
- High-Frequency GPS & Network Updates: Configured 1-second / 0-meter high-accuracy location listener for buttery-smooth car movement along roads.
- Dynamic Camera Following: The map camera automatically glides and follows your vehicle's physical location.
- Android 12+ Fine & Coarse Location Support: Updated runtime permission handshake to request both fine and coarse permissions.
- Cloud Sync Position Protection: Background cloud sync preserves the device's live GPS coordinates so syncing never resets your location while driving.
🔄 Android Multitasking State Sync & OTA Updates
onResume() Auto-Refresh: Returning to the GeoRPG Android app or web client instantly refreshes game state, synchronizes with the Cloud Database, and checks for updated APKs.- Dynamic OTA Upgrade Dialog: Instant notification of new releases with changelog and direct install link.
🧭 Companion Road Navigation & Target Pathing Visualizer
- Street-Following Navigation: Companions navigate along real street networks, turns, and intersections just like the player vehicle.
- Target Walking Path Visualizer: Renders color-coded dashed pathlines along the street and custom 🎯 destination pins for all active allies.
- Off-Screen Viewport Edge Radar: Floating radar pills (
🧺 Valon (380m)) pinned to the screen edges track companions across town with 1-tap focus navigation.
🏗️ Deployable Structures Deck
- Deploy Deck Action Bar: 1-tap deployment of Sentry Turrets, Wood/Ore Harvesters, Market Stand, and Cozy Home Vault (with 50m safe zone and 20-slot storage vault).
⚡ Engine Performance & Zero Latency
- Network-Free Simulation Loop: Replaced repetitive remote OpenStreetMap API queries during game ticks with instant local AI movement calculations, eliminating background network bottlenecks.
- LRU Coordinate & Route Caching: Implemented in-memory LRU Coordinate and Path Polyline caching for instantaneous road snaps and pathfinding.
- Debounced Cloud Database Sync: Continuous vehicle movement and keystrokes now save instantly to local storage while debouncing cloud database writes (max 1 sync per 3s), eliminating server rate limiting and connection congestion.
- Instant Click-To-Drive: Added strict 1.2s route timeout guards and instant direct interpolation fallbacks so clicking on the map immediately starts vehicle motion.
- Zero-Delay Profile Bootstrap: Player HUD, map markers, companions, and monsters now render instantaneously upon login without waiting for remote network promises.
🔄 App-Switch Auto-Refresh & OTA Upgrade Checks
- Seamless Multitasking Recovery: Whenever you switch applications on your device and return to GeoRPG, the game automatically re-initializes and refreshes the application state.
- Background Cloud Database Synchronization: Refreshes local player profile with the server, ensuring real-time multi-device consistency.
- Real-Time Map & Companion Refresh: Automatically re-renders placed turrets, safehouse vault, markets, active harvesters, and nearby procedural nodes immediately upon focus.
- Instant OTA Upgrade Verification: Checks for newly published APK builds from the server each time you return to the app, offering one-tap update installation.
⚔️ Creature Popup Retention & Debug Monitor Parity
- Creature Attack Popup Persistence: Melee and Bow attack dialogs stay open indefinitely on map ticks without automatically closing.
- Monster Spawn & Respawn Debug Monitor: Real-time floating HUD card tracking active mob counts, slot regeneration countdowns, and the 10-second post-combat immunity grace window.
🛡️ Multi-Device Save & Conflict Protection
- Cross-Device Synchronization Safety: Prevents stale local saves from overwriting newer cloud database progress between Android, Desktop Web, and Mobile Web.
- Interactive Profile Conflict Modal: If divergent stats are detected on login or startup, prompts the player with side-by-side comparison cards to choose [☁️ Use Cloud Profile] or [📱 Keep Local Profile].
👥 Companion Status Overhaul
- Explicit "Put Away" State: Companions stored in the roster display as
"Put Away" and do not clutter the map.
- Dynamic "Following" vs "Idle" Transitions: Following allies automatically switch to
"Idle" when stopping near your vehicle (≤15m) and resume "Following" when driving.
- Map Active Allies Filter: Map tab only lists currently active allies in the field.
🛠️ Creature Popup & Monster Spawn Debug Monitor
- Creature Popup Retention: Creature interaction popups now remain open without disappearing during map tick refreshes.
- Monster Respawn Debug Monitor: Real-time countdown timer displaying exact seconds remaining for each monster slot.
🧭 Off-Screen Companion Radar
- Interactive edge radar indicators appear on screen boundaries when companions roam outside camera view.
- Tapping an edge radar badge smoothly pans and focuses the camera on that companion.
🧺 Dedicated Harvester Tools & Smart AI
- Harvester Tool Prerequisite: Deploying Harvesters requires equipping Harvester - Wood or Harvester - Ore tools.
- Automated 5-Item Cargo Cap: Harvesters automatically return to the player and deposit cargo into inventory upon reaching 5 items.
- Threat Avoidance: Harvesters detect nearby hostile monsters (120m) and navigate away to safety.
- Distinct Icons: Harvesters feature dedicated basket icons (🧺) and emerald green status badges.
⚔️ Fighter NPCs & Gear Mastery
- Vibrant Cyan/Blue Identity: Fighters feature swords icons (⚔️) and cyan status rings.
- Critical HP Retreat: When ally HP reaches ≤ 20/100, they disengage and retreat in Follow mode.
- Potion Healing: Directly administer Health Potions (+50 HP) to companions via the Manage Gear panel.
📲 Over-The-Air (OTA) APK Updater
- Android app checks the live web server for updates on launch and displays update prompts with changelog details.
🚗 Overhead Health Bars & Street Centerlines
- Player vehicle permanently displays an overhead health bar with name and HP numbers (100/100 HP).
- Damaged monsters (HP < Max HP) render overhead health progress bars with exact numeric readouts.
- Integrated strict OpenStreetMap highway centerline road clamping for all companion navigation.
🏰 Deployable Structures & Combat Balancing
- Deploy Defensive Turrets, Safehouse Home Vaults, and Trading Markets directly on the map.
- Balanced NPC drop rates (5% across all monsters, 10% from Stone Golems).
- Removed legacy Stone Hatchet; added Battle Axe and Hunting Bow recipes.
📖 Categorized History Log & Vehicle Controls
- 3 dedicated history log sub-tabs: ⚔️ Battle Log, 🗺️ Game Log, and 🎁 Loot Log.
- Spacebar emergency brake for instant vehicle stopping.
- Flee distance pushback prevents immediate monster re-engagement.
🌍 Initial Launch
- Real-time OpenStreetMap geolocation gameplay, GPS location tracking, monster aggro battles, crafting forge, and Google Account authentication.