Staff Management - ZeroG-Network/NeoEssentials GitHub Wiki
This guide covers how to effectively manage your server staff team using NeoEssentials' staff management features.
NeoEssentials supports a flexible staff hierarchy system that works with permission plugins like LuckPerms. Here's a recommended structure:
Owner
├── Admin
│ ├── Senior Moderator
│ │ ├── Moderator
│ │ │ ├── Helper
│ │ │ │ └── Trial Helper
NeoEssentials integrates with LuckPerms for permission management:
- Install LuckPerms alongside NeoEssentials
- Create staff groups with appropriate permissions
Example commands:
/lp creategroup owner
/lp creategroup admin
/lp creategroup srmod
/lp creategroup mod
/lp creategroup helper
/lp creategroup trial
/lp group admin parent set owner
/lp group srmod parent set admin
/lp group mod parent set srmod
/lp group helper parent set mod
/lp group trial parent set helper
Assign these permission patterns:
/lp group owner permission set neoessentials.admin.*
/lp group admin permission set neoessentials.admin.*
/lp group srmod permission set neoessentials.mod.*
/lp group mod permission set neoessentials.mod.*
/lp group helper permission set neoessentials.helper.*
/lp group trial permission set neoessentials.trial.*
NeoEssentials provides several commands for staff management:
Command | Permission | Description |
---|---|---|
/staff |
neoessentials.command.staff |
Displays online staff members |
/staffchat |
neoessentials.command.staffchat |
Toggles staff chat mode |
/sc <message> |
neoessentials.command.staffchat |
Sends a message to staff chat |
/vanish |
neoessentials.command.vanish |
Toggles invisibility to regular players |
/freeze <player> |
neoessentials.command.freeze |
Freezes a player in place |
/inspect <player> |
neoessentials.command.inspect |
Shows information about a player |
Command | Permission | Description |
---|---|---|
/warn <player> <reason> |
neoessentials.command.warn |
Issues a warning to a player |
/history <player> |
neoessentials.command.history |
Shows a player's moderation history |
/kick <player> <reason> |
neoessentials.command.kick |
Kicks a player from the server |
/ban <player> <duration> <reason> |
neoessentials.command.ban |
Bans a player from the server |
/mute <player> <duration> <reason> |
neoessentials.command.mute |
Prevents a player from chatting |
/stafftp <player> |
neoessentials.command.stafftp |
Teleports to a player without notification |
Staff mode provides special capabilities for monitoring and moderating players:
/staffmode
Features in staff mode:
- Invisibility to regular players
- Ability to see other vanished staff
- Flight capabilities
- Special item tools for moderation
- Inspection abilities
- Cannot break/place blocks
Staff chat allows private communication between staff members:
/staffchat
Configuration in config/neoessentials/chat.toml
:
[staffChat]
enabled = true
prefix = "&8[&cStaff&8] &r"
format = "{prefix}{displayname}&8: &7{message}"
notificationSound = "minecraft:entity.experience_orb.pickup"
NeoEssentials can track staff activity to help with team management:
Enable in config/neoessentials/staff.toml
:
[staffActivity]
enabled = true
logCommands = true
logLogin = true
logLogout = true
logModActions = true
Generate staff activity reports:
/staffreport <player> <timeframe>
/staffreport all <timeframe>
Configure which events notify staff:
[staffNotifications]
playerJoin = true
playerQuit = true
playerReports = true
serverWarnings = true
notifyMethod = "chat" # Options: chat, actionbar, title
For new staff members:
/stafftraining <player>
When in training mode:
- All commands are logged but don't take effect
- Senior staff can monitor actions
- A confirmation prompt appears before actions
Set up templates for different staff ranks:
/templateperms create helper
/templateperms add helper neoessentials.command.tp
/templateperms add helper neoessentials.command.staffchat
Apply templates to players:
/templateperms apply helper NewStaffMember
NeoEssentials provides an in-game staff application system:
Configure in config/neoessentials/staff.toml
:
[staffApplications]
enabled = true
cooldownDays = 14
minimumPlaytime = "24h"
questions = [
"How old are you?",
"How long have you played on the server?",
"Why do you want to be staff?",
"What would you do if you saw someone breaking rules?"
]
Command | Permission | Description |
---|---|---|
/apply |
neoessentials.command.apply |
Starts the application process |
/applications |
neoessentials.command.applications |
Lists pending applications |
/reviewapp <id> |
neoessentials.command.reviewapp |
Reviews an application |
Schedule and manage staff meetings:
/staffmeeting schedule "Server Update Discussion" 2025-07-15T19:00:00
/staffmeeting invite @staff
/staffmeeting start
/staffmeeting notes "Discussed new rules and upcoming events"
NeoEssentials maintains detailed logs of staff actions:
[staffLogs]
enabled = true
logToFile = true
logToDatabase = true
retentionDays = 30
detailedCommands = true
/stafflogs <player> <timeframe>
/stafflogs <action> <timeframe>
/stafflogs recent
- Clear Guidelines: Establish clear staff guidelines and rules
- Regular Training: Hold regular staff training sessions
- Activity Requirements: Set minimum activity requirements
- Performance Reviews: Conduct periodic performance reviews
- Communication Channels: Maintain open communication channels
- Accountability: Hold staff accountable for their actions
- Reward System: Recognize and reward good performance
- Staff Training Manual Template
- Common Moderation Scenarios
- NeoEssentials Discord for staff management support
- GitHub Repository for latest updates