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.
LoginManagerauthenticates againstcrossworlds-auth,CharacterSelectManagerpicks a class, and the Mirror client connects tocrossworlds-server(KCP :7777). The login screen has a PROD | DEV environment toggle; dev mode routes auth to:3010and 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
_Containerscene and loads zones additively viaZoneManager; 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 viaPendingChangeCharacterflag). The Options panel includes a SFX volume slider (SfxVolumeSettings, stored insfx_volumePlayerPrefs 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-progressaccepts client-sent level/xp/gold (JWT-gated). - Quest progress isn't persisted โ server-authoritative but in-memory; resets on
crossworlds-serverrestart. Intentional while Quest Forge is in testing. See Quests & Quest Forge. - Login always spawns at HUB โ
RodNetworkManagerhardcodeszoneName = SceneNames.Huband clearshasSavedPosat login. Players drop onto HUB'sHubReturnSpawnPointregardless 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)
| Service | Port | State |
|---|---|---|
crossworlds-auth | 3000 | active โ auth + game API |
crossworlds-server | 7777/UDP | active โ Unity/Mirror game server |
crossworlds-dashboard | 4000 | active โ admin/GM |
rod-realtime | 5000 | active โ Socket.io co-op |
spacetimedb | 3500 (local) | active |
uptime-kuma | 3001 | active โ monitoring |
rod-server unitAn 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