Roadmap

Project scaffolding, database schema, deployment pipeline, and theme system.

• FastAPI app with Jinja2 templates
• PostgreSQL schema (17 tables)
• Dark/light theme with warm amber palette
• Apache2 reverse proxy + SSL
• systemd service + deploy scripts
• Landing page with gameplay preview

Passwordless auth via WebAuthn passkeys with passphrase fallback.

• WebAuthn passkey registration & login
• Passphrase set/change/remove
• Multi-device passkey management
• JWT sessions with HMAC challenge signing
• Rate limiting on auth endpoints
• Security headers (CSP, HSTS, X-Frame)

Super-admin interface for system management.

• Stats overview (users, characters, campaigns, tokens)
• User management (passes, active/paid/admin toggles)
• User character details modal
• OpenRouter API key (encrypted storage)
• Model selection and connection testing
• System announcements
• Token usage breakdown by model

Character creation, stat progression, and equipment management.

• Character creation flow (name, backstory)
• 7-stat system (STR, DEX, CON, INT, WIS, CHA, LCK)
• Fractional stat gains from actions
• 10 equipment slots (Diablo-style)
• Inventory and item management
• Character profile page
• Campaign history on character sheet
• Energy regen rate display

The core pipeline that turns player messages into game events.

• Intent extraction from player messages
• Fate check (reject dictated outcomes)
• World state assembly for context
• Energy accounting per action
• Response generation pipeline
• Stat progression triggers
• Scene scoring / fate roll system (1-100)
• Truncation detection and graceful handling
• Word count bonus from equipped items
• Pre-computed outcomes in narrator prompt

Campaign lifecycle, locations, NPCs, and scenarios.

• Campaign creation and selection
• Location graph with connections
• NPC templates (enemies, merchants, companions)
• Scenario triggers (puzzles, quests, events)
• Campaign session state tracking

The gameplay chat and help system.

• Gameplay chat with narrator/player styling
• Character-limit scaling with level
• Token tracking per message
• Paragraph rendering for narrator responses
• Stable scroll-to-bottom during narration
• Help chat (separate from gameplay)
• Chat history and session replay
• Read-only chat log viewer from character sheet

Auto-generate world content when players explore beyond the known.

• Item fabricator service (LLM-generated items)
• Starter item kits for new campaigns
• Location fabrication (new rooms, dungeons)
• NPC generation with personalities
• Scenario seeding from world state

Admin workshop for building the game world.

• Campaign builder with images and themes
• Location editor with image uploads
• NPC creator with avatars and roles
• Scenario editor (encounters, puzzles, quests)
• Item template creator with rarity tiers
• Spell creator with stat requirements
• Image upload system for all entity types
• Factory stats dashboard
• Stat boost and range editors for item templates
• Consumable effect builder (energy, buffs)
• Lore text, unique flag, and level cap fields

Diablo-style item generation with affixes, scaling, consumables, buffs, and inventory management.

• Item affix system (30 prefixes, 31 suffixes)
• Rarity-weighted stat scaling by character level
• Luck (LCK) stat affecting rarity and roll quality
• Master item roller pipeline (rarity → scaling → affixes → pricing)
• Consumable items with energy restore and buff effects
• Buff system (time-based and energy-budget expiry)
• Equipment buffs with gear breaking on budget exceed
• Refreshing Drink granted per campaign join
• Auto-equip system for item upgrades
• Inventory modal (items, equipment, buffs, activity log)
• Rarity-colored item cards with stat tooltips
• Diablo II-style hover tooltips (desktop)
• Item detail popup (click/tap anywhere)
• Item image generation via ImageRouter
• Item images shown on equipment slots and inventory (live updates)
• Activity logging for all item events
• Fabricator integrated with item roller pipeline
• Fabricator slot inference and normalization
• Equip slot shown on all item cards and popups
• Smart ring slot resolution (fills empty ring_2 before swapping ring_1)
• Equip/unequip feedback alerts and error handling in inventory modal
• Runtime icon validation (fallback for invalid Lucide icons from fabrication)
• Buff stat bonuses visible on character sheet

