FstaffCore

FStaffCore
The all-in-one staff management and moderation solution for Paper 1.20.4.

FStaffCore is a complete moderation and staff management plugin designed to provide server teams with the tools they need to manage players, handle sanctions, monitor staff activity and maintain an organized moderation environment.

From staff mode and vanish to advanced player analysis, freeze management, reports and configurable GUIs, FStaffCore brings essential moderation features together in one powerful and flexible plugin.

Features
Staff Management

• Configurable staff mode with customizable hotbar tools.
  
  
• Vanish and SuperVanish support.
  
  
• Staff chat for internal communication.
  
  
• Rank and permission management.
  
  
• Staff activity supervision and audit logs.

Freeze System

• Freeze players with movement and command restrictions.
  
  
• Configurable freeze scoreboard and messages.
  
  
• Freeze snapshots included in player history.
  
  
• Optional automatic or manual permanent ban when a frozen player disconnects.
  
  
• Disconnect-ban action available exclusively to the staff member who froze the player.

Punishments & Sanctions

• Ban, mute, kick and IP-ban systems.
  
  
• Permanent and temporary sanctions.
  
  
• Custom durations, including 30m, 12h and 7d.
  
  
• Predefined and custom sanction reasons.
  
  
• Silent and public sanction announcements.
  
  
• Double confirmation for permanent bans.
  
  
• Configurable sanction management through GUIs.

Player History

• Ban, mute, kick and notes history GUIs.
  
  
• Detailed player history panel.
  
  
• Freeze snapshots for moderation review.
  
  
• Read-only inventory viewer.
  
  
• Organized records to help staff review previous actions.

Player Analyzer
Tools for inspecting player behavior and gameplay data:

• Ping monitoring.
  
  
• CPS checks.
  
  
• Speed checks.
  
  
• Rotation analysis.
  
  
• Knockback checks.
  
  
• Reaction checks.

The analyzer is designed to assist staff investigations. Results should be reviewed alongside other evidence and server context.

Reports & Supervision

• Player reporting system.
  
  
• Staff activity monitoring.
  
  
• Audit logs for moderation actions.
  
  
• Configurable staff panels and settings GUIs.
  
  
• Permission-based access to moderation tools.

Configuration & Compatibility

• PlaceholderAPI support.
  
  
• SQLite storage by default.
  
  
• Optional MySQL database support.
  
  
• English and Spanish language files.
  
  
• Configurable messages, panels and settings.
  
  
• LuckPerms compatibility for permission management.
  
  
• Freddyold Easter egg with a permanent creator greeting.

Commands
Command Description
/fs Enter or leave staff mode.
/fs panel Open the staff panel.
/fs sanciones <player> Open the sanction GUI.
/fban <player> Open the ban GUI.
/fmute <player> Open the mute GUI.
/fbanip <player> Open the IP-ban GUI.
/fs historial <player> Open player history.
/fs auditlog View staff audit logs.
/report <player> <reason> Submit a player report.
Additional commands and permissions may be available depending on your configuration.

Installation
1. Download the plugin

Download the latest FStaffCore-1.0.0.jar release.

2. Install the plugin

Upload the JAR file to your server's plugins folder.

3. Start your server

Start the server once to generate the plugin configuration files.

4. Configure the plugin

Open:

plugins/FStaffCore/config.yml

Adjust the settings, messages and available features according to your server's requirements.

5. Configure permissions

Use LuckPerms or another compatible permissions plugin to assign staff permissions.

6. Restart your server

Restart the server to apply the configuration.

Requirements

• Paper 1.20.4 or a compatible Paper 1.20 server.
  
  
• Java 17 or newer.
  
  
• LuckPerms (optional, recommended).
  
  
• PlaceholderAPI (optional).
  
  
• SQLite (included and enabled by default).

No external database is required for normal operation. SQLite is used automatically. MySQL support is available as an optional configuration.

Permissions
FStaffCore is designed around permission-based staff management. Configure access using LuckPerms or your preferred permissions plugin.

Refer to the permissions documentation for the complete permission list.

Storage
FStaffCore uses SQLite by default, making it suitable for servers that want a simple installation without additional database setup.

MySQL support is available for servers that require an external database configuration.

Language Support

• English
  
  
• Spanish

Language files can be customized to adapt messages and moderation announcements to your server.

Why FStaffCore?
FStaffCore brings staff management, player moderation, sanctions, history tracking, reports and supervision into a unified system.

Its configurable GUIs and storage options allow server administrators to adapt the plugin to their moderation workflow while providing staff members with accessible tools for daily management.

One plugin. Multiple moderation systems. Built for your staff team.

Support & Feedback
Found a bug or have a suggestion?

You can report issues, share feedback and propose new features to help improve FStaffCore.

Thank you for supporting the project and helping make FStaffCore better.