Implementation Status

What exists in the current build, in present tense โ€” no phases, no task numbers, no planned direction. This is a description of the version in front of us. When something is half-built or server-only, it says so.

Working in the client + server

  • Login โ†’ character select โ†’ world. LoginManager authenticates against crossworlds-auth, CharacterSelectManager picks a class, and the Mirror client connects to crossworlds-server (KCP :7777). The login screen has a PROD | DEV environment toggle; dev mode routes auth to :3010 and the game connection to :7778 (isolated dev stack, same VPS). See Login & Authentication Flow.
  • Five hero classes, indexed 0โ€“4 โ€” Marauder, Ironclad, Shadowblade, Cleric, Arcanist. Full spellbooks, passives, and ultimates in C#. Marauder (0), Cleric (3), and Arcanist (4) are accessible to all clients; Ironclad (1) and Shadowblade (2) are marked IN DEVELOPMENT in character select and require a GM testing override (unlockroster) to deploy. See Heroes & Classes ยท Ability Atlas & Synergies.
  • Server-authoritative combat โ€” enemy FSM (EnemyController), wave loop (WaveSpawner), world bosses (WorldBossController), status effects, deployables logic. See Combat Core & Loop ยท Enemies, Waves & Bosses.
  • Multi-zone world. The server boots an empty _Container scene and loads zones additively via ZoneManager; players occupy different zones on one process. See Zones, Scenes & Multi-Zone.
  • Persistence โ€” characters, inventory, progression (level/experience/gold), crafting, mastery โ€” through the Node API. Client singletons: InventoryManager, PlayerProgressManager, HeroMasteryManager. See Loot, Inventory & Crafting.
  • Self-bootstrapping UI โ€” combat HUD, chat, ESC menu, player list, nameplates, GM console. The ESC menu Change Character option disconnects from the game server and returns to character select without re-entering credentials (RodNetworkManager.ReturnToCharacterSelect(), JWT retained via PendingChangeCharacter flag). The Options panel includes a SFX volume slider (SfxVolumeSettings, stored in sfx_volume PlayerPrefs key, default 80%). See UI & HUD Systems ยท GM Console & Tools.
  • Hero mastery โ€” per-class XP with L6/L10 passive bonuses, live endpoints. See Progression & Hero Mastery.
  • AFK gathering + professions feeding Forge crafting. See Gathering & Professions.
  • Waypoint world-map travel, portals, hub return โ€” all routed through ZoneManager. See Waypoints, Portals & Travel.
  • Mount (Founder Bike) โ€” client-side rideable traversal. See Mounts & Traversal.
  • Audio, music, and game-feel juice (hitstop, screen shake, hit feedback). See Audio, Music & Game Feel.
  • NPC interaction โ€” forge, arena-entrance dialogue. See NPCs & Interaction.
  • Quests (Unity-native, in testing) โ€” a server-authoritative Mirror quest system authored with Quest Forge: kill / collect / interact / enter-area objectives, quest-giver dialogue, and gold/XP/item rewards. Progress is in-memory only (wiped on server restart). This is a separate system from the unused /api/quests/* endpoints below. See Quests & Quest Forge.
  • GM travel map โ€” GM mode now syncs to the client; press M anywhere to open a world-travel map to any zone. See GM Console & Tools ยท Waypoints, Portals & Travel.
  • Game feel โ€” hitstop, screen shake, hit feedback, floating damage text, centralized in FeelConfig. See Audio, Music & Game Feel.
  • Visual effects โ€” spell/ability VFX, ground-decal targeting indicators, hero/enemy/environment and login VFX. See Visual Effects & VFX Pipeline.

Scenes in the build (9)

LoginScene, CharacterSelect, HUB, Darkwood, Ashen Wastelands, Toujam Basin, GM Island, VoidDungeon, _Container. The build scene list is now derived from the Scenes-In-Build list (BuildScript.cs), so newly-added scenes no longer silently drop out of server/client builds.

Arena_Copper and Gathering Zone are still named in SceneNames.cs but have no scene file and are not in the build โ€” ZoneManager falls back to Hub if either is requested.

Server-side only (no client consumer in this repo)

The crossworlds-auth server exposes these, but the current Unity client has no code that calls them (no PartyManager, GuildPanelUI, or TalentTreeUI in the repo):

  • Talents โ€” /api/talents/* (tree, invest, respec)
  • **Quests (the API ones) โ€” /api/quests/* (available, accept, complete, progress). Unused** โ€” the game's actual quests run on the newer Unity-native system, not these. See Quests & Quest Forge.
  • Guilds โ€” /api/guilds/* (create, invite, leave, motd)
  • Leaderboards โ€” /api/leaderboard/* (damage, healing, mastery, waves)

Mastery, in contrast, is consumed client-side (HeroMasteryManager โ†’ /api/mastery/*), and quests are now consumed client-side too โ€” just via Mirror instead of these endpoints.

Partial / has sharp edges

  • Ability deployables โ€” mines/walls/zones have working logic (DeployableNet) but the prefabs don't exist, so they render only a server-side placeholder. Cast VFX, anims, and damage still replicate. See Ability Atlas & Synergies.
  • Player HP is client-side โ€” a hacked client can ignore damage. Kill rewards are validated server-side; the HP loop is not. See Known Issues & Tech Debt.
  • Progress saves are value-trusted โ€” save-progress accepts client-sent level/xp/gold (JWT-gated).
  • Quest progress isn't persisted โ€” server-authoritative but in-memory; resets on crossworlds-server restart. Intentional while Quest Forge is in testing. See Quests & Quest Forge.
  • Login always spawns at HUB โ€” RodNetworkManager hardcodes zoneName = SceneNames.Hub and clears hasSavedPos at login. Players drop onto HUB's HubReturnSpawnPoint regardless of the zone and coordinates saved in the DB. In-session zone travel (portals, waypoints) is unaffected.
  • SpacetimeDB runs on the VPS (127.0.0.1:3500) but is not part of the documented client flow.

Live services (VPS)

ServicePortState
crossworlds-auth3000active โ€” auth + game API
crossworlds-server7777/UDPactive โ€” Unity/Mirror game server
crossworlds-dashboard4000active โ€” admin/GM
rod-realtime5000active โ€” Socket.io co-op
spacetimedb3500 (local)active
uptime-kuma3001active โ€” monitoring
โ„น๏ธ Legacy rod-server unit

An old rod-server.service unit also exists on the box (separate from the active crossworlds-server). Confirm which unit you're operating on before restarting the game server. See Build & Deploy.


Related: Known Issues & Tech Debt ยท Architecture & Topology ยท Build & Deploy