# SentinelMC \ud83d\udee1\ufe0f
\n### The cleanest all-in-one moderation suite for Paper servers.<\/p>\n
\n
\n
\n
\n<\/p>\n
> **One command. Everything in a GUI. Zero TPS impact.**<\/p>\n
SentinelMC replaces a pile of separate moderation plugins with a single, polished GUI-driven suite. Staff types `\/sentinel` \u2014 no commands to memorize, no permission nodes for every action.<\/p>\n
—<\/p>\n
## \u2728 Features at a Glance<\/p>\n
### \ud83d\udd0d Intelligence Panel
\n– Full player dossier: IP, first join, last seen, ban & warn status
\n– **Alt account detection** \u2014 automatically finds players sharing an IP
\n– Staff note system \u2014 attach private notes to any player profile<\/p>\n
### \u2694\ufe0f Moderation Actions<\/p>\n
| Action | Online | Offline |
\n|——–|:——:|:——-:|
\n| Permanent Ban | \u2705 | \u2705 |
\n| Unban | \u2705 | \u2705 |
\n| Kick | \u2705 | \u2014 |
\n| Freeze (movement lock) | \u2705 | \u2014 |
\n| Shadow Jail (blindness + lock) | \u2705 | \u2014 |
\n| Sky Launch | \u2705 | \u2014 |
\n| Drain HP | \u2705 | \u2014 |
\n| Divine Smite (real lightning) | \u2705 | \u2014 |
\n| Ignite | \u2705 | \u2014 |
\n| Wither II | \u2705 | \u2014 |
\n| Nausea II | \u2705 | \u2014 |
\n| Heal | \u2705 | \u2014 |
\n| InvSee (live inventory) | \u2705 | \u2014 |
\n| EnderChest inspect | \u2705 | \u2014 |
\n| Teleport to player | \u2705 | \u2014 |
\n| Spectate (exit with \/sentinel) | \u2705 | \u2014 |<\/p>\n
### \ud83d\udc64 Staff Personal Tools
\n– **Vanish** \u2014 invisible to players, persists across reconnects
\n– **Ghost Mode** \u2014 silently open any container without animation
\n– **God Mode** \u2014 personal invincibility
\n– **Social Spy** \u2014 monitor `\/msg`, `\/tell`, `\/w`, `\/r`
\n– **Staff Chat** \u2014 private channel, one click to toggle<\/p>\n
### \ud83c\udf96\ufe0f Staff Warn System *(Owner only)*
\n– Issue official warnings to staff members, stored in database
\n– Configurable warn threshold (default: **3 warns**)
\n– At threshold \u2192 **Demotion GUI** opens automatically
\n– Owner selects destination rank visually \u2014 no commands needed
\n– **LuckPerms integration** \u2014 rank change is instant and automatic
\n– Warns auto-clear after demotion (configurable)<\/p>\n
### \ud83d\udda5\ufe0f Server Ops
\n– Maintenance mode (blocks non-staff joins)
\n– Chat lock (silences players)
\n– World cleanup (day + clear weather in one click)
\n– Entity purge (drops, arrows, snowballs)<\/p>\n
### \ud83d\udccb Audit Log
\n– Last 20 bans + staff warns in a single scrollable GUI<\/p>\n
—<\/p>\n
## \ud83d\udce6 Installation<\/p>\n
1. Download `SentinelMC-1.0.0.jar`
\n2. Drop it in your server’s `plugins\/` folder
\n3. **Restart** the server \u2014 do **not** use `\/reload`
\n4. Edit `plugins\/SentinelMC\/config.yml` with your rank names and preferences
\n5. Assign permissions (see below)<\/p>\n
> **LuckPerms is optional.** All features work without it \u2014 only automatic rank demotion requires LuckPerms.<\/p>\n
—<\/p>\n
## \ud83d\udd11 Permissions<\/p>\n
| Permission | Description | Default |
\n|————|————-|———|
\n| `sentinel.use` | Full access to the moderation GUI | `op` |
\n| `sentinel.owner` | Staff Warn panel + rank demotion | `false` |<\/p>\n
**Quick setup with LuckPerms:**
\n“`
\n\/lp group mod permission set sentinel.use true
\n\/lp group owner permission set sentinel.owner true
\n“`<\/p>\n
—<\/p>\n
## \u2328\ufe0f Commands<\/p>\n
| Command | Description |
\n|———|————-|
\n| `\/sentinel` | Open the moderation hub |
\n| `\/sen` | Alias |
\n| `\/mod` | Alias |
\n| `\/staff` | Alias |<\/p>\n
> While spectating, `\/sentinel` exits spectator mode and restores your previous gamemode.<\/p>\n
—<\/p>\n
## \u2699\ufe0f Configuration Highlights<\/p>\n
The `config.yml` is thoroughly commented. Key options:<\/p>\n
“`yaml
\n# Your LuckPerms group names, highest \u2192 lowest
\nrank-hierarchy:
\n – owner
\n – admin
\n – mod
\n – helper
\n – member<\/p>\n
# Warn threshold for staff demotion
\nstaff-warns:
\n max-warns: 3
\n clear-after-demotion: true<\/p>\n
# Toggle broadcast messages to staff
\nbroadcast:
\n bans: true
\n kicks: true
\n freeze: true<\/p>\n
# Customize punishment values
\npunishments:
\n sky-launch:
\n velocity-y: 5.5
\n divine-smite:
\n strike-count: 2<\/p>\n
# Fully customizable screens (& color codes supported)
\nmessages:
\n ban-screen: “&c&l\u2620 YOU ARE BANNEDn&7Reason: &f%reason%”
\n“`<\/p>\n
—<\/p>\n
## \ud83d\udd0c Compatibility<\/p>\n
| | |
\n|–|–|
\n| **Server software** | Paper 1.20 \u2013 1.21.x only |
\n| **Java** | 17 or higher |
\n| **LuckPerms** | 5.x \u2014 optional (softdepend) |
\n| **Spigot \/ CraftBukkit** | \u274c Not supported |<\/p>\n
> This plugin uses Paper-specific APIs (`AsyncChatEvent`, Adventure). It will refuse to load on Spigot.<\/p>\n
—<\/p>\n
## \ud83c\udfd7\ufe0f Building from Source<\/p>\n
“`bash
\ngit clone https:\/\/github.com\/MarcialKT\/SentinelMC
\ncd SentinelMC
\nmvn clean package
\n# Output: target\/SentinelMC-1.0.0.jar
\n“`<\/p>\n
—<\/p>\n
## \ud83d\udc1b Issues & Support<\/p>\n
Please open a GitHub issue with:
\n– Paper version (`\/version` in-game)
\n– SentinelMC version
\n– Full stack trace from `logs\/latest.log` (if any)
\n– Steps to reproduce<\/p>\n
—<\/p>\n
## \ud83d\udcc4 License<\/p>\n
MIT \u2014 free to use, modify and distribute with attribution.<\/p>\n
—<\/p>\n
*Made with \u2764\ufe0f by MarcialKT*<\/p>\n","protected":false},"excerpt":{"rendered":"
This plugin is an advance moderation server for small and big minecraft servers.<\/p>\n","protected":false},"featured_media":137170,"template":"","meta":{"_minecraft_slug":"sentinelmoderation","_minecraft_project_id":"qXcFKaT2","_minecraft_author":"Marcialkt","_minecraft_license":"MIT","_minecraft_downloads":5,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"sentinelmoderation.zip","_minecraft_size_bytes":37658,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T12:28:49.365193Z","_minecraft_date_created":"2026-04-11T18:17:07.779456Z","_minecraft_date_modified":"2026-04-05T11:03:58.788450Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/sentinelmoderation","_minecraft_icon_attachment_id":137170,"_minecraft_imported_at":"2026-06-08T02:33:55+00:00","_minecraft_import_hash":"a31f1717aeee12e2e580cd533a4e8898","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,127,867],"mod_loader":[132],"minecraft_version":[59,36,60,93,94,101,102],"class_list":["post-137169","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-paper","mod_category-social","mod_loader-paper","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6"],"yoast_head":"\n