# 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

Administrative Commands

| Command | Aliases | Description | Permission | |--------------------------------|-------------------|-----------------------------------|-------------------------------------------------| | `/gamemode [mode] (player)` | `/gm` | Change gamemode | `serversystem.admin.command.gamemode.use` | | `/gms (player)` | - | Set survival mode | `serversystem.admin.command.gamemode.survival` | | `/gmc (player)` | - | Set creative mode | `serversystem.admin.command.gamemode.creative` | | `/gma (player)` | - | Set adventure mode | `serversystem.admin.command.gamemode.adventure` | | `/gmsp (player)` | - | Set spectator mode | `serversystem.admin.command.gamemode.spectator` | | `/time [time] (world)` | - | Set world time | `serversystem.admin.command.time.use` | | `/day (world)` | - | Set time to day | `serversystem.admin.command.time.use` | | `/night (world)` | - | Set time to night | `serversystem.admin.command.time.use` | | `/noon (world)` | - | Set time to noon | `serversystem.admin.command.time.use` | | `/midnight (world)` | - | Set time to midnight | `serversystem.admin.command.time.use` | | `/weather [type] (world)` | - | Change weather | `serversystem.admin.command.weather.use` | | `/sun (world)` | - | Set sunny weather | `serversystem.admin.command.weather.use` | | `/rain (world)` | - | Set rainy weather | `serversystem.admin.command.weather.use` | | `/storm (world)` | - | Set stormy weather | `serversystem.admin.command.weather.use` | | `/sudo [player] [command]` | - | Execute command as another player | `serversystem.admin.command.sudo.use` | | `/unlimited (player)` | - | Toggle unlimited items | `serversystem.admin.command.unlimited.use` | | `/speed [1-10] (player)` | - | Set player speed | `serversystem.admin.command.speed.use` | | `/flyspeed [1-10] (player)` | `/speedfly` | Set fly speed | `serversystem.admin.command.speed.use` | | `/walkspeed [1-10] (player)` | `/speedwalk` | Set walk speed | `serversystem.admin.command.speed.use` | | `/lightning (player) (visual)` | `/thor`, `/smite` | Strike lightning at target | `serversystem.admin.command.lightning.use` |

### Teleportation Commands

Teleportation Commands

| Command | Aliases | Description | Permission | |---------------------------------------|------------|---------------------------------------|-----------------------------------------------------------| | `/teleport [player] (target)` | `/tp` | Teleport to player or location | `serversystem.support.command.teleport.use` | | `/tppos [x] [y] [z] (world) (player)` | - | Teleport to coordinates | `serversystem.support.command.teleportposition.use` | | `/tphere [player]` | - | Teleport player to you | `serversystem.support.command.teleporthere.use` | | `/tpall (world)` | - | Teleport all players to you | `serversystem.admin.command.teleportall.use` | | `/tpa [player]` | - | Request teleport to player | `serversystem.command.teleportask.use` | | `/tpahere [player]` | - | Request player teleport to you | `serversystem.command.teleporthereask.use` | | `/tpaccept` | - | Accept teleport request | `serversystem.command.teleportaccept.use` | | `/tpdeny` | - | Deny teleport request | `serversystem.command.teleportdeny.use` | | `/tptoggle (player)` | - | Toggle teleport requests | `serversystem.command.teleporttoggle.use` | | `/back` | - | Return to previous location | `serversystem.command.back.use` | | `/offlinetp [player]` | `/otp` | Teleport to offline player's location | `serversystem.moderation.command.offlineteleport.use` | | `/offlinetphere [player]` | `/otphere` | Teleport offline player to you | `serversystem.moderation.command.offlineteleporthere.use` |

### Economy Commands

Economy Commands

| Command | Aliases | Description | Permission | |----------------------------------------------|-----------|-----------------------|------------------------------------------| | `/balance (player)` | `/money` | Check balance | `serversystem.command.balance.use` | | `/balancetop` | `/baltop` | View top balances | `serversystem.command.baltop.use` | | `/pay [player] [amount]` | - | Send money to player | `serversystem.command.pay.use` | | `/economy [set/give/take] [player] [amount]` | `/eco` | Manage player economy | `serversystem.admin.command.economy.use` |

