⚡ TriggerCommand & TriggerCommand-UI
The Ultimate Entity, Block, Item & Logic Orchestrator for Minecraft Forge
A professional, high-performance event-driven logic framework for Minecraft 1.20.1. Bind reactive command sequences to in-game actions, coordinate volumetric 3D areas, manipulate NBT items, and visualize your entire logic flow in real-time with an interactive node graph editor.
🌐 Universal Server & Client Compatibility
- Dedicated Servers: Drop
triggercommand-1.0.jarinto your server'smods/directory. That's it! - Vanilla Client Friendly: Players on 100% vanilla clients can join without installing the mod. The server safely handles missing client channels (
displayTest = "IGNORE_SERVER_VERSION"). - Optional Client GUI: Players who have the mod installed on their client can run
/triggercommand showto unlock the full graphical node visualizer and editor.
🚀 Key Features
- 👤 Entity Triggers (
/entity): Attach logic to damage taken, attacks, landings from falls, mounting, dismounting, deaths, or custom entity groups (@group). - 🧱 Coordinate & Block Triggers (
/block): Detect block interactions, breakages, placement, or state changes with recursive NBT and Tag matching (#minecraft:chests{...}). - 📐 3D Monitored Regions (
/blockarea): Volumetric zone detection with spatial chunk partitioning for high-efficiency entry (when_enter), exit (when_exit), and presence (when_stay). - 🗡️ Portable Item Triggers (
/item trigger): Embed persistent execution logic directly into the NBT of items held in hand, with configurable lore visibility. - 🔗 Aliases & Macro Sub-routines (
/alias): Reusable@aliascommands with automatic multi-command chaining and recursive cycle detection. - 📦 Trigger Groups (
/triggergroup): Group distributed triggers across blocks, areas, entities, and aliases under unified sequence names for synchronized resets and multi-level hierarchy traces. - 📊 Interactive Visual Graph (
/triggercommand show): Inspect root triggers at the bottom flowing into actions and aliases at the top. Includes right-click backward cycling on suggestion helpers and real-time tooltips!
⚙️ Unified Command Syntax & Execution Modes
All creation and modification commands follow a standardized, predictable parameter structure:
... <repeat> <mode> [permission] run <command>
<repeat>: The execution limit. Use-1for infinite triggers,0for single execution, orNfor exact repetition counts.<mode>:- General Triggers:
instant(same tick),tick(next tick deferred),each(per member),group(once for the whole set). - Item Triggers:
instant(no item cost),tick(deferred, no cost),single(consumes 1 item),all(consumes full stack).
- General Triggers:
[permission]: (Optional) Elevation level (0to4). If omitted, the mod dynamically inherits the sender's permission level.run <command>: Any vanilla command or a custom macro called via@alias_name.
📋 Quick Command Cheat Sheet
| Command | Action | Example |
|---|---|---|
/entity set |
Attach trigger to entity/selector | /entity set @a when_land -1 instant 2 run summon area_effect_cloud ~ ~ ~ |
/block set |
Attach trigger to block coordinate | /block set 100 64 100 #minecraft:chests when_interact -1 instant 2 run summon lightning_bolt ~ ~ ~ |
/blockarea set |
Define 3D detection volume | /blockarea set gate 10 60 10 15 65 15 minecraft:air when_enter -1 instant 2 run tellraw @s "Welcome!" |
/item trigger set |
Bind action to held item | /item trigger set when_use -1 single 2 run summon fireball ^ ^ ^3 |
/alias add |
Create reusable macro | /alias add fireball_spell -1 instant 2 run summon fireball ^ ^ ^2 |
/triggergroup define |
Create logical group | /triggergroup define dungeon_crypt |
/triggergroup trace |
Visual chat trace of group | /triggergroup trace dungeon_crypt |
/triggergroup reset |
Centralized reset of counters | /triggergroup reset dungeon_crypt |
/triggercommand show |
Open graphical node editor | /triggercommand show |
🖥️ Visual Interface (TriggerCommand-UI)
When installed on the client, /triggercommand show opens a rich graphical environment:
- Category Tabs: Filter between All, Entities, Blocks, Areas, Items, Aliases, and Groups.
- Context-Sensitive Form: Dynamically adapts input fields and automatically hides irrelevant boxes.
- Quick Suggestion Buttons (
[ > ],[ @ ],[ # ]): Left-click to cycle forward through valid events, selectors, or block tags. Right-click to cycle backwards effortlessly. - Localized Tooltips: Instant hover hints translated according to your Minecraft language settings (English and Spanish out-of-the-box).
📦 Specifications & Installation
- Minecraft Version: 1.20.1
- Mod Loader: Forge 47.2.0 or higher
- Java Version: Java 17
- Server Installation: Place the JAR into
mods/. - Client Installation: Optional, required only for the
/triggercommand showGUI.
📜 License & Credits
- Developer: MisterBartra, Bartra
- License: All Rights Reserved

