Config Manifest

The input_tracker_config manifest entry defines all keybind definitions and inventory buttons.

Configuration Properties

Global Settings

keybinds

"> Collection of keybind definitions for triggering actions on player input (F, Q, Shift, Ctrl, T, /, Hotbar).

inventoryButtons

"> Collection of persistent buttons to place in the inventory or crafting grid.

---

InputDefinition Object

Used for each keybind entry.

Field	Type	Default	Description
type	InputType	SWAP_HAND	The input type to listen for
enabled	Boolean	false	Enable or disable this handler
cancelAction	Boolean	false	Cancel the original game action
actions	List<Ref<ActionEntry>>	[]	Actions to execute when triggered
delay	Long	0	Delay in ticks before execution
cooldown	Long	0	Cooldown in ticks between triggers
dropCount	Int	1	For DROP: 1=single, -1=stack, >1=N items
hotbarSlot	Int	0	For HOTBAR_SLOT: slot index (0-8)
criteria	List<Criteria>	[]	Conditions for the trigger to fire

InputType Enum

Value	Key	Event
SWAP_HAND	F	PlayerSwapHandItemsEvent
DROP	Q	PlayerDropItemEvent
SNEAK	Shift	PlayerToggleSneakEvent
SPRINT	Ctrl	PlayerToggleSprintEvent
CHAT	T	AsyncChatEvent
COMMAND	/	PlayerCommandPreprocessEvent
HOTBAR_SLOT	1-9	PlayerItemHeldEvent

---

InventoryButton Object

Defines a persistent button in the inventory or crafting grid.

Field	Type	Default	Description
slot	Int	0	Inventory slot ID (0-40) or crafting grid (0-4)
item	Var<Item>	Empty	The item stack to display as the button
clickActions	List<ClickActionBinding>	[]	Actions grouped by click type
delay	Long	0	Execution delay in server ticks
isCraftingGrid	Boolean	false	If true, the slot refers to crafting grid IDs (0-4)
criteria	List<Criteria>	[]	Global conditions for the button to appear

ClickActionBinding Object

Binds a set of actions to a specific click type.

Field	Type	Default	Description
clickType	ClickType	LEFT	The click type that triggers these actions
actions	List<Ref<ActionEntry>>	[]	Actions to execute
criteria	List<Criteria>	[]	Conditions for this binding to fire

ClickType Enum

Value	Description
ALL	Matches any click (fallback)
LEFT	Left click (inventory + world)
RIGHT	Right click (inventory + world)
SHIFT_LEFT	Shift + left click
SHIFT_RIGHT	Shift + right click
DROP	Q key when hovering the button
DOUBLE_CLICK	Double click

---

Criteria Object

Standard Typewriter criteria — condition groups that must be met.

Each condition checks a ReadableFactEntry against an operator and value.

Field	Type	Description
fact	Ref<ReadableFactEntry>	The fact to check
operator	CriteriaOperator	Comparison operator (EQUAL, NOT_EQUAL, GREATER, etc.)
value	String	Expected value

---

Example Usage

input_tracker_config:
  id: "default"
  keybinds:
    - type: SWAP_HAND
      enabled: true
      cancelAction: true
      actions:
        - "open_menu_action"
      cooldown: 10
    - type: DROP
      enabled: true
      cancelAction: true
      dropCount: -1
      actions:
        - "drop_all_action"
  inventoryButtons:
    - slot: 0
      isCraftingGrid: true
      item:
        type: "COMPASS"
        name: "<green>Quest Tracker"
      clickActions:
        - clickType: LEFT
          actions:
            - "open_quest_log_action"
        - clickType: RIGHT
          actions:
            - "track_objective_action"
    - slot: 8
      item:
        type: "CLOCK"
        name: "<gold>Menu"
      clickActions:
        - clickType: LEFT
          actions:
            - "open_server_menu_action"