# StaffUtilsPlus<\/p>\n
  <\/p>\n
> **A comprehensive, modern, and highly configurable staff utilities plugin for Minecraft servers.**<\/p>\n
### Note that versions 1.1.0+ of StaffUtilsPlus will require ProtocolLib to function.<\/p>\n
—<\/p>\n
## Features<\/p>\n
– **Ban, Mute, and IP Ban**: Temporarily or permanently ban\/mute players, including IP bans.
\n– **Player Notes & Warnings**: Add, view, and manage notes and warnings for players.
\n– **Advanced Staff Menu**: GUI-based staff menu for quick access to moderation tools (coming soon).
\n– **Database & Local Storage**: Supports MySQL, SQLite, or local YAML storage.
\n– **WhoIs and CommandSpy:** Lets staff see other players’ commands and other info about them.
\n– **Auto-Expiration**: Automatic expiration for temporary punishments.
\n– **Notifications**: Broadcast and permission-based notifications for staff actions.
\n– **Performance & Logging**: Async operations, caching, and detailed logging.
\n– **Highly Configurable**: Tweak punishments, commands, storage, and more via YAML config.<\/p>\n
—<\/p>\n
## Installation<\/p>\n
1. **Download** the latest release from GitHub Releases or Modrinth.
\n2. **Place** the `StaffUtilsPlus.jar` file into your server’s `plugins` folder.
\n3. **Restart** or **reload** your server.
\n4. **Edit** the configuration files in `plugins\/StaffUtilsPlus\/` as needed.<\/p>\n
—<\/p>\n
## \ufe0f Configuration<\/p>\n
– **config.yml**: Main plugin configuration (database, punishments, commands, storage, logging, performance).
\n– **messages.yml**: Customize all plugin messages, including color codes and placeholders.
\n– **plugin.yml**: Bukkit\/Spigot plugin metadata and command registration.<\/p>\n
Example `config.yml` snippet:
\n“`yaml
\n# Debug mode – enables additional logging
\ndebug-mode: false<\/p>\n
# Database Configuration
\ndatabase:
\n # Whether to use a database (false = local storage only)
\n enabled: false<\/p>\n
# Database type: mysql, sqlite
\n type: “mysql”<\/p>\n
# MySQL Configuration (ignored for SQLite)
\n host: “localhost”
\n port: 3306
\n name: “staffutils”
\n user: “root”
\n pass: “password”<\/p>\n
vanish-fake-messages: true # When a player goes into vanish, broadcasts a fake join\/leave message.
\n“`<\/p>\n
—<\/p>\n
## Usage<\/p>\n
– **All commands** can be run from the console or in-game (unless noted).
\n– **Tab completion** and **aliases** are supported for all commands.
\n– **Permissions** are required for most commands (see below).<\/p>\n
### Main Commands<\/p>\n
| Command | Description | Aliases | Permission | > **Note:** The advanced staff menu GUI is in development and will be enabled in a future update.<\/p>\n —<\/p>\n ## Permissions<\/p>\n – `staffutils.*` \u2014 **All plugin permissions** (default: OP) —<\/p>\n ## Dependencies<\/p>\n – Spigot 1.21+ —<\/p>\n ## Credits<\/p>\n – **Author:** Hexett —<\/p>\n ## Support & Feedback<\/p>\n – GitHub Issues for bug reports and suggestions —<\/p>\n ## License<\/p>\n This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.<\/p>\n","protected":false},"excerpt":{"rendered":" The only staff plugin you’ll (hopefully) ever need!<\/p>\n","protected":false},"featured_media":147899,"template":"","meta":{"_minecraft_slug":"staffutilsplus","_minecraft_project_id":"hTBSNc8g","_minecraft_author":"hexett","_minecraft_license":"MIT","_minecraft_downloads":202,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"staffutilsplus.zip","_minecraft_size_bytes":22082396,"_minecraft_version_count":5,"_minecraft_updated_at":"2026-05-16T12:44:42.477439Z","_minecraft_date_created":"2025-08-14T00:13:20.753279Z","_minecraft_date_modified":"2026-03-15T18:05:33.637105Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/staffutilsplus","_minecraft_icon_attachment_id":147899,"_minecraft_imported_at":"2026-06-08T21:07:06+00:00","_minecraft_import_hash":"7d534fb4e388bbb4ae712b15e3ff1587","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,89,126,127,128,129,92],"mod_loader":[130,132,133,134],"minecraft_version":[40,41,78,79,80,81,82],"class_list":["post-147898","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n|——————————————————–|———————————————-|————-|————————-|
\n| `\/ban
\n| `\/unban
\n| `\/kick
\n| `\/mute
\n| `\/unmute
\n| `\/ipban
\n| `\/commandSpy` | Spys on a player’s commands | | `staffutils.commandspy` |
\n| `\/whois` | Shows info on a player | | `staffutils.whois.*` |
\n| `\/unbanip
\n| `\/vanish` | Makes the sender invisible to other players. | | `staffutils.vanish` |
\n| `\/notes
\n| `\/warnings
\n| `\/help [page]` | Show help information | `\/h`, `\/?` | `staffutils.help` |
\n| `\/staffutilsplus` | Plugin base command | | `none` |
\n| `\/blame` | Shows punishments issued by a player. | | `staffutils.blame` |
\n| `\/history` | Shows a player’s punishment history. | | `staffutils.history` |
\n| `\/alts` | Lists a player’s known alts by IP | | `staffutils.alts` |<\/p>\n
\n– `staffutils.ban` \u2014 Ban players
\n– `staffutils.unban` \u2014 Unban players
\n– `staffutils.mute` \u2014 Mute players
\n– `staffutils.unmute` \u2014 Unmute players
\n– `staffutils.ipban` \u2014 IP ban players
\n– `staffutils.unbanip` \u2014 Unban IP addresses
\n– `staffutils.vanish` \u2014 Allows players to enter vanish.
\n– `staffutils.notes` \u2014 Manage player notes
\n– `staffutils.warnings` \u2014 Manage player warnings
\n– `staffutils.menu` \u2014 Access staff menu (future)
\n– `staffutils.reload` \u2014 Reload plugin
\n– `staffutils.whois.*` \u2014 Shows player info
\n– `staffutils.debug` \u2014 Debug commands
\n– `staffutils.notify.*` \u2014 Receive notifications for bans, mutes, IP bans
\n– `staffutils.blame` \u2014 Enables access to \/blame
\n– `staffutils.history` \u2014 Enables access to \/history
\n– `staffutils.alts` \u2014 Enables access to \/alts<\/p>\n
\n– ProtocolLib
\n– Java 21<\/p>\n
\n– **Contributors:** See GitHub Contributors
\n– **License:** MIT<\/p>\n
\n– Modrinth Page for downloads and reviews<\/p>\n