Documentation
Overview
StaffGuard is an advanced staff management plugin for Paper servers that provides suspicious player monitoring, staff mode, punishment tools, offline player punishments, and EssentialsX integration.

Requirements
Supported Versions

• Paper 1.21.1+
  
  
• Java 21+
  

Optional Dependencies

• EssentialsX (Recommended)
  

When EssentialsX is installed, StaffGuard automatically uses EssentialsX Vanish during staff investigations.

Installation

1. Download StaffGuard.jar
   
   
2. Place it into your server's plugins folder.
   
   
3. Start or restart your server.
   
   
4. Configure permissions using LuckPerms or your preferred permissions plugin.
   
   
5. StaffGuard is now ready to use.
   

Commands
/sus
Opens the Suspicious Players GUI.

Permission
staffguard.sus

Features

• View suspicious players
  
  
• Teleport directly to players
  
  
• Automatically enter vanish mode (EssentialsX)
  
  
• Monitor players silently
  

/sfmode
Enables Staff Mode.

Permission


staffguard.sfmode

Features

• Spectator Mode
  
  
• EssentialsX Vanish
  
  
• Silent investigations
  
  
• Monitor players without interference
  

/offend <player> <time> <reason>
Punish online or offline players.

Permission


staffguard.offend

Examples


/offend Steve 1d XRay
/offend Steve 7d KillAura
/offend Steve 14d Cheating
/offend Steve 60d Exploiting
/offend Steve 360d SevereCheating
/offend Steve perm Cheating

/pardon <player>
Unban a player.

Example:


/pardon Steve

Suspicion System
StaffGuard tracks potentially suspicious players based on:

• Excessive Diamond Mining
  
  
• Excessive Ancient Debris Mining
  
  
• Long AFK Sessions
  
  
• Suspicious Player Activity
  
  
• Custom Staff Monitoring
  

Suspicious players automatically appear inside:


/sus

GUI Features
Suspicious Players GUI
Displays:

• Player Head
  
  
• Player Name
  
  
• Suspicion Level
  
  
• Investigation Teleport Option
  

Clicking a player's head:

• Enables EssentialsX Vanish
  
  
• Teleports staff member to the player
  
  
• Begins silent observation
  

Permissions

staffguard.*

staffguard.sus
staffguard.sfmode
staffguard.offend
staffguard.notify

Recommended LuckPerms Setup

lp group staff permission set staffguard.sus true
lp group staff permission set staffguard.sfmode true
lp group staff permission set staffguard.offend true
lp group staff permission set staffguard.notify true

EssentialsX Integration
StaffGuard supports EssentialsX automatically.

When installed:

• /sus uses EssentialsX Vanish
  
  
• /sfmode uses EssentialsX Vanish
  
  
• Staff investigations remain hidden from regular players
  

No additional configuration required.

Punishment Durations
Supported durations:


1m
5m
15m
30m

1h
6h
12h

1d
3d
7d
14d
30d
60d
90d
180d
360d

perm

Support
Found a bug or have a suggestion?

Create a discussion on the SpigotMC resource page and include:

• Minecraft Version
  
  
• Paper Version
  
  
• Java Version
  
  
• Console Error (if applicable)
  

StaffGuard
Advanced staff tools, suspicious player tracking, staff mode, EssentialsX integration, and offline punishments—all in one lightweight plugin.