End of support notice: On May 20, 2026, AWS will end support for AWS SimSpace Weaver. After May 20, 2026, you will no longer be able to access the SimSpace Weaver console or SimSpace Weaver resources. For more information, see AWS SimSpace Weaver end of support.

Use the SimSpace Weaver app SDK to work with snapshots

You can use scripts provided in the SimSpace Weaver app SDK (minimum version 1.13) to create and use snapshots.

The SimSpace Weaver app SDK organizes your simulations by project. You can start multiple simulations from a single project. Each of those simulations uses the same schema and app .zip files. The SimSpace Weaver app SDK scripts place the assets for a simulation in a specific Amazon S3 bucket based on the project name, AWS account number, and AWS Region. The scripts work with snapshot files located in a snapshot folder at the root of that bucket. The Amazon S3 URI to the snapshot folder has following form:

s3://weaver-project-name-lowercase-account-number-artifacts-region/snapshot

If you want to use a different Amazon S3 bucket, see the following alternative ways to work with snapshots.

Use the SimSpace Weaver app SDK to create a snapshot

To create a snapshot, your simulation must be in the STARTED state. The snapshot creation starts after the current tick completes. SimSpace Weaver stops sending ticks to the apps but the clock status still indicates STARTED. The simulation status changes to SNAPSHOT_IN_PROGRESS. After the snapshot is finished, the simulation state changes back to STARTED and the apps receive ticks again.

SimSpace Weaver creates the snapshot file in the artifacts bucket for your project.

Use the SimSpace Weaver app SDK to start a simulation from a snapshot

When you use an app SDK script to start a simulation from a snapshot, the scripts create a new simulation name the same way they do for starting a simulation without a snapshot.

Your snapshot file must exist in the snapshot location in Amazon S3 with the following Amazon S3 URI:

s3://weaver-project-name-lowercase-account-number-artifacts-region/snapshot

The app .zip files must be in the same location they were when the snapshot was created.

SimSpace Weaver creates a new simulation resource, initializes the State Fabric with entity data stored in the snapshot, starts new instances of the same spatial and service apps that were running when the snapshot was created, and sets the clock to the appropriate tick. You must start custom apps separately through the normal process.

The start-from-snapshot script is the snapshot version of the start-simulation script. Just like the start-simulation script, the start-from-snapshot script doesn't start the clock for you. You must start the clock separately.

Use the SimSpace Weaver app SDK to quick start a simulation from a snapshot

You can quick start a simulation from a snapshot. This is similar to a quick start without a snapshot.

Your snapshot file must exist in the snapshot location in Amazon S3 with the following Amazon S3 URI:

s3://weaver-project-name-lowercase-account-number-artifacts-region/snapshot

The app .zip files must be in the same location they were when the snapshot was created.

SimSpace Weaver creates a new simulation resource, initializes the State Fabric with entity data stored in the snapshot, starts new instances of the same spatial and service apps that were running when the snapshot was created, and sets the clock to the appropriate tick. You must start custom apps separately through the normal process.

The quick-start-from-snapshot script is the snapshot version of the quick-start script. Just like the quick-start script, the quick-start-from-snapshot script starts the clock for you. It also starts the view app for the pathfinding sample project.

Use the SimSpace Weaver app SDK to list snapshots for a project

You can use the list-snapshots script to list the snapshots for a project. This script lists the files in the snapshot folder for the project. Projects are unique to the SimSpace Weaver app SDK, so you can only do this with the app SDK scripts and only for projects. The script assumes that all files in the snapshot folder on Amazon S3 are snapshot files. If you move or delete files from the folder then those files won't appear in the list.