# ServerTools **One jar. 120+ commands and features. Replaces a whole stack of plugins.** **[100% Open Source](https://github.com/reecepbcups/ServerTools-MC)** - full source on GitHub. Audit it, fork it, or contribute. ServerTools puts every core feature a server needs into a single modular plugin. Every module can be toggled off from the config, and disabled modules don't even register their listeners, so you only use compute for what you run. Perfect for Skyblock, Factions, Survival, or Hub servers. Tested by over 6,000 unique players. **Optional integrations:** [LuckPerms](https://luckperms.net/), [Vault](https://www.spigotmc.org/resources/vault.34315/), [PlaceholderAPI](https://hangar.papermc.io/HelpChat/PlaceholderAPI), [TAB](https://www.spigotmc.org/resources/tab-1-5-x-1-21-4.57806/), and [WorldGuard](https://enginehub.org/worldguard). All soft depends. ServerTools runs fine without them and lights up extra features when they're installed. [![Spigot](https://img.shields.io/badge/Spigot-Resource-orange)](https://www.spigotmc.org/resources/servertools-%E2%9E%9C-modular-server-management-1-8-1-21-open-source.95853/) [![Hangar](https://img.shields.io/badge/Hangar-PaperMC-004ee9)](https://hangar.papermc.io/reecepbcups/ServerTools-MC) [![Modrinth](https://img.shields.io/badge/Modrinth-Download-1bd96a)](https://modrinth.com/plugin/servertools-mc) [![Wiki](https://img.shields.io/badge/Docs-servertools.reece.sh-blue)](https://servertools.reece.sh/) [![License](https://img.shields.io/badge/Source-100%25%20Open-brightgreen)](./LICENSE) [![Discord](https://img.shields.io/badge/Discord-reecepbcups-5865F2)](https://discord.com/) --- ## Why ServerTools - **One plugin instead of twenty.** Holograms, withdraw, tags, vouchers, chat formatting, moderation, and the core commands all live in one jar. Fewer plugins means fewer version conflicts and faster startup (50ms). - **Modular by design.** Prefer another plugin for a given feature? Set it to `false` in the config and reload. ServerTools steps out of the way and stops registering that module entirely. - **100% open source.** Full source on [GitHub](https://github.com/reecepbcups/ServerTools-MC). Audit it, fork it, or contribute. - **Battle tested.** Over 6,000 unique players across Skyblock, Factions, Survival, and Hub setups. - **Built for performance.** Tickless holograms and heavy features like TPAll and ClearLag are written to stay lagless. --- ## Version and Compatibility | Version | Minecraft | Notes | |-|-|-| | **8.0.0+** | 1.20 / 1.21+ | Current, Java 21 | | **7.0.0+** | 1.18+ | | | **6.4.9-ALL** | 1.8 - 1.17 | [Legacy download](https://www.spigotmc.org/resources/servertools-%E2%9E%9C-modular-server-management-1-8-1-18-2-open-source.95853/download?version=455997) | Runs on **Paper** and **Spigot**. **Downloads:** [Hangar](https://hangar.papermc.io/reecepbcups/ServerTools-MC) - [Modrinth](https://modrinth.com/plugin/servertools-mc) - [Spigot](https://www.spigotmc.org/resources/servertools-%E2%9E%9C-modular-server-management-1-8-1-21-open-source.95853/) **Soft depends (all optional):** LuckPerms, Vault, PlaceholderAPI, TAB, WorldGuard. ServerTools works without them and lights up extra features when they're present. --- ## Features

The `/features` GUI is a customizable menu where *you* advertise your own server's features to players. Edit `FeaturesGUI.yml` to set the items, icons, and descriptions. It ships with SkyBlock-style examples (cactus collectors, mobcoins, etc.) that you swap out for whatever your server offers. It's not a browser of ServerTools' modules.

Server Features GUI
The /features GUI - a customizable showcase of your server's own features, editable in FeaturesGUI.yml

### Core commands (Essentials replacement) Fly, god, heal, repair, enchant, hat, invsee, enderchest, trash, workbench, speed, gamemode, tp, top, spawn, warps, compass, ping, messaging (msg/reply), nicknames, and realname. Full command and permission list is in the [Wiki](https://servertools.reece.sh/). ### Chat and formatting Chat formatting, emotes, chat cooldowns, join MOTD, MuteChat, ClearChat, plus **ChatColor** and **NameColor** GUIs with HEX support. ChatPolls let players vote inline.

Chat Welcome Message and Announcements
Chat Welcome Message (with PAPI support) and recurring timed announcements

ChatColor and NameColor
Rainbow ChatColor from config and orange NameColor via /namecolor or GUI (hex supported)

Chat polls
Inline ChatPolls - players vote by typing their choice, winner announced automatically

### Moderation Freeze, reports, command spy, **Command Protection**, staff AFK, whitelist bypass, and admin chat.

Chat moderation

Staff AFK auto-swaps the player's LuckPerms group while away, then restores it

### Holograms HEX-colored & gradient holographic displays with placeholder support. Great for Hub info panels and Tebex (Buycraft) store links.

Example spawn hologram with HEX color codes and gradients. Holograms support non-player-specific PAPI placeholders (e.g. %server_time%).

