Craft Engine

Official compatibility

Element	Reference
TypeWriter	Required. Use the official TypeWriter release supported by the extension release.
Related extensions	Install the related extensions listed on this page before using entries that depend on them.

The CraftEngine Extension integrates the core engine with the CraftEngine plugin. It allows you to use CraftEngine's custom blocks and furniture as quest objectives or event triggers.

Entry Library

Events

Triggers based on CraftEngine interactions.

• Block Break — Trigger on custom block break.
  • Block Place — Trigger on custom block place.
  • Block Attempt Place — Trigger when placement is attempted, including refused placement.
  • Furniture Break — Trigger on furniture break.
  • Furniture Place — Trigger on furniture place.
  • Furniture Attempt Place — Trigger when furniture placement is attempted.
  • Furniture Hit — Trigger when a player hits CraftEngine furniture.

Objectives

Quest tasks for custom assets.

• Break Block — Track broken custom blocks.
  • Place Block — Track placed custom blocks.
  • Break Furniture — Track broken furniture items.
  • Place Furniture — Track placed furniture items.
  • Replace Block — Track blocks the player swaps for another one.

Actions

Change the world from a sequence.

• Replace Block — Swap the block or furniture at a location for another one, or clear it.
  • Place Block — Place a CraftEngine block at a location.
  • Remove Block — Clear the CraftEngine block at a location.
  • Place Furniture — Place furniture, optionally carrying its own state.
  • Remove Furniture — Remove the furniture anchored on a block.

Audiences

Group players by what they are touching, holding or sitting on.

• Sitting on Furniture — In audience while seated on furniture.
  • Holding Custom Item — In audience while carrying a CraftEngine item.
  • Furniture Proximity — In audience while near a piece of furniture.

Per-player quest state

Give each player their own version of a zone, without ever modifying the world.

A quest zone can record what a player breaks, places or changes — blocks and furniture alike — show it back to that player alone, and hand it to them again when they return — while every other player keeps seeing the zone exactly as it was built. A zone can also share its state across a group, so a party clears a room together. The world itself is never written to, so leaving a zone resets it at no cost and nothing is left half applied if the server stops mid quest.

• Quest State Artifact — Where the per-player state of one or more zones is stored.
  • Quest Zone Audience — Records and restores a player's — or a group's — own blocks, furniture and items for a zone.
  • Set Quest Block — Change what one player sees at a spot: a CraftEngine block, or a piece of furniture that exists for them alone.
  • Set Quest Furniture — Hide one of the world's furniture from one player, by its id, or show it again.
  • Clear Quest State — Drop a player's recorded state and hand their stashed items back.

Facts

Read the player state directly in criteria: craftengine_holding_item_fact, craftengine_item_count_fact, craftengine_cooldown_active_fact, craftengine_cooldown_remaining_fact, craftengine_item_cooldown_fact, craftengine_looking_at_block_fact, craftengine_standing_on_block_fact, craftengine_looking_at_furniture_fact.

Variables

Show CraftEngine data in any text: craftengine_item_in_hand_id_variable, craftengine_item_property_variable, craftengine_looking_at_block_id_variable, craftengine_standing_on_block_id_variable, craftengine_looking_at_furniture_id_variable, craftengine_registry_ids_variable.

Inventory

Work with CraftEngine items by ID: craftengine_give_item_action, craftengine_remove_item_action, craftengine_on_item_pickup_event, craftengine_on_item_drop_event, craftengine_on_item_consume_event.

Technical Details

This extension requires the CraftEngine plugin to provide custom blocks and furniture.

User guide

• 1. React to Events — Use event entries to trigger mechanics when things happen: on_craftengine_block_break_event, on_craftengine_block_place_event, on_craftengine_furniture_break_event. → on_craftengine_block_break_event → on_craftengine_block_place_event

Troubleshooting

The extension is not visible

Check that the installed release matches the supported TypeWriter release and that the related extensions listed in the compatibility section are present.

An entry is missing

In the Typewriter Web panel, use the Search bar or the + button to find or create the entry with its exact identifier. Entry IDs and field names are case-sensitive; do not translate them.

The entry saves but nothing happens

Check that the entry is connected to the trigger, command, objective, event, or menu interaction required by its type. Test with optional permissions and criteria removed, then add them back one at a time.

An integration does not work

Verify the dependency and version shown in the extension card, then check the server log for the first error. Do not replace a missing dependency with a similarly named plugin unless the extension source explicitly supports it.