### Moderation Commands

Moderation Commands

| Command | Aliases | Description | Permission | |----------------------------------|-----------------|-----------------------------|------------------------------------------------------| | `/ban [player] (reason)` | - | Ban a player | `serversystem.moderation.ban.use` | | `/unban [player]` | `/pardon` | Unban a player | `serversystem.moderation.ban.remove` | | `/mute [player] (time) (reason)` | - | Mute a player | `serversystem.moderation.mute.use` | | `/unmute [player]` | - | Unmute a player | `serversystem.moderation.mute.remove` | | `/shadowmute [player]` | - | Shadow mute a player | `serversystem.moderation.mute.shadow` | | `/vanish (player)` | `/v` | Toggle vanish mode | `serversystem.moderation.command.vanish.use` | | `/commandspy (player)` | - | Toggle command spy | `serversystem.moderation.command.commandspy.use` | | `/clearchat` | `/cc` | Clear chat for all players | `serversystem.moderation.command.clearchat.use` | | `/broadcast [message]` | `/bc` | Broadcast message to server | `serversystem.moderation.command.broadcast.use` | | `/clearinventory (player)` | `/clear`, `/ci` | Clear player inventory | `serversystem.moderation.command.clearinventory.use` | | `/ip [player]` | - | View player's IP address | `serversystem.moderation.command.ip.use` | | `/socialspy (player)` | - | Toggle social spy mode | `serversystem.moderation.command.socialspy.use` |

### Utility Commands

Utility Commands

| Command | Aliases | Description | Permission | |-------------------------------|------------------------|-----------------------------------|------------------------------------------------------| | `/workbench` | `/craft`, `/wb` | Open crafting table | `serversystem.command.workbench.use` | | `/anvil` | - | Open anvil interface | `serversystem.command.anvil.use` | | `/smithing` | - | Open smithing table | `serversystem.command.smithing.use` | | `/loom` | - | Open loom interface | `serversystem.command.loom.use` | | `/grindstone` | - | Open grindstone interface | `serversystem.command.grindstone.use` | | `/cartography` | - | Open cartography table | `serversystem.command.cartography.use` | | `/stonecutter` | - | Open stonecutter interface | `serversystem.command.stonecutter.use` | | `/disposal` | `/trash`, `/trashcan` | Open disposal interface | `serversystem.command.disposal.use` | | `/enderchest (player)` | `/ec` | Open ender chest | `serversystem.command.enderchest.use` | | `/offlineenderchest [player]` | `/oenderchest`, `/oec` | Open offline player's ender chest | `serversystem.admin.command.offlineenderchest.use` | | `/invsee [player]` | - | View player's inventory | `serversystem.command.inventorysee.use` | | `/offlineinvsee [player]` | `/oinvsee` | View offline player's inventory | `serversystem.admin.command.offlineinventorysee.use` | | `/smelt` | - | Smelt items in inventory | `serversystem.command.smelt.use` | | `/stack` | - | Stack items in inventory | `serversystem.admin.command.stack.use` | | `/repair (all)` | - | Repair items in hand or all | `serversystem.admin.command.repair.use` | | `/skull (player)` | - | Get player skull | `serversystem.admin.command.skull.use` | | `/ping (player)` | - | Check ping | `serversystem.command.ping.use` | | `/seen [player]` | - | Check when player was last online | `serversystem.support.command.seen.use` | | `/god (player)` | - | Toggle god mode | `serversystem.support.command.god.use` | | `/fly (player)` | - | Toggle flight | `serversystem.support.command.fly.use` | | `/heal (player)` | - | Heal player | `serversystem.support.command.heal.use` | | `/feed (player)` | - | Feed player | `serversystem.support.command.feed.use` | | `/hat` | - | Wear item in hand as hat | `serversystem.command.hat.use` | | `/rename [name]` | - | Rename item in hand | `serversystem.command.rename.use` | | `/sign [message]` | - | Sign item in hand with message | `serversystem.command.sign.use` | | `/unsign` | - | Remove signature from item | `serversystem.command.unsign.use` |

