Skip to content
Version 2.32.0
↓ Get the launcher

SocialLocation structure

A player’s scene location as carried by SocialData.scene_data (zproto.SceneData). Every member defaults to 0 when its wire field is absent.

In-game (release_3.7) the level_* fields were the LIVE ones — level_map_id/level_pos tracked the player while map_id/pos stayed stale (apparently the last world/return position; a player inside a dungeon reported map_id = the town and level_map_id = the dungeon). Prefer the Current* members, which pick the level fields when set and fall back to the map fields.

public struct SocialLocation : IEquatable<SocialLocation>
parameter description
MapId Scene/map id from scene_data.map_id (observed stale — see remarks).
SceneLayer Scene layer from scene_data.scene_layer.
LineId Server line (channel shard) from scene_data.line_id — the in-game “Line N”.
Pos World-space position from scene_data.pos (x/y/z; observed stale — see remarks).
Dir Facing from scene_data.pos.dir (observed always 0 — no facing for far players).
SceneAreaId Scene area id from scene_data.scene_area_id (pairs with MapId).
LevelMapId Level (instance) map id from scene_data.level_map_id; 0 outside a level.
LevelPos Position inside the level from scene_data.level_pos (x/y/z).
LevelAreaId Area id inside the level from scene_data.level_area_id (field 19; pairs with LevelMapId).
ReceivedAtMs Framework server clock (ServerNowMs domain, Unix ms) when the reply carrying this location arrived; 0 when it arrived before the first server-time sync. Stamped by the framework cache, not the wire.
name description
SocialLocation(…) A player’s scene location as carried by SocialData.scene_data (zproto.SceneData). Every member defaults to 0 when its wire field is absent.
CurrentAreaId { get; } The area id in CurrentSceneId: LevelAreaId when in a level, else SceneAreaId.
CurrentPos { get; } The player’s position in CurrentSceneId: LevelPos when in a level, else Pos.
CurrentSceneId { get; } The scene the player is in now: LevelMapId when set, else MapId.
Dir { get; set; } Facing from scene_data.pos.dir (observed always 0 — no facing for far players).
LevelAreaId { get; set; } Area id inside the level from scene_data.level_area_id (field 19; pairs with LevelMapId).
LevelMapId { get; set; } Level (instance) map id from scene_data.level_map_id; 0 outside a level.
LevelPos { get; set; } Position inside the level from scene_data.level_pos (x/y/z).
LineId { get; set; } Server line (channel shard) from scene_data.line_id — the in-game “Line N”.
MapId { get; set; } Scene/map id from scene_data.map_id (observed stale — see remarks).
Pos { get; set; } World-space position from scene_data.pos (x/y/z; observed stale — see remarks).
ReceivedAtMs { get; set; } Framework server clock (ServerNowMs domain, Unix ms) when the reply carrying this location arrived; 0 when it arrived before the first server-time sync. Stamped by the framework cache, not the wire.
SceneAreaId { get; set; } Scene area id from scene_data.scene_area_id (pairs with MapId).
SceneLayer { get; set; } Scene layer from scene_data.scene_layer.