Configuration

Configuration

Here's how ServerTools works and how to set it up in config.yml.

ServerTools is a modular all-in-one management plugin. Every feature (economy, chat formatting, moderation tools, warps, and so on) is a module you switch on or off in config.yml. Nothing is forced on you. If a feature is off, it just doesn't run. Turn on only what your server needs.

Turning features on and off

Find the feature in config.yml, set Enabled: true or Enabled: false, then reload or restart the server. That's it.

For example, to turn on the fly command:

Core:
  Fly:
    Enabled: true

Set it to false and it stops running. Same pattern for pretty much everything.

What's in config.yml

The config is split into top-level sections. Here's what each one covers and where to read more:

Section	What it does
FeaturesGUI	In-game menu for browsing features (off by default)
Disabled	Turns OFF vanilla behavior like crop trample, fall damage, phantom spawns. See World and Mob Protections
Core	Everyday commands: fly, heal, tp, gamemode, enderchest, warps, spawn, messaging. See Core Features
Commands	Extra standalone commands: speed, stafflist, countdown, daily rewards, reclaim
Chat	Chat formatting, cooldowns, tags, colors, emojis, custom death messages. See Chat
Events	Event-driven stuff: anti-craft, world effects, join MOTD, launchpads. See Events, Cooldowns and Tasks
Moderation	Staff tools: mutechat, clearchat, freeze, whitelist bypass, reports, commandspy. See Moderation
Cooldowns	Item cooldowns like ender pearls and golden/god apples. See Events, Cooldowns and Tasks
Economy	Built-in economy: pay, balance, baltop, admin eco. See Economy
Misc	Grab bag: rename, clearlag, holograms, command aliases, visibility, scheduled tasks. See Utilities and Misc
Bungee	Bungee server-switch command
AutoBroadcast	Timed broadcast messages
Donation	Donation announcement command
FancyAnnounce	Configurable announcement groups with placeholders
ServerInfoCMDS	Overrides server info commands
ShopWorkAround	Remaps clicks in another shop plugin's GUI to run commands
Vouchers	Redeemable voucher and bundle items
Hoppers	Experimental hopper optimizer that sleeps idle hoppers (off by default). See Hopper Optimization

Global settings

A few settings sit at the top of config.yml and affect everything:

• Language: en - pick en (English) or de (German) for plugin messages.
• LoadWithTimings - set true to print startup timing info to console. Handy if you're chasing a slow startup.
• PluginVariables - custom %NAME% variables you define once and reuse in any message. Great for your store link, Discord invite, server name, and the like.

Here's the default PluginVariables block:

PluginVariables:
  STORE: https://store.WEBSITE.co
  DISCORD: https://discord.gg/INVITE
  RULES: https://WEBSITE.co/rules
  WEBSITE: https://WEBSITE.co
  SERVERNAME: '&A&lCRAFT&f&lNETWORK'
  SERVER: Hub-01
  SUPPORT: discord.com/invite/SUPPORTSERVER

Now dropping %STORE% into a broadcast or MOTD swaps in your store URL when the message sends. Change these to your own links and you only have to update them in one place.

Optional plugins

Some features unlock when you have another plugin installed. All of these are optional and ServerTools runs fine without any of them:

• Vault - economy hooks so other plugins can read balances
• LuckPerms - permission group support (like chat tags per rank)
• PlaceholderAPI - use its placeholders in your messages
• WorldGuard - region-aware features
• TAB - tab list integration

If a feature needs one of these, it just stays off until you install the plugin. No errors, nothing breaks.

Updating won't break your config

When you update ServerTools, any new config keys get added to your config.yml automatically. Your existing settings, comments, and custom stuff like PluginVariables and your broadcast messages stay exactly as you left them. So upgrading is safe, no need to redo your config from scratch.

Requirements

ServerTools needs Minecraft 1.18 or newer. On an older version it warns you, points you at the legacy build, and turns itself off instead of running broken.