### Home & Warp Commands

Home & Warp Commands

| Command | Aliases | Description | Permission | |---------------------------------|---------|---------------------------|-----------------------------------------------| | `/spawn (player)` | - | Teleport to spawn | `serversystem.command.spawn.use` | | `/setspawn` | - | Set server spawn | `serversystem.admin.command.spawn.set` | | `/home [name]` | - | Teleport to home | `serversystem.command.home.use` | | `/sethome [name]` | - | Set home location | `serversystem.command.home.set` | | `/delhome [name]` | - | Delete home | `serversystem.command.home.delete` | | `/adminhome [player] [name]` | - | Teleport to player's home | `serversystem.moderation.command.home.use` | | `/adminsethome [player] [name]` | - | Set home for player | `serversystem.moderation.command.home.set` | | `/admindelhome [player] [name]` | - | Delete player's home | `serversystem.moderation.command.home.delete` | | `/warp [name]` | - | Teleport to warp | `serversystem.command.warp.use` | | `/setwarp [name]` | - | Create warp | `serversystem.admin.command.warp.set` | | `/delwarp [name]` | - | Delete warp | `serversystem.admin.command.warp.delete` |

### Communication Commands

Communication Commands

| Command | Aliases | Description | Permission | |---------------------------|---------------------|--------------------------|---------------------------------------------| | `/msg [player] [message]` | `/tell`, `/whisper` | Send private message | `serversystem.command.privatemessage.use` | | `/reply [message]` | `/r` | Reply to last message | `serversystem.command.privatemessage.use` | | `/msgtoggle (player)` | - | Toggle private messages | `serversystem.command.messagetoggle.use` | | `/teamchat [message]` | `/tc` | Send team chat message | `serversystem.support.command.teamchat.use` | | `/ignore [player]` | - | Ignore player messages | `serversystem.command.ignore.use` | | `/unignore [player]` | - | Unignore player messages | `serversystem.command.unignore.use` |

### Kit Commands

Kit Commands

| Command | Aliases | Description | Permission | |------------------------|---------|---------------------------|-----------------------------------------| | `/kit [name] (player)` | - | Give kit to player | `serversystem.command.kit.use` | | `/createkit [name]` | - | Create kit from inventory | `serversystem.admin.command.kit.create` | | `/deletekit [name]` | - | Delete kit | `serversystem.admin.command.kit.delete` |

### Miscellaneous Commands

Miscellaneous Commands

| Command | Aliases | Description | Permission | |----------------------|---------|------------------------------------|----------------------------------------------| | `/language [lang]` | - | Change language | `serversystem.command.language.use` | | `/signcost` | - | Manage sign costs | `serversystem.admin.command.signcost.use` | | `/drop (player)` | - | Toggle item dropping in vanish | `serversystem.moderation.command.vanish.use` | | `/pickup (player)` | - | Toggle item pickup in vanish | `serversystem.moderation.command.vanish.use` | | `/interact (player)` | - | Toggle block interaction in vanish | `serversystem.moderation.command.vanish.use` | | `/message (player)` | - | Toggle messaging ability in vanish | `serversystem.moderation.command.vanish.use` |

## 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.` - 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_%`) -> Shows the formatted balance for a player - `%serversystem_unformattedbalance%` (`%serversystem_unformattedbalance_%`) -> Shows the *unformatted* balance for a player - `%serversystem_baltop_name_%` -> Shows the name of place in baltop (1 - 10 only!) - `%serversystem_baltop_balance_%` -> Shows the formatted balance of place in baltop (1 - 10 only!) - `%serversystem_baltop_unformattedsbalance_%` -> Shows the *unformatted* balance of place 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`

TestAccount666

BasicallyEnoughItems