Skip to main content

Craftengine Quest State Artifact

Artifact storing per-player quest block and item state

Fields

FieldTypeDefaultDescription
artifactIdString—Unique ID generated by Typewriter for this artifact. SHOULD NOT BE CHANGED!

How to use it​

Create one artifact per quest chapter and point the Quest Zone Audience, Set Quest Block, Set Quest Furniture and Clear Quest State entries of that chapter at it. Zones that share an artifact are cleared together. Give unrelated quests their own artifact: the whole document is rewritten on each save.

Leave artifactId as generated. Changing it points the entry at a different stored document, and every recorded progress disappears from view without an error.

The state is a JSON document holding every player and every zone. Changes are kept in memory and written about two seconds after the last one, and at once when a player leaves a zone or the server shuts down.