Skip to main content
The keybind_config manifest entry is used to define how each keybind behaves and to register persistent inventory buttons.

​
⚙️ Configuration Properties

​
Global Settings

​
swapHand
KeyBindSettings
Configuration for the Swap Hand (F) key.
​
dropItem
KeyBindSettings
Configuration for the Drop Item (Q) key.
​
advancements
KeyBindSettings
Configuration for the Advancements (L) key.
​
inventoryButtons
List<InventoryButton>
Collection of persistent buttons to place in the inventory or crafting grid.

​
KeyBindSettings Object

Used for swapHand, dropItem, and advancements.
FieldTypeDescription
enabledBooleanWhether the handler is active.
cancelActionBooleanIf true, the vanilla action (e.g. swapping items) is cancelled.
actionsList<Ref<Action>>Actions to execute when the key is pressed.
delayLongExecution delay in server ticks (default: 0).

​
InventoryButton Object

Defines a persistent button.
FieldTypeDescription
slotIntInventory slot ID where the button is placed.
itemVar<Item>The item stack configuration to display as a button.
actionsList<Ref<Action>>Actions triggered when clicking the button.
delayLongExecution delay in server ticks.
isCraftingGridBooleanIf true, the slot refers to the crafting grid IDs (0-4).

​
💻 Example Usage

keybind_config:
  id: "global_keys"
  swapHand:
    enabled: true
    cancelAction: true
    actions:
      - "open_menu_action"
  inventoryButtons:
    - slot: 0
      isCraftingGrid: true
      item:
        type: "COMPASS"
        name: "<green>Quest Tracker"
      actions:
        - "track_nearest_objective_action"