HELIX Docs
Platform API

Memory Store

Volatile, low-latency storage shared across all instances of a world. TTL-required. Great for leaderboards, matchmaking, and hot counters — never the source of truth.

Helix.memoryStore is HELIX's volatile store: fast, shared across every running instance of your world, and always expiring. It's for live state that's cheap to lose. If you know Roblox, this is MemoryStore.

Planned — not yet available

Memory Store is on the roadmap, not yet shipped. Data Store (durable storage) is live today; Memory Store (volatile/TTL) lands in a later release. The API below is the intended surface — build durable state on Data Store now, and treat hot counters/leaderboards as a fast-follow. (For an interim hot counter, write to Data Store with the version-guarded update pattern.)

Never the source of truth

Every Memory Store entry requires a TTL and may vanish when it expires or under pressure. It has no economic authority — it cannot grant items or LIX. For anything that must survive, write to Data Store.

API

Prop

Type

Live leaderboard example

// record a score (atomic, ranked, shared across instances)
const board = Helix.memoryStore.sortedMap('round-scores');
await board.set(playerId, score, 300); // 5-minute TTL

// read the top 10
const top = await board.getRange({ limit: 10, descending: true });

Hot counter example

// count concurrent players in a zone without hammering Data Store
const inZone = await Helix.memoryStore.increment(`zone:${zoneId}`, 1, 60);

When to use which

NeedUse
Player progress, settings, owned stateData Store
Live leaderboard for a roundMemory Store sortedMap
Matchmaking / cross-instance handoffMemory Store queue
Hot counter (players in a zone)Memory Store increment
Anything you'd be upset to loseData Store

Reference

On this page