AI Guide

Use this checklist when a coding agent is wiring Persistly into a game.

The checklist keeps AI integrations narrow and correct: create the project, use ps_test_ keys first, store saveId locally, sync on lifecycle events, and handle 409 conflicts explicitly.

Checklist

This should be followed in order.

01

Create a project and copy a ps_test_ runtime key.

02

Initialize the SDK with a runtimeKey and keep saveId local after create.

03

Create a save once and persist the returned saveId locally.

04

Load and sync only by saveId.

05

Store state locally first and sync on lifecycle moments, not every frame.

06

Handle 409 conflict by accepting the canonical server save and reconciling local edits.

07

Switch from ps_test_ to ps_live_ only in production builds.