Builder guide

Help

Learn how to build scenes, entities, actions, events, and changing story worlds.

πŸ“š Event Reference

πŸ”€ Available Event Conditions

Attempt Count
Compare how many times a specific action has been attempted.
Attempts are counted whether the action succeeds or fails, making this useful for repeated tries or escalating responses.
Entity Is At
Check whether an entity is at the specified location.
Useful for determining whether an item or character has been moved before allowing an event to continue.
Entity Is Not At
Check whether an entity is not at the specified location.
Use this to verify that an entity has left a location or has not yet been moved there.
Player Is At
Check whether the player is at the specified location.
You can also check the player's preposition or current activity to create more specific conditions.
Player Is Not At
Check whether the player is not at the specified location.
Use this to prevent events from occurring while the player is in a particular place or position.
Success Count
Compare how many times a specific action has succeeded.
Use this when an event should occur only after an action has been completed successfully a certain number of times.

⚑ Available Event Effects

Add to Inventory
Move the selected entity into the player's inventory.
Use this when the player takes, receives, earns, or discovers an item they should carry with them.
Change Scene
Move the player directly to another scene.
Use this for scene transitions, transportation, falls, cutscenes, or other events that move the player to a new location.
Empty Inventory
Remove all items from the player's inventory.
Use this when the player loses their belongings, begins a new sequence without equipment, or has their inventory reset.
Message
Display a message to the player.
Use messages to describe the result of an action, provide feedback, reveal information, or explain why something could not happen.
Move Entity To
Move the selected entity to a new scene, entity, or position.
Use this to relocate characters or items, place one entity inside another, or change an entity's position after an event.
Move Player To
Move the player to the selected entity's location.
The entity's starting preposition and player activity are applied automatically. For example, the player could be placed on a chair while sitting, or in a boat while standing.
Remove from Inventory
Remove the selected entity from the player's inventory.
Use this when an item is dropped, consumed, given away, destroyed, or moved somewhere else.
Set Entity Description
Replace the selected entity's current description.
Use this when an entity changes in a way the player should notice, such as a door opening, a lamp turning on, or an object becoming damaged.
Set Scene Description
Replace the description shown when the player looks around.
Use this when the scene itself changes, such as rising water, spreading fire, changing weather, or a newly revealed area.
Set State
Update one state on the selected entity.
Use this for individual changes such as locking a door, revealing an item, changing a counter, or updating a custom state.
Stop Action
Stop processing the current action.
Ends the current action immediately. All remaining events and effects are skipped.