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.
DrawConnectionsandDrawBarrierPlaceholderare 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 ID | Display name | Scene | Notes |
|---|---|---|---|
hub | HUB | HUB | Return to the Hub |
darkwood | DARKWOOD | Darkwood | |
gathering | GATHERING ZONE | Gathering Zone | |
brightwood | BRIGHTWOOD | โ | Placeholder forest zone |
boneyard | BONEYARD | Boneyard | |
pvp | PVP ZONE | PVPZONE | Open combat |
toujam | TOUJAM BASIN | Toujam Basin | |
ashen | ASHEN WASTELAND | Ashen Wastelands | |
neimos | NEIMOS | โ | 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
| From | To | Notes |
|---|---|---|
| hub | gathering | |
| gathering | darkwood | |
| brightwood | darkwood | dashed |
| darkwood | boneyard | |
| boneyard | pvp | dashed |
| boneyard | toujam | |
| toujam | ashen | |
| neimos | darkwood | dashed |
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:
- First matching
HubReturnSpawnPointbyspawnId. - Any
HubReturnSpawnPointin the scene when no ID match exists. - Any
NetworkStartPositionin the scene. 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