Waypoints, Portals and Travel

Waypoint map

WaypointMapTrigger builds and renders the in-game world map. Each node represents a destination zone; connections between nodes record travel routes.

The default map background is loaded from Resources/WorldMap/CrossworldsPortalMap. When WaypointMapTrigger has no author-assigned mapBackground, this sprite is loaded at runtime via Resources.Load.

Illustrated map mode

WaypointMapUI enters illustrated mode whenever it receives a non-null background sprite. In illustrated mode:

  • The title header is hidden.
  • DrawConnections and DrawBarrierPlaceholder are skipped; routes are implied by the map artwork rather than drawn as lines.
  • Node hit zones are 64 ร— 64 pixels (28 ร— 28 in plain mode).
  • Node markers render as invisible hit areas; a gold highlight appears on pointer-enter. No icon or colored ring is drawn in the resting state.
  • Node positions are mapped onto the aspect-ratio-correct rectangle of the displayed sprite rather than the raw panel bounds (GetDisplayedMapRect).

The current scene is determined from PlayerIdentity.Local.gameObject.scene.name when a local player exists, falling back to SceneManager.GetActiveScene().name.

Waypoint nodes

Node IDDisplay nameSceneNotes
hubHUBHUBReturn to the Hub
darkwoodDARKWOODDarkwood
gatheringGATHERING ZONEGathering Zone
brightwoodBRIGHTWOODโ€”Placeholder forest zone
boneyardBONEYARDBoneyard
pvpPVP ZONEPVPZONEOpen combat
toujamTOUJAM BASINToujam Basin
ashenASHEN WASTELANDAshen Wastelands
neimosNEIMOSโ€”Placeholder southwest region

All nodes except Brightwood and Neimos are unlocked = true. The color field on the PVP ZONE node is a red accent (0.82, 0.20, 0.16), distinguishing it visually from other nodes.

Node connections

FromToNotes
hubgathering
gatheringdarkwood
brightwooddarkwooddashed
darkwoodboneyard
boneyardpvpdashed
boneyardtoujam
toujamashen
neimosdarkwooddashed

Dashed connections indicate routes that are not yet fully traversable or are conditional. In illustrated mode, connection lines are not rendered client-side.

HubReturnSpawnPoint

HubReturnSpawnPoint is the spawn-point authority for zone arrivals and respawns. Each spawn point carries a spawnId string. When transitioning a player to a scene, the system finds the HubReturnSpawnPoint whose spawnId matches the arrival ID, then places the player there.

Randomized spawn (PVP zone): When the destination scene is "PVPZONE" and multiple HubReturnSpawnPoint objects match the requested ID (or multiple exist in the scene when no ID matches), ChooseSpawn selects one at random. All other scenes always use the first match.

Fallback order:

  1. First matching HubReturnSpawnPoint by spawnId.
  2. Any HubReturnSpawnPoint in the scene when no ID match exists.
  3. Any NetworkStartPosition in the scene.
  4. null (player is placed at origin).

Portal transitions

PortalTransition handles client-side scene-change requests triggered by the player walking into a portal trigger volume. The scene and spawn ID are configured per-portal in the Inspector.


Related: Zones, Scenes and Multi-Zone ยท GM Console and Tools