SentinelModeration

Minecraft 版本： 1.20 1.20.1 1.20.2 1.20.3 1.20.4 1.20.5 1.20.6

平台： paper

标签： management

SentinelMC ?️

The cleanest all-in-one moderation suite for Paper servers.

One command. Everything in a GUI. Zero TPS impact.

SentinelMC replaces a pile of separate moderation plugins with a single, polished GUI-driven suite. Staff types /sentinel — no commands to memorize, no permission nodes for every action.

✨ Features at a Glance

? Intelligence Panel

• Full player dossier: IP, first join, last seen, ban & warn status
• Alt account detection — automatically finds players sharing an IP
• Staff note system — attach private notes to any player profile

⚔️ Moderation Actions

? Staff Personal Tools

• Vanish — invisible to players, persists across reconnects
• Ghost Mode — silently open any container without animation
• God Mode — personal invincibility
• Social Spy — monitor /msg, /tell, /w, /r
• Staff Chat — private channel, one click to toggle

?️ Staff Warn System (Owner only)

• Issue official warnings to staff members, stored in database
• Configurable warn threshold (default: 3 warns)
• At threshold → Demotion GUI opens automatically
• Owner selects destination rank visually — no commands needed
• LuckPerms integration — rank change is instant and automatic
• Warns auto-clear after demotion (configurable)

?️ Server Ops

• Maintenance mode (blocks non-staff joins)
• Chat lock (silences players)
• World cleanup (day + clear weather in one click)
• Entity purge (drops, arrows, snowballs)

? Audit Log

• Last 20 bans + staff warns in a single scrollable GUI

? Installation

1. Download SentinelMC-1.0.0.jar
2. Drop it in your server's plugins/ folder
3. Restart the server — do not use /reload
4. Edit plugins/SentinelMC/config.yml with your rank names and preferences
5. Assign permissions (see below)

LuckPerms is optional. All features work without it — only automatic rank demotion requires LuckPerms.

? Permissions

Quick setup with LuckPerms:

/lp group mod permission set sentinel.use true
/lp group owner permission set sentinel.owner true

⌨️ Commands

While spectating, /sentinel exits spectator mode and restores your previous gamemode.

⚙️ Configuration Highlights

The config.yml is thoroughly commented. Key options:

# Your LuckPerms group names, highest → lowest
rank-hierarchy:
  - owner
  - admin
  - mod
  - helper
  - member

# Warn threshold for staff demotion
staff-warns:
  max-warns: 3
  clear-after-demotion: true

# Toggle broadcast messages to staff
broadcast:
  bans: true
  kicks: true
  freeze: true

# Customize punishment values
punishments:
  sky-launch:
    velocity-y: 5.5
  divine-smite:
    strike-count: 2

# Fully customizable screens (& color codes supported)
messages:
  ban-screen: "&c&l☠ YOU ARE BANNED\n&7Reason: &f%reason%"

? Compatibility

This plugin uses Paper-specific APIs (AsyncChatEvent, Adventure). It will refuse to load on Spigot.

?️ Building from Source

git clone https://github.com/MarcialKT/SentinelMC
cd SentinelMC
mvn clean package
# Output: target/SentinelMC-1.0.0.jar

? Issues & Support

Please open a GitHub issue with:

• Paper version (/version in-game)
• SentinelMC version
• Full stack trace from logs/latest.log (if any)
• Steps to reproduce

? License

MIT — free to use, modify and distribute with attribution.

Made with ❤️ by MarcialKT