ServerSystem

A comprehensive Minecraft server management plugin for Paper servers, providing essential administrative, moderation, and utility commands.

In short, this is an alternative to plugins like Essentials.

Why?

While Essentials is a fine plugin, more options and competition is always a good thing.
This plugin also aims to be much more customizable and (mostly) be a drop-in solution.

Features

• Administrative Tools: Gamemode management, teleportation, time/weather control
• Economy System: Balance management, payments, economy administration (requires Vault)
• Moderation Tools: Ban/mute system, command spy, vanish, clear chat
• Utility Tools: Repair tools, trash can, heal, feed
• Player Utilities: Homes, warps, kits, mobile workbench access
• Teleportation System: TPA requests, back command, spawn management
• Communication: Private messaging, team chat, broadcast system
• Clickable Signs: Interactive signs for various functions
• Multi-language Support: Per-User language support, defaulting to player's locale (English, German and Slovene only)

Requirements

• Minecraft Version: 1.21+
• Server Software: Paper (or Paper-based forks)
• Java Version: 21+
• Optional Dependencies:
  • Vault (Provides a universal Economy API for other plugins to use)
  • NBTAPI (For loading/saving offline player data)

Installation

1. Download the latest ServerSystem JAR file
2. Place it in your server's `plugins` folder
3. Restart your server
4. Configure the plugin using the generated configuration files
5. Reload or restart the server to apply changes

Configuration

The plugin generates several configuration files:

• `config.yml` - Contains configuration for sections that are either too small or too generic
• `commands.yml` - Command settings and aliases
• `permissions.yml` - Permission definitions
• `economy.yml` - Economy related settings
• `moderation.yml` Moderation (Ban/Mute) related settings
• `messages/` - Language files for different locales

Commands

(xy) = optional argument
[xy] = required argument

Administrative Commands


Teleportation Commands


Economy Commands


Moderation Commands


Utility Commands


Home & Warp Commands


Communication Commands


Kit Commands


Miscellaneous Commands


Permissions

ServerSystem groups permissions into the following main categories:

• `serversystem.admin.*` - Full administrative access
• `serversystem.moderation.*` - Moderation tools
• `serversystem.support.*` - Support/helper permissions
• `serversystem.command.*` - Basic command permissions

Most permissions suitable for everyday player usage are already given by default.
This means that players can use these commands out of the box (e.g. `/home`)
You can set any permission to (not) be required inside the `permissions.yml` file.

Permission Levels

• Admin: Full server control (gamemode, time, weather, economy, etc.)
• Moderation: Player management (ban, mute, vanish, etc.)
• Support: Helper tools (teleport, heal, god mode, etc.)
• Player: Basic commands (homes, warps, messaging, etc.)

Special Permissions

• `serversystem.homes.unlimited` - Unlimited homes
• `serversystem.homes.<number>` - Specific home limit
• `serversystem.chat.colored` - Use color codes in chat
• `serversystem.command.teleportask.instant` - Instant teleport without delay

Clickable Signs

The plugin supports interactive signs for various functions:

• Give Signs: Give items to players
• Kit Signs: Provide kits to players
• Time Signs: Change server time
• Weather Signs: Change server weather
• Warp Signs: Teleport to warps

Each sign type has create/destroy permissions for administrators.

Data Migration

While Pre-Rewrite (2.x.x) ServerSystem supported migrating from or to Essentials, 3.x.x, as of 18. July 2025, does not.
The reason for this is simple. I just didn't get to it before I deemed the plugin Release-Ready.

PlaceholderAPI

This plugin has support for PlaceholderAPI. You can use it's placeholders in ServerSystem's messages or use the ones ServerSystem adds:

• `%serversystem_onlineplayers%` -> Shows the online player count, excluding vanished players, if the target cannot see vanished players
• `%serversystem_balance%` (`%serversystem_balance_<playername>%`) -> Shows the formatted balance for a player
• `%serversystem_unformattedbalance%` (`%serversystem_unformattedbalance_<playername>%`) -> Shows the unformatted balance for a player
• `%serversystem_baltop_name_<number>%` -> Shows the name of place <number> in baltop (1 - 10 only!)
• `%serversystem_baltop_balance_<number>%` -> Shows the formatted balance of place <number> in baltop (1 - 10 only!)
• `%serversystem_baltop_unformattedsbalance_<number>%` -> Shows the unformatted balance of place <number> in baltop (1 - 10 only!)

Auto Updates

As a user, you can disable Auto-Updates via the `config.yml`.

If you are a server hoster or just want to use JVM Flags, you can do the same like this:
`java -Dserversystem.disable-auto-download=true -jar server.jar`