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. |
Public Members
Section titled “Public Members”| 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. |
See Also
Section titled “See Also”- namespace Stellar.Abstractions.Services