Names and continuity

Two more optional parts decide how saves are labelled and tracked:

• name — the display name you see for a save.
• continuity — the stable identity that ties a save’s snapshots together over time, so renaming a file doesn’t split its history.

Both pick a value the same way, with an extractor.

Extractors

A bare-string extractor takes the value straight from the file or folder:

• stem — the name without its extension (Quicksave.sav → Quicksave).
• basename — the full name with extension (Quicksave.sav).
• relpath — the save’s path relative to the root, normalized.
• constant:VALUE — a fixed string, e.g. constant:main.

When the useful part is buried in the name, use the regex form to capture it:

name:
  regex:
    from: basename
    pattern: "^Slot([0-9]+)_.*\\.dat$"
    group: 1

continuity:
  regex:
    from: basename
    pattern: "^Slot([0-9]+)_.*\\.dat$"
    group: 1

from is what to match against (basename, stem, or relpath), pattern is the regex, and group is which captured group to use.

You can do this in the form, too — no YAML required: pick the source from the dropdown (that’s the from), then enter your pattern in the Regex field beside it. A Group field appears for choosing which captured group to use. Clear the Regex field and you’re back to the plain source.

Defaults you usually don’t set

Leave name and continuity out and they’re derived from your discover kind — which is right for almost every game:

The pattern behind the table: a save that’s a file is named by its stem; a save that’s a folder is named by its basename; a singleton is always just main. Continuity is the save’s relpath for everything except singleton.

For completeness, payload defaults to subtree and trigger defaults to same_as_payload, both covered on the payload, trigger, and ignore page. Set name or continuity yourself only when the defaults give you something unhelpful — a generated name you can’t tell apart, or an identity that breaks when the game renames files.