Achievement triggers, gacha rewards, titles, and tutorial onboarding.

• Achievement definitions with trigger events
• Achievement trigger engine (check_achievements)
• Rarity tiers (common to legendary)
• Title rewards from achievements
• Tutorial chain via achievement sequence
• Secret hidden achievements
• Achievement admin editor
• Achievement toast notifications
• Gacha loot table pulls from achievements
• Achievement display on character profile

Public-facing documentation, legal pages, SEO metadata, and sitemap.

• Game Mechanics page (13 documented systems)
• Terms of Service page
• Privacy Policy page
• Open Graph and Twitter Card meta tags
• JSON-LD structured data (WebApplication schema)
• Canonical URLs on all pages
• XML sitemap at /sitemap.xml
• Landing page hero redesign
• Footer with game and legal link sections

Email system for admin communications, mailing list, and password recovery.

• Mail gateway integration (gamingworld.uk)
• Admin inbox viewer (inbound & outbound)
• Admin compose with sender selection
• Encrypted API key storage
• Mailing list signup from landing page
• Mailing list toggle on account page
• Subscriber management in admin panel
• Password reset via email
• Unsubscribe page
• Contact emails (support@, info@gamingworld.uk)

Image generation for items, characters, and scenes with model tiers and admin controls.

• ImageRouter API integration with encrypted keys
• Item, character, and scene image generation
• Auto-fallback across multiple models on failure
• Admin-tier rate limits (5s cooldown, 200/day)
• Model tier selector (Free/Standard/Premium)
• Cooldown countdown modal with animated ring
• Admin generation log browser with filters
• Text-free prompts (no letters in generated art)
• WebP conversion and local storage
• Live image updates without page reload

Enemy encounters, combat resolution, and loot drops.

• Inject location enemy NPCs into narrator context
• Combat advantage calculation (stat comparison)
• Enemy defeated tag parsing and loot rolls
• NPC loot table format and drop system
• Enemy NPC fabrication for empty locations
• Energy cost per combat action
• Equipment modifier application in combat
• Death/defeat and recovery mechanics

Gold, shops, and the in-game economy.

• Gold currency on characters
• Merchant with daily rotating stock (12 items)
• Buy items from merchant (1.5x markup)
• Sell items to merchant (40% buyback)
• Consumables (potions, energy drinks)
• Item repair system (50% of value)
• Gold drops from gameplay encounters
• Trading between players

Magic system with learnable spells and abilities.

• Spell definitions with stat requirements
• Learn, equip, and unequip spells (hotbar of 4)
• Energy cost and cooldown mechanics
• Cast spells with buff application and healing effects
• Spell context injected into narrator system prompt
• Spellbook UI on character sheet with learn/equip/cast actions
• Narrator [SPELL_CAST] tag parsing in engine pipeline

Deep character identity with pronouns, race, class, religion, and AI-driven stat scaling.

• Identity fields: pronouns, honorific, body type
• Heritage: race, class, religion with presets + custom
• Character history free-text
• AI-generated character summaries for narration
• Stat scaling based on identity (base mods + growth)
• Random Soul generator (AI-powered)
• Multi-step character creation wizard
• Identity editing on character sheet
• Destiny card with stat profile narrative
• Narrator uses pronouns and identity summaries
• PvP battle narratives use character identity

PvP arena, shared campaigns, and player interactions.

• PvP Arena — challenge players from Town Square
• Power Level — composite meta-stat for matchmaking
• Battle engine — multi-round simultaneous combat
• Battle rewards (XP, gold, stat bonuses)
• Battle chronicle narratives
• Animated battle reveal with phased rounds
• Dice visualization and hit labels per round
• Rich multi-paragraph battle chronicles with character context
• Arena Record on character sheet
• Lazy-load battle detail with round-by-round display
• Shared campaign sessions
• Trading between players

Player interactions, messaging, and community features.

• Town Square character directory
• Player-to-player direct messaging
• Rate-limited message sending
• Message inbox and notifications
• Block/mute player functionality

Security audit, systemd hardening, backup automation, and code quality refactor.

