Skip to content

Events Cooldowns and Tasks

Jump to bottom
Reece Williams edited this page Sep 2, 2026 · 2 revisions

Events, Cooldowns and Tasks

A grab-bag of gameplay listeners, item cooldowns, and repeating tasks in ServerTools. Most of it lives in config.yml, with a few features pulling extra settings from their own companion .yml file that gets made on first run.

Needs: nothing for most. Withdraw needs Vault + an economy.

Events

AntiCraft

Blocks crafting or using stations (anvil, smithing table, grindstone, enchanting) for specific items, unless the player has the bypass perm.

  • Config: Events.AntiCraft
  • On by default: no
  • Companion file: AntiCraft.yml holds the block lists
  • Per-station toggles: Crafting, Anvil, Smithing, Grindstone, Enchanting (all true)
  • Perms: anticraft.admin, anticraft.bypass
  • The MSG supports %action% and %item%

StackUnstackables

Lets normally unstackable items stack. You give it a list of material names.

  • Config: Events.StackUnstackables
  • On by default: no
  • items: list, e.g. SADDLE, SHEARS, EGG

WorldEffects

Applies a permanent potion effect to everyone in a given world.

  • Config: Events.WorldEffects
  • On by default: yes
  • worlds: entries use the format world:EFFECT:level, e.g. world:NIGHT_VISION:1

OnJoinCommands

Runs console commands when a player joins. Two buckets: first-ever join, and every join.

  • Config: Misc.OnJoinCommands
  • On by default: no
  • FirstUniqueJoin.CMDS runs once per player, PlayerRunCommands.CMDS runs every join
  • %player% gets swapped in each command

Withdraw

Turns some of a player's balance into a physical note item. /withdraw <amount / all> pulls money out of the player's balance and hands them a paper "note" worth that amount. You can also run /withdraw AMOUNT player from console.

  • Config: Misc.Withdraw
  • On by default: no
  • Needs Vault plus an economy plugin. No economy, no Withdraw.

XPBottle

Converts a player's XP into a bottle item (this is XP, not money). /xpbottle <amount / all> bottles up their experience, and drinking those bottles gives the XP back.

  • Config: Misc.XPBottle
  • On by default: no

NoBedExplosionInNether

Stops beds from blowing up when used in the Nether or End.

  • Config: Events.NoBedExplosionInNether
  • On by default: yes

CMDAliases

Lets you remap commands to shorter aliases, block commands outright, add a pre-command cooldown, and disable commands per world. See the config for the full list of knobs.

  • Config: Misc.CMDAliases
  • On by default: yes
  • Bypass perm: cmdalias.bypass
  • cmds: maps a short alias to the real command, e.g. colors -> essentials:info colors
  • disabled: blocks commands like pl, plugins, version
  • preCooldownCommands: delays a command by N seconds with command%seconds, e.g. spawn%5. stopIfMoved controls whether moving cancels it
  • disabledWorlds: blocks specific commands per world, e.g. no sethome in spawn

Item cooldowns

All three sit under Cooldowns: and share Seconds plus message strings. %timeleft% shows the remaining time.

EnderPearlCooldown

Rate-limits throwing ender pearls.

  • Config: Cooldowns.EnderPearlCooldown
  • On by default: no
  • Options: Seconds (15), Message

GoldenAppleCooldown

Cooldown on eating regular golden apples.

  • Config: Cooldowns.GoldenAppleCooldown
  • On by default: no
  • Options: Seconds (15), Message, StartCooldownMSG (supports %seconds%)

GodAppleCooldown

Same deal for enchanted god apples.

  • Config: Cooldowns.GodAppleCooldown
  • On by default: no
  • Options: Seconds (45), Message, StartCooldownMSG

Tasks

The repeating and scheduled stuff.

AutoBroadcast

Broadcasts messages on a timer, cycling through what's defined in Announcements.yml.

  • Config: AutoBroadcast (top level)
  • On by default: yes
  • Companion file: Announcements.yml (needs a Messages section)

ClearLag

Auto-clears ground items (and optionally mobs) on a repeating timer, with a warning before it fires.

  • Config: Misc.ClearLag
  • On by default: no (but the nested AutoClearItems.Enabled is true)
  • Options: ClearMobs (true), ClearDelay in seconds (900), ClearSoonMSG, ClearedMSG
  • Manual perm: tools.clearlag

Launchpads

Stand on a pressure plate sitting on an emerald block and get launched into the air.

  • Config: Events.Launchpads
  • On by default: yes
  • Options: BlockType (EMERALD_BLOCK), PlateType (STONE_PRESSURE_PLATE), LaunchPower (1), RunnableTicksperCheck (7)
  • Admin perm: launchpad.admin

ScheduledTask

Runs tasks defined in ScheduledTask.yml on a schedule.

  • Config: Misc.ScheduledTask
  • On by default: no
  • Companion file: ScheduledTask.yml
  • Options: Debug (false), Permission (tools.scheduledtask.admin)

DisableTimeChange (TimeChange)

Less an on/off toggle, more a time controller. It locks configured worlds to day or night and re-syncs on an interval.

  • Config: Disabled.DisableTimeChange
  • On by default: yes
  • Options: DayInAllWorlds (true), SecondSync in seconds (60), DayWorlds: list, NightWorlds: list

ServerTools

Getting started

Features

Clone this wiki locally