Sand Raiders of Sophie

overlayed.sand.readyForGameEvents() must be called before any events will be emitted.

Each event is marked with its retention — see Retained vs transient.

logged_in

Retained Menu accountId and player_joined.playerId are different ids and never match. Use platformId to tie the logged-in account to an in-match player.

interface LoggedInEvent {
	accountId: string;
	displayName: string;
	platformId: string;
	playfabId: string;
}

{
	"accountId": "1717066",
	"displayName": "GhettoAmmo",
	"platformId": "76561198996870832",
	"playfabId": "A77C293DA30BEDDE"
}

game_state_changed

Retained Menu The expedition status. menu means no expedition is active.

interface GameStateChangedEvent {
	state:
		| "menu"
		| "waiting_for_players"
		| "matchmaking"
		| "match_found"
		| "in_progress"
		| "loot_division"
		| "extracted"
		| "all_left"
		| "aborted"
		| "failed"
		| "decayed"
		| "invalid";
}

{
	"state": "in_progress"
}

party_changed

Retained Menu

interface PartyChangedEvent {
	joinCode: string;
}

{
	"joinCode": "K7QP2M"
}

party_member_joined

Retained Menu Key: accountId One per party member, including the local player. displayName can arrive empty; a later event for the same accountId fills it in.

interface PartyMemberJoinedEvent {
	accountId: string;
	displayName: string;
	platformId: string;
	playfabId: string;
	characterId: number;
	isCaptain: boolean;
}

{
	"accountId": "1717066",
	"displayName": "GhettoAmmo",
	"platformId": "76561198996870832",
	"playfabId": "A77C293DA30BEDDE",
	"characterId": 88421,
	"isCaptain": true
}

party_member_left

Transient Releases: party_member_joined

interface PartyMemberLeftEvent {
	accountId: string;
}

{
	"accountId": "1717066"
}

storage_changed

Retained Menu A full storage snapshot. crowns, mechanicalParts, pneumaticParts, and computingModules are totals for items that also appear in items — adding them to the items total double-counts.

interface StorageChangedEvent {
	slotsUsed: number;
	slotsTotal: number;
	crowns: number;
	mechanicalParts: number;
	pneumaticParts: number;
	computingModules: number;
	items: Array<{
		definition: string;
		amount: number;
	}>;
}

{
	"slotsUsed": 12,
	"slotsTotal": 40,
	"crowns": 2500,
	"mechanicalParts": 8,
	"pneumaticParts": 3,
	"computingModules": 1,
	"items": [
		{
			"definition": "item_coinCrown",
			"amount": 2500
		},
		{
			"definition": "item_resourceMetal_t1",
			"amount": 8
		}
	]
}

storage_item_changed

Transient

interface StorageItemChangedEvent {
	definition: string;
	amount: number;
	delta: number;
}

{
	"definition": "item_coinCrown",
	"amount": 2500,
	"delta": 500
}

tech_tree_changed

Retained Menu isAvailable means researchable right now, so an already-unlocked node reports it false.

interface TechTreeChangedEvent {
	unlocked: number;
	total: number;
	nodes: Array<{
		id: string;
		name: string;
		tier: number;
		isUnlocked: boolean;
		isAvailable: boolean;
	}>;
}

{
	"unlocked": 2,
	"total": 3,
	"nodes": [
		{
			"id": "8f14e45f-ceea-467a-9575-0d1e1b0b2c33",
			"name": "Cannon T4",
			"tier": 3,
			"isUnlocked": true,
			"isAvailable": false
		},
		{
			"id": "c4ca4238-a0b9-2382-0dcc-509a6f75849b",
			"name": "Hull T2",
			"tier": 1,
			"isUnlocked": false,
			"isAvailable": true
		}
	]
}

tech_tree_item_unlocked

Transient

interface TechTreeItemUnlockedEvent {
	id: string;
	name: string;
	tier: number;
}

{
	"id": "8f14e45f-ceea-467a-9575-0d1e1b0b2c33",
	"name": "Cannon T4",
	"tier": 3
}

