StaffUtilsPlus

StaffUtilsPlus

> A comprehensive, modern, and highly configurable staff utilities plugin for Minecraft servers.

Note that versions 1.1.0+ of StaffUtilsPlus will require ProtocolLib to function.

---

Features

- Highly Configurable: Temporarily or permanently ban/mute players, including IP bans. - Highly Configurable: Add, view, and manage notes and warnings for players. - Highly Configurable: GUI-based staff menu for quick access to moderation tools (coming soon). - Highly Configurable: Supports MySQL, SQLite, or local YAML storage. - Highly Configurable Lets staff see other players' commands and other info about them. - Highly Configurable: Automatic expiration for temporary punishments. - Highly Configurable: Broadcast and permission-based notifications for staff actions. - Highly Configurable: Async operations, caching, and detailed logging. - Highly Configurable: Tweak punishments, commands, storage, and more via YAML config.

---

Installation

1. Edit the latest release from Edit or %%MD1%%. 2. Edit the `StaffUtilsPlus.jar` file into your server's `plugins` folder. 3. Edit or Edit your server. 4. Edit the configuration files in `plugins/StaffUtilsPlus/` as needed.

---

️ Configuration

- plugin.yml: Main plugin configuration (database, punishments, commands, storage, logging, performance). - plugin.yml: Customize all plugin messages, including color codes and placeholders. - plugin.yml: Bukkit/Spigot plugin metadata and command registration.

Example `config.yml` snippet: ```yaml

Debug mode - enables additional logging

debug-mode: false

Database Configuration

database:

Whether to use a database (false = local storage only)

enabled: false

Database type: mysql, sqlite

type: "mysql"

MySQL Configuration (ignored for SQLite)

host: "localhost" port: 3306 name: "staffutils" user: "root" pass: "password"

vanish-fake-messages: true # When a player goes into vanish, broadcasts a fake join/leave message. ```

---

Usage

- Permissions can be run from the console or in-game (unless noted). - Permissions and Permissions are supported for all commands. - Permissions are required for most commands (see below).

Main Commands

| Command | Description | Aliases | Permission | |--------------------------------------------------------|----------------------------------------------|-------------|-------------------------| | `/ban <player> [reason] [duration]` | Ban a player | `/tempban` | `staffutils.ban` | | `/unban <player>` | Unban a player | | `staffutils.unban` | | `/kick <player> [reason]` | Kick a Player | | `staffutils.kick` | `/mute <player> [reason] [duration]` | Mute a player | `/tempmute` | `staffutils.mute` | | `/unmute <player>` | Unmute a player | | `staffutils.unmute` | | `/ipban <player> [reason] [duration]` | IP ban a player | `/tempipban` | `staffutils.ipban` | | `/commandSpy` | Spys on a player's commands | | `staffutils.commandspy` | | `/whois` | Shows info on a player | | `staffutils.whois.*` | | `/unbanip <ip-address>` | Unban an IP address | | `staffutils.unbanip` | | `/vanish` | Makes the sender invisible to other players. | | `staffutils.vanish` | | `/notes <player> [add/remove] [content/id]` | Manage player notes | | `staffutils.notes` | | `/warnings <player> [add/remove] [reason/severity/id]` | Manage player warnings | | `staffutils.warnings` | | `/help [page]` | Show help information | `/h`, `/?` | `staffutils.help` | | `/staffutilsplus` | Plugin base command | | `none` | | `/blame` | Shows punishments issued by a player. | | `staffutils.blame` | | `/history` | Shows a player's punishment history. | | `staffutils.history` | | `/alts` | Lists a player's known alts by IP | | `staffutils.alts` |

> Note: The advanced staff menu GUI is in development and will be enabled in a future update.

---

Permissions

- `staffutils.*` — All plugin permissions (default: OP) - `staffutils.ban` — Ban players - `staffutils.unban` — Unban players - `staffutils.mute` — Mute players - `staffutils.unmute` — Unmute players - `staffutils.ipban` — IP ban players - `staffutils.unbanip` — Unban IP addresses - `staffutils.vanish` — Allows players to enter vanish. - `staffutils.notes` — Manage player notes - `staffutils.warnings` — Manage player warnings - `staffutils.menu` — Access staff menu (future) - `staffutils.reload` — Reload plugin - `staffutils.whois.*` — Shows player info - `staffutils.debug` — Debug commands - `staffutils.notify.*` — Receive notifications for bans, mutes, IP bans - `staffutils.blame` — Enables access to /blame - `staffutils.history` — Enables access to /history - `staffutils.alts` — Enables access to /alts

---

Dependencies

- Spigot 1.21+ - ProtocolLib - Java 21

---

Credits

- License: Hexett - License: See License: - License: MIT

---

Support & Feedback

- GitHub Issues for bug reports and suggestions - Modrinth Page for downloads and reviews

---

License

This project is licensed under the MIT License. See the LICENSE file for details.