Advanced-Staff

A comprehensive staff utility plugin for Minecraft servers (Paper 1.21+).

Features

• Staff Mode: Toggle staff mode with /staffmode. Includes auto-vanish and inventory saving.
• Vanish: Vanish from other players with /vanish. Includes silent join/leave and fake messages.
• Freeze: Freeze suspicious players with /freeze. Prevents movement and interaction.
• Punishments: Ban, mute, kick, and unban/unmute players.
• Reports: Players can report others. Staff can view and manage reports.
• Notes: Add notes to players for other staff to see.
• Inventory Inspection: View player inventories (/invsee) and ender chests (/ecsee).
• Staff Chat: Private chat for staff members.
• Teleportation: Teleport to players or bring them to you.
• Database Support: SQLite (default) and MySQL support for storing data.

Commands

Command	Description	Usage
/staffmode	Toggle staff mode	/staffmode [reload]
/vanish	Toggle vanish	/vanish [player]
/vanishlist	List vanished players	/vanishlist
/freeze	Freeze a player	/freeze <player> [time] [reason]
/unfreeze	Unfreeze a player	/unfreeze <player>
/freezelist	List frozen players	/freezelist
/invsee	View inventory	/invsee <player>
/ecsee	View ender chest	/ecsee <player>
/inspect	Open inspect GUI	/inspect <player>
/note	Manage notes	/note add <player> <text> | /note remove <id>
/notes	View notes	/notes <player>
/staffchat	Staff chat	/staffchat [message]
/tp	Teleport to player	/tp <player>
/tphere	Teleport player here	/tphere <player>
/ban	Ban a player	/ban <player> [time] [reason]
/unban	Unban a player	/unban <player>
/mute	Mute a player	/mute <player> [time] [reason]
/unmute	Unmute a player	/unmute <player>
/kick	Kick a player	/kick <player> [reason]
/report	Report a player	/report <player> <reason>
/reports	View reports	/reports [gui|list <player>|clear <player>]

Permissions

Permissions are fully configurable in settings.yml. Default permissions are:

• Staff Mode: permission.staffmode.use, permission.staffmode.reload
• Vanish: permission.vanish.self, permission.vanish.other, permission.vanish.list
• Freeze: permission.freeze.use, permission.freeze.list, permission.freeze.logout-notify
• Inventory: permission.inventory.invsee, permission.inventory.ecsee
• Inspect: permission.inspect
• Notes: permission.notes.add, permission.notes.remove, permission.notes.view
• Reports: permission.reports.view, permission.reports.clear (Reporting is open to everyone by default)
• Staff Chat: permission.staffchat
• Teleport: permission.teleport.tp, permission.teleport.tphere
• Punishments:
  • Ban: permission.punishments.ban
  • Unban: permission.punishments.unban
  • Mute: permission.punishments.mute
  • Unmute: permission.punishments.unmute
  • Kick: permission.punishments.kick

Configuration

The plugin generates the following configuration files:

• settings.yml: Main configuration (database, features, permissions).
• messages.yml: Customizable messages.
• items.yml: Item configuration.
• punishments.yml: Punishment configuration.

Installation

1. Download the latest release.
2. Place the JAR file in your server's plugins folder.
3. Restart the server.
4. Configure settings.yml and other files as needed.

Building

To build the project, you need to have Gradle installed.

Run:

gradle build

The output JAR will be in build/libs.