Craftengine Set Quest Block
Change what one player sees at a spot, inside a quest zone — a block or a piece of furniture
Fields
| Field | Type | Default | Description |
|---|---|---|---|
artifact | Ref<QuestStateArtifactEntry> | — | Where this artifact's state is stored. Must be the artifact the zone uses. |
zoneId | String | — | The zone this deviation belongs to, as named on the zone audience. |
group | Ref<GroupEntry> | — | The group the zone shares its state with, if any. Must match the zone audience. |
location | Var<Position> | ORIGIN | The block to change. For furniture, the yaw orients it.With rotation |
blockId | Var<String> | — | A CraftEngine block or furniture id ('namespace:id'), or a vanilla material. Empty clears the spot. |
kind | QuestBlockKind | AUTO | How the id is read. Auto tries furniture first — set it by hand when one id names both. |
variant | Var<String> | — | For furniture, the variant to show. Leave empty to let CraftEngine pick one. |
Common TypeWriter fields (criteria, modifiers, triggers)
| Field | Type | Default | Description |
|---|---|---|---|
criteria | List<Criteria> | empty | — |
modifiers | List<Modifier> | empty | — |
triggers | List<Ref<TriggerableEntry>> | empty | — |
How to use it
Writes a change for the triggering player, or their group, only. The world is not touched. It lasts until the player leaves the zone or the state is cleared, and is handed back when they return.
blockId can name a CraftEngine block, a CraftEngine furniture or a vanilla material. kind says how to read it:
kind | Behaviour |
|---|---|
AUTO | Furniture first, then block. Right for any id that names one kind of thing. |
BLOCK | Always a block (CraftEngine block or vanilla material). |
FURNITURE | Always furniture. An unknown id is refused with a line in the log. |
A block id is resolved through CraftEngine, so the player sees the real custom block. A furniture id raises a ghost: a real, interactable piece of furniture that exists for that player alone and has no collision for anyone. The yaw of location turns it and variant picks its variant. An empty blockId clears the spot (air, no ghost).
artifact, zoneId and group must match the zone audience. Without a zoneId the action is skipped and a warning naming the entry is logged.
To change a piece of furniture the builder placed, such as an intact seal into a broken one, hide the world's piece with Set Quest Furniture and raise the broken one here on the same block.