Datastoria
AI-native ClickHouse console for your cluster diagnostics and query generation, optimization and data visualization.
Last verified:
What is Datastoria?
DataStoria is a Visual Studio Code extension that enables Roblox developers to browse, edit, and debug Roblox Data Stores directly from their editor without leaving VS Code. It connects to the Roblox Open Cloud API v2 to provide a comprehensive data store explorer with time-travel debugging capabilities, revision diffs, and entry editing features.
Key features include a dedicated sidebar in the Activity Bar with a file-tree view for browsing data stores, lazy loading for efficient navigation, pagination for large data stores, automatic scope discovery, and persistent search filtering by key prefix. The extension allows viewing entries as read-only JSON documents with syntax highlighting, editing entries, deleting entries, incrementing values, and comparing revisions side-by-side using VS Code's built-in diff editor.
DataStoria is specifically designed for Roblox game developers who need to manage player data, leaderboards, settings, and other persistent game data stored in Roblox DataStores. It supports both Standard Data Stores and provides context for Ordered Data Stores, works with Production and Staging universes, and includes universe stats showing data store inventory and Roblox limits reference.
The extension emphasizes security by using VS Code's SecretStorage API to store API keys in the OS keychain (macOS Keychain, Windows Credential Manager, or Linux libsecret) rather than plaintext settings files. It has zero runtime dependencies, uses Node.js native fetch for HTTP requests, and the production bundle is approximately 47 KB.
Datastoria pricing
Pricing model: Freemium
Free - The extension is free to use on the Visual Studio Code Marketplace with no paid tiers. It is released under Apache 2.0 license. Users only need their own Roblox Open Cloud API v2 key (created at create.roblox.com/credentials) which is free through Roblox's creator platform.
Datastoria pros
- Browse Roblox Data Stores directly in VS Code sidebar
- Time-travel debugging with full revision history
- Compare revisions side-by-side using VS Code diff editor
- Edit, delete, increment, and copy entry values
- Lazy loading prevents performance issues with large datasets
- Pagination with Load More for large data stores
- Automatic scope discovery without manual configuration
- Persistent search filter for key prefix filtering
- View entry at specific timestamp using ISO 8601 date
- One-click restore of past revisions as current version
- Universe stats showing data store inventory and limits
- API keys stored securely in OS keychain, not plaintext
- Zero runtime dependencies, ~47 KB production bundle
- Supports both Production and Staging universes
- Full JSON syntax highlighting for entry viewing
- CodeLens shows version status and value size percentage
- Uses Roblox Open Cloud API v2 with proper scopes
Datastoria cons
- Ordered Data Store support not yet implemented
- No bulk export to JSON or NDJSON currently available
- Cannot trigger daily snapshots through the extension
- Cannot delete or undelete data stores yet
- Requires manual API key setup with specific scopes
- No unit or integration tests included yet
- Manual testing required via F5 Extension Development Host
- Universe ID must be found separately in Creator Hub
Frequently asked questions about Datastoria
What is DataStoria?
DataStoria is a VS Code extension that connects to the Roblox Open Cloud API v2 to give you a full data store explorer with time-travel debugging, revision diffs, and entry editing — all without leaving your editor. It lets you browse, edit, and debug Roblox Data Stores directly from VS Code's Activity Bar.
How do I get started with DataStoria?
Install the extension from the VS Code Marketplace, open the DataStoria sidebar by clicking its icon in the Activity Bar, add an API key (the welcome view guides you), add a universe by providing a display name, Universe ID, and selecting the API key, then expand the tree to explore your data stores. Find your Universe ID in the Creator Hub under your experience settings.
What API key scopes are required?
DataStoria uses the v2 Open Cloud API requiring these scopes: universe-datastores.control:list (list data stores), universe-datastores.objects:read (read entries), universe-datastores.objects:list (list entries), universe-datastores.objects:create/update (create/update entries), universe-datastores.objects:delete (delete entries), universe-datastores.versions:list (list revisions), and universe-datastores.versions:read (read revisions). Create keys at create.roblox.com/credentials.
How does time-travel debugging work?
Every entry keeps a revision history. Expand an entry in the tree to see past versions with relative timestamps and a retention countdown. You can compare with current version (opens VS Code's diff editor side-by-side), compare any two revisions via QuickPick, view at a specific timestamp by entering an ISO 8601 date, or restore a past revision with one click to write it as the new current version.
Where are my API keys stored?
API keys are never stored in plaintext. DataStoria uses VS Code's SecretStorage API which delegates to your operating system's secure credential store: macOS Keychain, Windows Credential Manager, or Linux libsecret (GNOME Keyring). Only a display name is stored in settings — the actual key material lives in the OS keychain and never appears in VS Code settings files, workspace configs, or extension logs.
What are Roblox Data Store limits?
Data store name, entry key name, and scope name are limited to 50 characters each. Entry value limit is 4 MB (4,194,304 B). Read throughput is 25 MB/min per key, write throughput is 4 MB/min per key. Revision retention is 30 days after overwrite. Storage formula is 100 MB + 1 MB × lifetime users. DataStoria surfaces these limits contextually in tooltips, CodeLens, and validation messages.
Does DataStoria support Ordered Data Stores?
Ordered Data Store support is on the roadmap but not yet implemented. The current version shows Ordered Data Stores in the tree view but the feature is marked as pending. Standard Data Stores are fully supported with CRUD operations, revision history, and time-travel debugging.
How large is the extension?
The production bundle is approximately 47 KB. The extension has zero runtime dependencies and uses Node.js native fetch for HTTP requests along with VS Code's built-in APIs for everything else, making it lightweight and fast.
Can I view entry history?
Yes. Click any entry to open it as a read-only JSON document with syntax highlighting. Expand the entry in the tree to see its revision history with version IDs, relative timestamps (e.g., '2m ago', '1h ago'), and a retention countdown. Each revision shows compare and restore buttons for time-travel debugging.
What is coming in future updates?
The roadmap includes: Ordered data store support, bulk export to JSON/NDJSON, daily snapshot trigger, data store delete/undelete functionality, unit and integration tests, and official Marketplace publishing. Already completed are: data store browsing with tree view, entry CRUD operations, revision history and time-travel debugging, diff comparison, search/filter by key prefix, and universe stats with limits reference.