StaffCore icon
Server Exclusive

StaffCore

A complete moderation workspace built around fast, informed action.

Server exclusive
Spigot downloads
Modrinth downloads
No ratings yetSpigot rating
1.1.0Current version
Private buildLast public update

Full overview

A complete moderation workspace built around fast, informed action.

StaffCore brings routine moderation actions and player context into one workspace. Staff can move from a report to a profile, evidence, notes and punishment history without relying on disconnected commands or external spreadsheets.

The aim is faster action with better consistency: important information remains attached to the player so different moderators can understand what happened before making a decision.

Best suited toPrivate community servers that need a joined-up moderation process instead of isolated commands.

How it works

Investigate, document and act from one moderation flow

Staff mode and player profiles provide the context needed during an investigation. Notes, historical actions, inventory snapshots and alt information help moderators gather evidence before issuing a punishment.

Freeze, warn, mute, kick and ban actions can use structured reasons and punishment ladders. Discord webhooks create an external record for staff review and accountability.

  • Fewer disconnected moderation commands
  • Persistent player context and staff notes
  • Structured punishment history and ladders
  • Discord records for accountability

Administration

Configuration and live-server use

Permissions separate staff capabilities, while configurable ladders and webhook destinations adapt the system to the server team. The project is private and designed around GhoulCraft's moderation workflow.

CompatibilityPaper 1.21.x IntegrationsDiscord webhooks, Permissions plugins VersionPrivate

Feature breakdown

Everything included in StaffCore

Each headline feature is expanded below so visitors can understand the real server use rather than seeing a short tag list.

Freeze, warn, mute, kick and ban

Common actions are available from a consistent moderation system.

Staff mode

Prepare moderators with the tools and visibility needed during investigations.

Player profiles and notes

Keep useful context attached to the player for the whole team.

Punishment history

Review prior actions before deciding on escalation.

Inventory snapshots

Capture evidence about a player's items at important moments.

Alt checking and ladders

Support repeat-offender decisions and structured punishment progression.

Getting started

Installation and rollout

This project is not currently offered as a public platform download; its page documents the system and development status.

  1. 1

    Private deployment is configured around the staff permission structure.

  2. 2

    Punishment ladders, reason prompts and webhook channels are reviewed with the moderation team.

  3. 3

    Staff actions are tested using non-production accounts.

  4. 4

    Access is limited to the minimum permission level required for each role.

Tokens & placeholders

Text tokens found in the source

Availability depends on the feature that references each token.

%duration%%player%%reason%%remaining%%staff%

Source architecture

68 Java classes across 9 packages

gui (21), managers (18), listeners (8), models (7), utils (5), storage (4), commands (2), hooks (2)

Core systems

AltAccountsGUI, BanGUI, ConfirmGUI, DeathLogsGUI, HistoryGUI, InventorySnapshotsGUI, KickGUI, LadderGUI, MainStaffGUI, MuteGUI, NotesGUI, PlayerListGUI, PlayerModerationGUI, SessionHistoryGUI, TeleportHistoryGUI, WarnGUI, Main, ChatInputType and 10 more

Commands

StaffCommand, StaffTabCompleter

GUI & menus

GUIType, GUIUtil, GuiEditorGUI, StaffGUIHolder, PlaceholderHook, GUIListener

Listeners & events

ChatInputListener, FrozenPlayerListener, MuteListener, PlayerJoinListener, StaffAlertListener, StaffModeListener, StaffTrackingListener

Managers & services

AlertManager, AltAccountManager, BanManager, ChatInputManager, DeathLogManager, FreezeManager, HistoryManager, LadderManager, MuteManager, NotesManager, PunishmentManager, SessionManager, SnapshotManager, StaffModeManager, StaffTargetManager, TeleportHistoryManager, WarnManager, WebhookManager and 4 more

Integrations & API

FloodgateHook

Models & data

PlayerProfileGUI

Utilities

ColorUtil

Configuration reference

5 bundled YAML files

Top-level sections and defaults are summarised from the supplied resources.