walker_changed

Retained Menu The walker the account has built. walkerId matches trampler_acquired.masterServerId.

interface WalkerChangedEvent {
	walkerId: number;
	blueprintUniqueId: string;
	blueprintFile: string;
	firstNameIndex: number;
	secondNameIndex: number;
}

{
	"walkerId": 4471,
	"blueprintUniqueId": "b1d9e0f2-3c44-4a8e-9f21-77c0a5d6e881",
	"blueprintFile": "Dune Runner",
	"firstNameIndex": 12,
	"secondNameIndex": 3
}

match_started

Retained Match serverStartTime is when the match began, not when you joined it.

interface MatchStartedEvent {
	matchId: number;
	gameMode: "storm_dive" | "voyage" | "invalid";
	seed: number;
	serverStartTime: number;
	worldBounds: {
		minX: number;
		minZ: number;
		maxX: number;
		maxZ: number;
	};
	landmarks: Array<{
		id: string;
		name: string;
		position: {
			x: number;
			y: number;
			z: number;
		};
	}>;
}

{
	"matchId": 9001,
	"gameMode": "storm_dive",
	"seed": 12345,
	"serverStartTime": 1700000000000,
	"worldBounds": {
		"minX": -4096,
		"minZ": -4096,
		"maxX": 4096,
		"maxZ": 4096
	},
	"landmarks": [
		{
			"id": "fort_alpha",
			"name": "Fort Alpha",
			"position": {
				"x": 1024.5,
				"y": 62,
				"z": -337.25
			}
		}
	]
}

match_ended

Transient Releases: all match-level events

interface MatchEndedEvent {
}

{}

world_time_changed

Retained Match

interface WorldTimeChangedEvent {
	hour: number;
}

{
	"hour": 13
}

player_joined

Retained Match Key: platformId One per player on the player list, which keeps players after they disconnect — there is no leave event. playerId never equals logged_in.accountId; correlate on platformId.

interface PlayerJoinedEvent {
	playerId: number;
	username: string;
	platformId: string;
	playfabId: string;
}

{
	"playerId": 1717066,
	"username": "GhettoAmmo",
	"platformId": "76561198996870832",
	"playfabId": "A77C293DA30BEDDE"
}

extraction_added

Retained Match Key: extractionId Extractions can arrive throughout the match, not all at match_started.

interface ExtractionAddedEvent {
	extractionId: number;
	radius: number;
	position: {
		x: number;
		y: number;
		z: number;
	};
}

{
	"extractionId": 3,
	"radius": 25.5,
	"position": {
		"x": 1024.5,
		"y": 62,
		"z": -337.25
	}
}

extraction_removed

Transient Releases: extraction_added

interface ExtractionRemovedEvent {
	extractionId: number;
}

{
	"extractionId": 3
}

storm_changed

Retained Match Emitted on stage and state transitions only.

interface StormChangedEvent {
	stage: number;
	totalStages: number;
	state: "idle" | "delay" | "moving" | "invalid";
	endTime: number;
	radius: number;
	center: {
		x: number;
		y: number;
		z: number;
	};
	nextRadius: number;
	nextCenter: {
		x: number;
		y: number;
		z: number;
	};
}

{
	"stage": 1,
	"totalStages": 6,
	"state": "moving",
	"endTime": 1700000060000,
	"radius": 500,
	"center": {
		"x": 0,
		"y": 62,
		"z": 0
	},
	"nextRadius": 250,
	"nextCenter": {
		"x": 128.5,
		"y": 62,
		"z": -64.25
	}
}

inventory_changed

Retained Match Key: playerId What a player is carrying right now, one event per party member. Only the local player and their party are reported. playerId matches player_joined.playerId, not logged_in.accountId, which is the master server’s id and a string. Slots 0-15 are the fixed ones — 0 is the hand, 1 and 2 are weapons, 3 is armor, 4 is the backpack, 5-9 are tools and 10-15 are the belt. Anything higher is a grid slot. Empty slots are omitted, so slotsUsed is the length of slots. amount is the stack size for a stack but the loaded rounds for a weapon, and 0 for a container the player is holding. What a carried container holds is not reported.