• Auth error leakage fixed (generic messages)
• Path traversal protection on avatar deletion
• Systemd service hardened (ProtectSystem, NoNewPrivileges)
• Journal log rotation (500MB max, 30-day retention)
• N+1 query fixes (character sheet, town square)
• Engine refactored into 6 focused sub-functions
• Backup system: schema dumps, cron wrapper, retention policy
• Schema dump automation (just recipe + deploy hook)
• Security audit and backup strategy documentation

Stripe subscriptions, crystal currency, soul energy, and the crystal shop.

• Stripe payment integration (subscriptions + one-time)
• 4 subscription tiers (Free/Adventurer/Hero/Legend)
• Crystal premium currency with 5 purchase tiers
• First-purchase 2x crystal bonus
• Monthly Card (30 days of daily crystals)
• Crystal Shop (energy, gold, passes, wheel tokens)
• Soul Energy free gacha currency from gameplay
• Daily login rewards with streak bonuses
• Soul Point conversion (1,000 SE = 1 spin)
• Payments admin tab (Stripe keys, price IDs, diagnostics)
• Shop page with subscriptions and crystal packages
• Webhook payment processing with signature verification

Collectible spirits in household objects with stat growth boosts, gacha wheel, and merge system.

• Home Base page with equipped Companion slots
• Canvas spinning wheel (8 slices, server-side resolution)
• 5 rarity tiers with growth boosts and passive stats
• Merge system: 5 duplicates → level up (max +5)
• Set bonuses (2-piece and 3-piece thresholds)
• Companion growth boosts multiply stat gains in gameplay
• Companion passives in Power Level calculation (1.5x weight)
• Level-up bonuses affected by Companion growth boosts
• Pity system (soft 50, hard 100, legendary 200)
• 30+ seed Companion templates with themed sets
• Factory Companions tab with CRUD and seed generation
• 7 Companion achievements (Home Sweet Home through Lucky Spin)
• Spirit Wheel visual overhaul (portraits, highlights, 3D win card)
• Spirit Wheel coordinate fix (trig-based slice rendering)
• Showcase 3D card effects (Vanilla Tilt, flip transitions, ghost rise)
• Smooth spin landing (no normalize jump), floating controls overlay
• Rarity-colored bumper gradients on outer slice edges

XRPG Engine baseline — portable text RPG framework for multi-instance deployment.

• Instance branding separated from engine code
• Smoke test for deployment validation
• Full backup and remote transfer tooling
• Instance configuration guide

Enhanced visual quality across all pages with decorative art, glass effects, and animations.

• Decorative card art system (parchment, metallic, stained glass, gift)
• Enhanced button system (action, purchase, daily, glass, save, danger)
• Decorative elements (ribbons, seals, stripes, shimmer animations)
• Shop buttons with glass/3D effects and pulse animations
• Account page buttons upgraded with enhanced styling
• Inbox messages with player avatars and chat-bubble layout
• Campaign history cards with background images
• Identity portrait generation from full character identity
• Battle arena visual overhaul with generated artwork and 3D banners
• Decorated PvP challenge modal with VS screen and arena backdrop
• Town Square cards with campaign bg, equipment images, race/class
• Enhanced profile modal with hero banner and identity badges
• Inbox character avatars, level badges, and race/class display
• Inventory modal overhaul (fancy tabs, consistent sizing)
• Character creation wizard visual polish
• Light mode opacity fix (universal art visibility)
• Art-backed character creation cards (races, classes, religions)
• Honorific & body type upgraded from pills to art cards
• Shop Current Tier badge redesign with frosted glass overlay
• Home Base premium currency grid with animated icon cards
• 45 new art assets (races, classes, religions, body types, honorifics, homebase)

Model tiers, cost tracking, and client support.

• Model tier system (Free/Freemium/Premium)
• Per-user text and image tier controls
• Player-controlled tier selector (own-key users)
• Cost estimation and tracking per request
• Stripe rate limiting on all payment endpoints
• Player registration cap with mailing list gate
• Electron desktop app
• Mobile-optimized interface
• Push notifications for campaign events