config.yml

  • Settings — 3 nested settings: Prefix, Restore-Walk-Speed, Save-Data-On-Action
  • Frozen — 5 nested settings: Block-Breaking, Block-Placing, Block-Inventory-Click, Block-All-Commands, Blocked-Commands
  • Muted — 1 nested settings: Blocked-Commands
  • GUI — 2 nested settings: Fill-Empty-Slots, Filler-Material
  • Staff-Mode — 4 nested settings: GameMode, Allow-Flight, Restore-Location, Hide-From-Non-Staff
  • Inventory-Snapshots — 3 nested settings: Enabled, Interval-Minutes, Max-Per-Player
  • Death-Logs — 2 nested settings: Snapshot-On-Death, Alerts
  • Discord — 6 nested settings: Enabled, Webhook-URL, Username, Avatar-URL, Server-Name, Footer
  • Hooks — 1 nested settings: Floodgate-Bedrock-Prefix
  • Staff-Alerts — 3 nested settings: Notify-Staff-On-Freeze, Notify-Staff-On-Mute, Notify-Staff-On-Ban

data.yml

  • Players — 0 nested settings:
  • History — 0 nested settings:
  • Sessions — 0 nested settings:
  • Teleport-History — 0 nested settings:
  • Inventory-Snapshots — 0 nested settings:
  • Death-Logs — 0 nested settings:
  • Staff — 0 nested settings:

gui.yml

  • GUI — 10 nested settings: Main-Title, Player-List-Title, Player-Moderation-Title, Player-Profile-Title, Warn-Title, Kick-Title, Mute-Title…

messages.yml

  • Messages — 38 nested settings: No-Permission, Player-Only, Reloaded, Target-Offline, Cannot-Punish-Bypass, No-Targets, No-Selected-Target…

punishments.yml

  • Warnings — 1 nested settings: Reasons
  • Kicks — 1 nested settings: Reasons
  • Mutes — 2 nested settings: Reason, Durations
  • Bans — 2 nested settings: Reason, Durations
  • Ladders — 3 nested settings: Chat Abuse, Advertising, Cheating

Permissions

29 declared permission nodes

Defaults and descriptions come directly from plugin.yml.

staffcore.admin

Full StaffCore access.

Default: op

staffcore.menu

No description declared.

Default: op

staffcore.reload

No description declared.

Default: op

staffcore.freeze

No description declared.

Default: op

staffcore.warn

No description declared.

Default: op

staffcore.kick

No description declared.

Default: op

staffcore.mute

No description declared.

Default: op

staffcore.ban

No description declared.

Default: op

staffcore.ipban

No description declared.

Default: op

staffcore.teleport

No description declared.

Default: op

staffcore.inspect

No description declared.

Default: op

staffcore.notes

No description declared.

Default: op

staffcore.history

No description declared.

Default: op

staffcore.profile

No description declared.

Default: op

staffcore.staffmode

No description declared.

Default: op

staffcore.staffmode.see

No description declared.

Default: op

staffcore.sessions

No description declared.

Default: op

staffcore.alts

No description declared.

Default: op

staffcore.snapshots

No description declared.

Default: op

staffcore.deathlogs

No description declared.

Default: op

staffcore.teleporthistory

No description declared.

Default: op

staffcore.ladders

No description declared.

Default: op

staffcore.alerts

No description declared.

Default: op

staffcore.guieditor

No description declared.

Default: op

staffcore.bypass

No description declared.

Default: op

staffcore.bypass.freeze

No description declared.

Default: op

staffcore.bypass.mute

No description declared.

Default: op

staffcore.bypass.ban

No description declared.

Default: op

staffcore.snapshot.exempt

No description declared.

Default: not specified

Commands

1 declared command

Aliases, usage and permissions come directly from plugin.yml.

/

/staff

Opens the StaffCore moderation menu.

Aliases: /staffcore, /sc, /staffmode · Usage: /staff · Permission: None declared

Source-verified reference

Checked against StaffCore 1.1.0

This static reference is built from the supplied plugin.yml, YAML resources and Java source. No browser-generated documentation is used.

Main classme.Ghoul.StaffCore.MainAPI version1.18Java classes68 Hard dependenciesNoneSoft dependenciesPlaceholderAPI, floodgateLoad beforeNone

Related projects

Continue exploring