### Economy and items Money and EXP **Withdraw**, **XP Bottles**, item **Rename**, and stack-unstackables.

Withdraw and XP bottles
Withdraw money and EXP into physical items, then redeem them back (stacked amounts supported)

### Rewards and cosmetics **Vouchers** and bundles, **Tags**, daily rewards, and **Launchpads**.

Tags GUI
Tags that support full colors, hex, and gradients

Voucher bundles
Vouchers and bundles redeem for items, with one-time reclaim protection

### Server automation **AutoBroadcast**, **Custom Announcements**, **Scheduled Tasks**, and **Server-Age** (PAPI `%stools_age_%` ) tracking.

Custom Announcement - format and replace entirely in the config (PAPI placeholders work as well)

Donation broadcast
Auto-broadcast store purchases (Tebex/Buycraft friendly), fully formatted in the config

### Events **Command Aliases** (replace or remap text), custom death messages, death cooldowns, **Anti-Crafting** (block crafting of specific items), on-join commands, no bed explosions, and world effects.

Chat alias replacing text

### Utility **TPAll** (lagless), **ClearLag**, player **Visibility** toggles, join and leave messages, and PlaceholderAPI placeholders.

Player visibility toggles
Visibility toggles - show all, staff only, or hide everyone

ClearLag countdown
ClearLag counts down before it clears, so players get a heads-up

### Staff list Pulls staff from a LuckPerms group and displays it in-game.

Staff list (requires LuckPerms)

--- ## What it replaces Drop ServerTools in and you can pull out most of this stack. Every row is a feature ServerTools already ships. | Feature | Plugins it replaces | |-|-| | Core commands (fly, god, heal, repair, enchant, hat, invsee, enderchest, trash, workbench, speed, gamemode, tp, top, msg) | EssentialsX, CMI | | Spawn | EssentialsSpawn, CMI | | Warps | EssentialsX, HuskHomes | | Chat formatting | EssentialsChat, VentureChat, DeluxeChat, ChatManager | | Chat/name color | ChatColor+, SimpleChatColor | | Mute chat / clear chat | MuteChat, ClearChat | | Chat polls | Polls, VoteParty-style poll plugins | | Holograms | HolographicDisplays, DecentHolograms, GHolo | | Withdraw money / EXP | BeastWithdraw, Physical-Money, EconomyShopGUI withdraw | | XP bottles | XPBottles, BottledExp | | Item rename | SimpleRename, ItemEdit | | Anti-crafting | CraftControl, RecipeManager, CraftBlocker | | Command aliases | CommandAlias, MyCommand, ExecutableItems aliases | | Command protection | CommandBlockerUltimate, CommandWhitelist | | Auto broadcast / announcements | Announcer, AutoBroadcaster, BroadcastPlus | | Scheduled tasks | CommandSchedule, CommandTimer | | Vouchers / bundles | DeluxeVouchers, BossShopPro vouchers | | Crates | CrazyCrates, ExcellentCrates, Galaxy Crates | | Tags | DeluxeTags, BossShop tags | | Daily rewards | DailyRewards, AutoRewards | | Launchpads | LaunchpadX, JumpPads | | Freeze / reports / command spy | EssentialsX commandspy, Reports, FreezePlus | | Custom death messages | DeathMessagesPrime | | Staff AFK | EssentialsX AFK | | Visibility toggle | HideStream, per-player visibility plugins | | TPAll (lagless) | EssentialsX | | ClearLag | ClearLagg, LagAssist | | Join & leave messages | JoinMessage, CustomJoinMessages | | Server-age tracking | uptime/age plugins | | PlaceholderAPI placeholders | custom expansion plugins | ...plus a solid chunk of **Essentials** itself. Prefer a dedicated plugin for any of these? Toggle the ServerTools module off in the config and reload. --- ## Configuration Everything is config-driven. Toggle any module on or off and reload. **Main** - `config.yml` **Optional** - `FeaturesGUI.yml` (Features GUI) - `Tags.yml` - `ScheduledTask.yml` - `Vouchers.yml` (Vouchers / Bundles) - `CommandProtect.yml` (Command Protection) - `Announcements.yml` - `Holograms.yml`, `Warps.yml`, `AntiCraft.yml`, `spawn.yml` - **[NEW]** Messages / translations --- ## Documentation and Support - **Wiki / Docs:** https://servertools.reece.sh/ - **Discord:** `reecepbcups` - **Version history:** [Spigot page](https://www.spigotmc.org/resources/servertools-%E2%9E%9C-modular-server-management-1-8-1-21-open-source.95853/history) --- ## Building from source Needs Java 21, Maven, Docker, and [just](https://github.com/casey/just). ```bash git clone https://github.com/reecepbcups/ServerTools-MC.git cd ServerTools-MC ``` ```bash just build # mvn package + copy jar to server/plugins/ just server-up # paper server in docker (first run downloads everything) just test-e2e # e2e tests against the running server just loadtest # mineflayer bots for load testing ``` See [TESTING.md](TESTING.md) for load testing with bots and Spark profiling, and [INFRA.md](INFRA.md) for the local server setup.

ServerTools-MC

8.3.1