interface InventoryChangedEvent {
	playerId: number;
	slotsUsed: number;
	slots: Array<{
		slot: number;
		definition: string;
		amount: number;
	}>;
}

{
	"playerId": 1717066,
	"slotsUsed": 3,
	"slots": [
		{
			"slot": 1,
			"definition": "item_semiAutomaticPistol_decreasedMag",
			"amount": 5
		},
		{
			"slot": 5,
			"definition": "item_pistolAmmo",
			"amount": 45
		},
		{
			"slot": 6,
			"definition": "item_energyBar",
			"amount": 3
		}
	]
}

inventory_slot_changed

Transient One slot of one party member changed. A slot that swapped what it holds reports the new stack arriving rather than the old one growing, so delta equals amount in that case. An emptied slot reports an empty definition, an amount of 0, and the negative of what it held.

interface InventorySlotChangedEvent {
	playerId: number;
	slot: number;
	definition: string;
	amount: number;
	delta: number;
}

{
	"playerId": 1717066,
	"slot": 5,
	"definition": "item_pistolAmmo",
	"amount": 45,
	"delta": 15
}

inventory_equipped_changed

Retained Match Key: playerId What a party member has in their hands. slot is the selected slot and definition is what sits in it, which is empty when the slot is. A slot of 255 means the game has not reported a selection yet.

interface InventoryEquippedChangedEvent {
	playerId: number;
	slot: number;
	definition: string;
}

{
	"playerId": 1717066,
	"slot": 1,
	"definition": "item_semiAutomaticPistol_decreasedMag"
}

trampler_acquired

Retained Match Key: tramplerId masterServerId matches walker_changed.walkerId when non-zero. creatorPlayerId is the blueprint’s author, not the driver, and matches player_joined.playerId.

interface TramplerAcquiredEvent {
	tramplerId: number;
	masterServerId: number;
	blueprint: string;
	creatorPlayerId: number;
	firstNameIndex: number;
	secondNameIndex: number;
}

{
	"tramplerId": 12,
	"masterServerId": 4471,
	"blueprint": "EXPEDITION_WALKER",
	"creatorPlayerId": 1717066,
	"firstNameIndex": 12,
	"secondNameIndex": 3
}

trampler_changed

Retained Match Key: tramplerId Emitted about every 10 seconds whether or not the trampler moved — a new event is not proof of motion.

interface TramplerChangedEvent {
	tramplerId: number;
	position: {
		x: number;
		y: number;
		z: number;
	};
	yaw: number;
	speed: number;
	velocity: {
		x: number;
		y: number;
		z: number;
	};
}

{
	"tramplerId": 12,
	"position": {
		"x": 1024.5,
		"y": 62,
		"z": -337.25
	},
	"yaw": 137.5,
	"speed": 8.25,
	"velocity": {
		"x": 8.25,
		"y": 0,
		"z": 0
	}
}

trampler_lost

Transient Releases: trampler_acquired, trampler_changed

interface TramplerLostEvent {
	tramplerId: number;
}

{
	"tramplerId": 12
}

​logged_in

​game_state_changed

​party_changed

​party_member_joined

​party_member_left

​storage_changed

​storage_item_changed

​tech_tree_changed

​tech_tree_item_unlocked

​walker_changed

​match_started

​match_ended

​world_time_changed

​player_joined

​extraction_added

​extraction_removed

​storm_changed

​inventory_changed

​inventory_slot_changed

​inventory_equipped_changed

​trampler_acquired

​trampler_changed

​trampler_lost

logged_in

game_state_changed

party_changed

party_member_joined

party_member_left

storage_changed

storage_item_changed

tech_tree_changed

tech_tree_item_unlocked

walker_changed

match_started

match_ended

world_time_changed

player_joined

extraction_added

extraction_removed

storm_changed

inventory_changed

inventory_slot_changed

inventory_equipped_changed

trampler_acquired

trampler_changed

trampler_lost