> For the complete documentation index, see [llms.txt](https://taylordev.gitbook.io/simpledatastores-rblx/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://taylordev.gitbook.io/simpledatastores-rblx/package-versions/version-7.md).

# Version 7

{% hint style="success" %}

## CURRENT VERSION

You are viewing the most recently updated version!
{% endhint %}

* <mark style="color:green;">**NEW FEATURE**</mark>**&#x20;-** Added Custom Data Module to redirect player data from Roblox DataStoresService to any ModuleScript to process and further manipulate player data.
* <mark style="color:green;">**NEW FEATURE**</mark>**&#x20;-** Added CanSaveBackpack new setting called 'AutoDetectTools'. This is an experimental that will automatically search as much of the game files as possible to find tools/gear that the player can have saved in their backpack/inventory. Additionally, if you give the tool a bool attribute named "ignore" then it will continue to not save that tool.
* <mark style="color:green;">**NEW FEATURE**</mark>**&#x20;-** Added "DataSlotPrefix" to have a prefix word, phrase or infomation at the start of your datastore ending in the UserId. REMEMBER, even with this update it's always best to only use the package once per game to prevent reaching Roblox data store request limits. (E.G. "PlayerData-" would return PlayerData-(UserId) in save slot, can help with data migration)
* <mark style="color:green;">**NEW FEATURE**</mark>**&#x20;-** Introducing Data Loss Prevention settings! This includes optional settings to enhance user actions based data loss prevention. Methods to prevent data loss on systematic ends are NOT included as a setting and are just hard-coded.
* <mark style="color:green;">**NEW FEATURE**</mark>**&#x20;-** Added "SaveOnWorldSpaceRelocation" data manipulation tag which will listen for player data being move from the player instance to somewhere else in the game space and will continue the saving process as normal despite not being associated with the player itself. Good for making creation/creative games that focus on free-form for example.
* <mark style="color:green;">**NEW FEATURE**</mark>**&#x20;-** Added AutoTablePropretiesSave which if you don't want to manually input priorities of instances to save during the serialisation process then you can now use AutoTablePropretiesSave to save everything automatically
* <mark style="color:blue;">**CHANGES**</mark>**&#x20;-** Introducing a fully revamped Data Saving System! Player data will no longer be saved until the player actually leaves and/or closes the game. This should drastically reduce the number of data store requests being key requirement for games with a larger server size. Instead, if a player dies or any other reason for saved data to be changed, it will be saved to the game system directly and only when the player actually leaves will it save to DataStoresService (or module script if using CustomDataModule)
* <mark style="color:blue;">**CHANGES**</mark>**&#x20;-** More code optimisations internally which should make the package/system easier to understand and better for further debugging if required.
* <mark style="color:blue;">**CHANGES**</mark>**&#x20;-** Visually improved documentation with new features such as tables to better organise infomation such as settings classes and possible errors with solutions, fixes to spelling mistakes, more in depth detailings and tutorial videos explaining each process for visual learner's.
* <mark style="color:blue;">**CHANGES**</mark>**&#x20;-** Documentation colour theme is now set to dark mode by default
* <mark style="color:blue;">**CHANGES**</mark>**&#x20;-** Enhanced Output Debugging has been deprecated and instead intergrated with Output Debugging. With this, all warning logs that came with the original OutputDebugging (Not including saved and retrieved player data infomation) are now enabled regardless due to their importance.
* <mark style="color:blue;">**CHANGES**</mark>**&#x20;-** Hard coded error's now have a corresponding error number which links to the Full errors list page to help finding errors and resolving them quicker and more efficient.
* <mark style="color:blue;">**CHANGES**</mark>**&#x20;-** CustomTablePropretiesSave now supports Color3, Udim2, Vector3, ColorSequence and Properties that contains additional attributes (e.g. FontFace). This will also prevent UTF-8 character errors that used to cause data loss because it couldn't correctly calculate these types.
* <mark style="color:blue;">**CHANGES**</mark>**&#x20;-** Additional value manipulation's such as SaveOnRejoin, SaveOnDeath will now use Tags. Please review the changes you may need to make to your pre-existing compatible: NO LINK YET
* <mark style="color:blue;">**CHANGES**</mark>**&#x20;-** The default saving method has been changed from "SetAsync" to "UpdateAsync" which should help prevent data over-writing (Does not affect CustomDataModule)
* <mark style="color:red;">**BUG FIXES**</mark>**&#x20;-** Fixed package not automatically reparenting itself to ServerScriptService and also fixed the warning log for when it does needs to reparent itself
* <mark style="color:red;">**BUG FIXES**</mark>**&#x20;-** Fixed some debugging log's and not implemented (This has happened alongside the full rework of error debugging)

**DOWNLOAD HERE:**&#x20;

{% file src="/files/O2KQdUaHYIDs6ZS4BfYp" %}

**Scoped User Ids Early Access Download:**&#x20;

{% file src="/files/gUpevQW02Og8BAWBboaQ" %}

{% hint style="warning" %}

## Roblox Based Programme Version Warning

Only use version 7.5 (EAP) if you and your game is currently enrolled into the Scoped User Id system. If not, then use version 7.4. There is no other technological differences!

\
Version 7.5 is only available here and is NOT currently available via te Creator Store until Roblox updates the scoped user update.

\
\
**UPDATE TO WARNING:**

We are still unsure if Player.UserId will start returning Scoped User Id's following the update. Once we have confirmation on that, a decision to make version 7.5 the recommended version will be decided and publicly announced.
{% endhint %}

{% hint style="info" %}
**BETA TESTING RESULTS:** QA testing has passed with bugs noticed during testing but has been fixed and no new bugs have been found.

<mark style="color:$success;">**CURRENT STATUS:**</mark> <mark style="color:$success;"></mark><mark style="color:$success;">Released</mark>
{% endhint %}

{% hint style="info" %}
**What's coming next?**<br>

Next update, we'll be entering phase 2 of Data Loss Prevention implementation by implementing DataMethods setting which will allow you to choose which method you want top have data saved as.&#x20;

Thanks to this research for helping me better understand what people might expect for player data saving and storage! <https://devforum.roblox.com/t/datastores-and-instances-how-many-instances-should-i-have/4047691>
{% endhint %}

### Micro-Releases:

#### Version 7.1:

* <mark style="color:blue;">**CHANGES**</mark>**&#x20;-** Creator Store version is finally available again ([Can download here](https://create.roblox.com/store/asset/102645430267245/SimpleDataStores-Package-V7))
* <mark style="color:blue;">**CHANGES**</mark>**&#x20;-** Improved the simplicity of the Custom Data Stores system to now include a module script rather then trying to add a module script in. This also makes it more complient with Creator Store requirements

**Released:** February 5th 2026

{% hint style="danger" %}

## Issues with Version 7.1

A bug was found that may cause version 7.1 to be unstable and easily break. Please convert to version 7.3 or higher!<br>

<mark style="color:$success;">**If you are still using Version 7, you're version is still safe!**</mark>
{% endhint %}

#### Version 7.2:

* <mark style="color:red;">**BUG FIXES**</mark>**&#x20;-** Fixed a bug that would mistakenly try to access Custom Data Module values that were either rolled back or didn't launch

**Released:** March 12th 2026

{% hint style="danger" %}

## Issues with Version 7.2

A bug was found that may cause version 7.2 to be unstable and easily break. Please convert to version 7.3 or higher!

<mark style="color:$success;">**If you are still using Version 7, you're version is still safe!**</mark>
{% endhint %}

#### Version 7.3:

* <mark style="color:red;">**BUG FIXES**</mark>**&#x20;-** Fixed error code 2 which was misinterpreting the Custom Data Module system. If you are using version 7.1 OR 7.2 and you're reciving the following error, please convert to the latest version!\
  \
  **THE ERROR:** `Failed to retrieve data for player {PLAYER NAME}: game.ServerScriptService.SimpleDataStores Package:130: DataStore method '' not available (Error 2)`
* <mark style="color:red;">**BUG FIXES**</mark>**&#x20;-** Fixed saving errors returning as retrieval error's
* <mark style="color:blue;">**CHANGES**</mark>**&#x20;-** After popular demand for a while now, SimpleDataStores is finally available on GitHub!\
  <https://github.com/TaylorDevGD/SimpleDataStores-RBLX-LiteEdition/tree/main>

**Released:** March 19th 2026

#### Version 7.4:

* <mark style="color:blue;">**CHANGES**</mark>**&#x20;-** SaveOnWorldSpaceRelocation Data Manipulation tag can now save descendants getting reparented in and out of the folder / value&#x20;
* <mark style="color:red;">**BUG FIXES**</mark>**&#x20;-** Fixed Outdated Version Prevention mistaking studio for being an outdated place version. If you are on a version below 7.4, here is the code to replace on line 710:

```luau
if savedStats["LatestPlaceVersionID"] and savedStats["LatestPlaceVersionID"] > game.PlaceVersion and savedStats["LatestPlaceID"] == game.PlaceId and OutdatedVersionPrevention and not game.RunService:IsStudio() then
```

(The change here is at the end which prevents the script from kicking the player if they are running in studio)

**Released:** March 31st 2026

#### Version 7.5 (EAP):

* <mark style="color:blue;">**CHANGES**</mark>**&#x20;-** Migrated from Player.UserId data key storage to Player.User (ScopedUserId) following the recent Roblox update roll-out. It's best recommended to switch to this version soon as the full rollout is expected to release in October 2026 with many questions still not answered.

{% hint style="warning" %}

## Roblox Based Programme Version Warning

Only use version 7.5 (EAP) if you and your game is currently enrolled into the Scoped User Id system. If not, then use version 7.4. There is no other technological differences!\
\
**UPDATE TO WARNING:**

We are still unsure if Player.UserId will start returning Scoped User Id's following the update. Once we have confirmation on that, a decision to make version 7.5 the recommended version will be decided and publicly announced.
{% endhint %}

**Released:** June 11th 2026


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://taylordev.gitbook.io/simpledatastores-rblx/package-versions/version-7.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.