ItemsAdder
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. |
- Voxel Store — Available on the BTC Studio Voxel store.
The ItemsAdder Extension integrates ItemsAdder functionality into TypeWriter, allowing you to track custom block interactions and furniture usage within your quests and scripts.
Features
- Block Tracking — Track breaking and placing of custom blocks.
- Furniture Events — Trigger events when interacting with furniture.
- Precise IDs — Use namespace-aware IDs (e.g.,
my_pack:ruby_block). - Quest Integration — Use custom content as quest objectives.
Entries
- Events — Block Break: Trigger on break. Block Place: Trigger on place. Furniture Break: Trigger on break. Block Interact: Trigger on click. Furniture Interact: Trigger on click. Furniture Place: Trigger on place. Furniture Pre-Place: Trigger before placement. Custom Entity Death: Trigger when a custom entity dies.
- Objectives — Break Block: Quest objective. Place Block: Quest objective. Break Furniture: Quest objective. Place Furniture: Quest objective.
Facts
Read the player state directly in criteria: itemsadder_holding_item_fact, itemsadder_item_count_fact, itemsadder_item_usages_fact, itemsadder_item_durability_fact, itemsadder_looking_at_block_fact, itemsadder_standing_on_block_fact, itemsadder_looking_at_furniture_fact, itemsadder_hud_visible_fact, itemsadder_crop_age_fact, itemsadder_crop_fully_grown_fact.
Variables
Show ItemsAdder data in any text: itemsadder_item_in_hand_id_variable, itemsadder_item_property_variable, itemsadder_looking_at_block_id_variable, itemsadder_standing_on_block_id_variable, itemsadder_looking_at_furniture_id_variable, itemsadder_font_image_variable, itemsadder_registry_ids_variable.
Inventory
Work with ItemsAdder items by ID: itemsadder_give_item_action, itemsadder_remove_item_action, itemsadder_on_item_pickup_event, itemsadder_on_item_drop_event, itemsadder_on_item_consume_event.
User guide
- 1. Explore Entries — Start with Block Break, Block Place, Furniture Interact, or Break Furniture, then add the matching item facts, variables, and actions.
Technical Details
This extension requires the ItemsAdder plugin installed on the server.
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.