Configuration | ProTools

Everything ProTools does is driven by one file: plugins/ProTools/config.yml. All text uses the MiniMessage format, so you can colour and style it however you like. After any change, run /protools reload to apply it without restarting.

General settings

The general block controls how all tools behave.

general:
  tool-duration-days: 7
  tools-unbreakable: true
  timer-lore-format: "<gray>Self Destruct in: <white>{days}d, {hours}h, {minutes}m, {seconds}s"

Key	What it controls	Default
`tool-duration-days`	Days a tool lasts before it self-destructs	`7`
`tools-unbreakable`	Whether tools take durability damage	`true`
`timer-lore-format`	The countdown line shown in each tool's lore	see above

The timer line supports {days}, {hours}, {minutes}, and {seconds}.

★Turn off self-destruct

The countdown runs off tool-duration-days. Set it to a very large number if you want tools that effectively never expire.

GUI settings

The gui block styles the menu opened by /protools list.

gui:
  title: "<blue>Available Pro Tools"
  size: 54
  filler-item:
    enabled: true
    item: "BLACK_STAINED_GLASS_PANE"
    name: " "
  close-button:
    enabled: true
    item: "BARRIER"
    name: "<red><bold>Close"
    lore:
      - "<gray>Click to close the menu."
    slot: 49

Key	What it controls	Default
`title`	Menu title text	`<blue>Available Pro Tools`
`size`	Menu size, a multiple of 9 (max 54)	`54`
`filler-item`	The background pane behind empty slots	Black glass pane
`close-button`	The button that closes the menu, and its slot	Barrier in slot 49

Tool definitions

Every tool is defined under tools, keyed by its id. Each entry sets the item, display name, lore, and any settings.

tools:
  monster-magnet:
    enabled: true
    item: "NETHER_STAR"
    name: "<#FF4500>Monster Magnet"
    lore:
      - "<gray>Draws your enemies closer."
    settings:
      cooldown-seconds: 5
      radius: 10.0
      pull-strength: 1.2

Key	What it controls
`enabled`	Whether the tool exists and shows in the menu
`item`	The Minecraft item the tool is based on
`name`	Display name (MiniMessage)
`lore`	Description lines shown under the name (MiniMessage)
`settings`	Per-tool options like cooldown, radius, or strength

⚠Do not rename the tool id

The id (for example monster-magnet) is how the plugin tracks the tool. Change the name and lore freely, but leave the id key alone.

Each tool's own settings are listed on its page. Browse them from All Tools.

Applying changes

Edit the file

Open plugins/ProTools/config.yml and make your changes.

Reload

Run /protools reload in game or from console. The menu rebuilds with the new values.

Next: see Messages & Language for the text players see, and Permissions for access control.