Troubleshooting

The configuration shows a warning or error

Open DA_ADS_SaveSystemConfig. Verify that the selected classes inherit from the expected ADS parents, that the version is at least 1, that the manual index is between 0 and 999, that the number of automatic slots is between 1 and 5, and that the timeout is between 2 and 20 seconds. Also verify the thumbnail dimensions and quality.

If the configuration asset is missing, verify its exact path: /ADS_SaveSystem/Config/DA_ADS_SaveSystemConfig. The system uses native fallback values, but the editor reports this condition.

Saving fails or times out

Make sure that every registered participant responds to On Save Requested by calling Set Part Saved with the received context. A single participant that responds with Success set to false, forgets to respond, or keeps a different context can cause the operation to fail. Check the reason received by On Save Completed: it can notably report a timeout, a failed participant, or a disk-write failure.

Loading does not restore data

Verify that the same participants are registered for loading and respond to On Load Requested with Set Part Loaded. Confirm that the data read comes from the correct save class and that your Blueprint variables are marked SaveGame. If the saved level must be opened, let the system complete the transition or use Apply Pending Load in a custom world-preparation flow.

A slot cannot be found or is invalid

Check its type and index with Is Slot Index Valid, and its existence with Does Slot Exist. Do not try to delete or copy the profile slot. For an unexpected name, check the configured prefixes: no separator is added automatically.

An old save requests conversion

Implement conversion in a child of ADS Project Save Behavior, then assign it in the configuration. After Handle Need Convert, call Continue Convert or Cancel Convert. A save created with a newer format version cannot be loaded by an older version of the project.

Thumbnails are missing

Enable thumbnail capture in Save Slot, then check the dimensions, JPEG quality, and default image in the configuration. Get Thumbnail returns the default image when the stored thumbnail is unavailable or unreadable; it can return a null value if no fallback image is configured.

For the default thumbnail, also make sure the configuration Data Asset is added to the assets to cook, as explained in the Installation section.