Skip to content
dzusill plugins

config.yml

The single settings file at plugins/ToolsNotifier/config.yml. Apply changes with /tn reload. Four top-level sections: Settings, IgnoreItems, Messages and Sounds (the last two are covered in Messages & Sounds).

Global thresholds

Section titled “Global thresholds”
Settings:
  NotifyInActionBar: true
  NotifyInMessage: true
  NotifyIfBelowPercentage: 90
  CriticalIfBelowPercentage: 10
  NotifyDelayInSeconds: 3
  UnbreakingAware: true
Key Default Description
NotifyInActionBar true Master toggle for the action-bar channel.
NotifyInMessage true Master toggle for the chat channel.
NotifyIfBelowPercentage 90 Global warn threshold (fallback).
CriticalIfBelowPercentage 10 Global critical threshold; must be lower than the warn %.
NotifyDelayInSeconds 3 Per-player cooldown between notifications.
UnbreakingAware true Account for Unbreaking before comparing thresholds.

See How Notifications Work.

Categories & overrides

Section titled “Categories & overrides”
Settings:
  Categories:
    Tools:  { Enabled: true, Percentage: 90, CriticalPercentage: 10 }
    Armor:  { Enabled: true, Percentage: 50, CriticalPercentage: 10 }
    Elytra: { Enabled: true, Percentage: 20, CriticalPercentage: 5 }
  ItemOverrides:
    DIAMOND_PICKAXE: { Enabled: true, Percentage: 50 }
    ELYTRA:          { Enabled: false }

Per-category and per-material thresholds. Full reference in Thresholds & Categories.

Title & boss bar

Section titled “Title & boss bar”
Settings:
  Title:
    NotifyInTitle: true
    FadeInTime: 5
    StayOnScreenTime: 20
    FadeOutTime: 10
  BossBar:
    NotifyInBossBar: false
    DurationTicks: 60
    WarnBarColor: YELLOW
    CriticalBarColor: RED

The title and boss-bar channels — see Notification Channels. Boss-bar colours are limited to the seven Minecraft values.

PRO inventory scan

Section titled “PRO inventory scan”
Settings:
  ProInventoryScan:
    Enabled: true
    IntervalSeconds: 30

PRO only — the periodic inventory scan.

Ignored items

Section titled “Ignored items”
IgnoreItems:
  - ''

A list of Bukkit Material names never to notify about — overriding categories and overrides.