game.list_saves
Overview
- Returns save slots sorted by saved_time descending (newest first), one page at a time. Feed 'folder' (and 'file' when it differs) into game.load. The cached slot order is NOT trusted; the list is re-sorted by saved_time here. PAGED: only 'limit' entries (20 by default) are returned starting at 'offset'. A profile can hold hundreds of slots, so an unbounded dump would be tens of kilobytes per call. Because the payload is a bare array there is nowhere to put paging metadata inside it, so the total count, the offset and the next offset are reported in the result MESSAGE, e.g. '20 of 366 save slot(s) (offset 0, limit 20). More available: pass offset=20 for the next page.' By default this reads the already-scanned slot list and does no disk IO. Pass refresh=true only when the save directory changed underneath the client - a rescan reads a thumbnail file per slot, rebuilds every slot object (invalidating the cache the load-list UI holds) and deletes incomplete fork directories. Higher-version saves are listed (see is_higher_version); loading one opens a fork-warning popup that ui.dismiss refuses to touch, so clear it with ui.click_popup_button.
Metadata
| Field | Value |
|---|---|
| Display | List Save Files |
| Category | game |
| Access | Public |
| Scope | B1Standalone |
| Tags | Experimental |
| Aliases | — |
Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| include_autosave | bool | no | true | Include AutoSave slots |
| include_broken | bool | no | false | Include slots flagged as broken |
| limit | int | no | 20 | Maximum number of entries to return [1-500]. |
| offset | int | no | 0 | Index of the first entry to return, 0-based. Negative values are treated as 0. Use the next offset reported in the result message to page. |
| refresh | bool | no | false | Rescan the save directory from disk before listing. Blocking disk IO with side effects (rebuilds every slot object and deletes incomplete fork directories) - leave false unless the files changed. |
Usage
await inzoi.cli.execute('game.list_saves', {
include_autosave: true, // optional
include_broken: false, // optional
limit: 20, // optional
offset: 0, // optional
refresh: false, // optional
});