minecraft-persistence

Files (6)

• REFERENCE.md
• SKILL.md
• contract.json
• request.md · examples/
• scenario.md · examples/
• durable-trades.md · references/

SKILL.md (first lines)

# Persistent state and recovery

Identify authoritative state and durability needs before choosing storage. PDC suits metadata on supported holders; queryable/shared accounts may require a database. JDBC drivers are dependencies, not part of Java's standard library.

- Choose stable UUID/key ownership and schema versioning. Distinguish an item instance, stack quantity, player profile and island account; do not use names or lore as identifiers.
- Ordinary blocks do not expose item-style PDC. Store custom plant state using a persistent world/chunk/coordinate index and remove it when blocks change.
- Capture immutable snapshots on the owner thread; persist off-thread with ordered writes. A stale asynchronous save must not overwrite newer state.
- Use transactions/constraints for money or shared balances when available. Saving a player and saving an external ledger are not one atomic operation.
- For file storage, write a temporary file and use an appropriate atomic replacement where supported. Preserve previous data on parse failure; migration must be rerunnable or guarded.
- Back up consistent database/world/account state and test restoration. Include WAL/auxiliary files correctly rather than copying a live database file blindly.

## Verification

Inject failure between commits, retry a migration and simulate out-of-order saves. Restore into an isolated runtime and reconcile balances/items.

## Example request

A balance reverts after logout because an older asynchronous save finishes last.

## Focused reference

Read [references/durable-trades.md](references/durable-trades.md) when handling the detailed cases above.

## Contract and evidence

Read [contract.json](contract.json) for applicability and required outputs; [REFERENCE.md](REFERENCE.md) for evidence and version limits. No listed verified release means resolve the target before generation. [examples/scenario.md](examples/scenario.md) contains a documented evaluation prompt, not proof that an agent passed.

From Ngducok/Minecraft-skills, MIT.

More from Ngducok/Minecraft-skills