SentinelMC ?️
专为 Paper 服务器打造的极简全能管理套件。
一条指令。全图形界面操作。零 TPS 影响。
SentinelMC 将一堆独立的管理插件整合为一个单一、精致的 GUI 驱动套件。员工只需输入 /sentinel —— 无需记忆命令,也无需为每个操作单独配置权限节点。
✨ 功能概览
? 情报面板
- 完整的玩家档案:IP 地址、首次加入时间、最后上线时间、封禁与警告状态
- 小号检测 — 自动发现共享同一 IP 的玩家
- 员工备注系统 — 可为任何玩家档案附加私人备注
⚔️ 管理操作
| 操作 |
在线 |
离线 |
| 永久封禁 |
✅ |
✅ |
| 解封 |
✅ |
✅ |
| 踢出 |
✅ |
— |
| 冻结(移动锁定) |
✅ |
— |
| 暗影监牢(失明 + 锁定) |
✅ |
— |
| 天启发射 |
✅ |
— |
| 吸取生命值 |
✅ |
— |
| 神圣惩罚(真实闪电) |
✅ |
— |
| 点燃 |
✅ |
— |
| 凋灵 II |
✅ |
— |
| 反胃 II |
✅ |
— |
| 治疗 |
✅ |
— |
| 实时查看物品栏 (InvSee) |
✅ |
— |
| 末影箱检查 |
✅ |
— |
| 传送至玩家 |
✅ |
— |
旁观模式(使用 /sentinel 退出) |
✅ |
— |
? 员工个人工具
- 隐身 — 对玩家不可见,重连后依然保持
- 幽灵模式 — 无声打开任何容器且无动画效果
- 上帝模式 — 个人无敌状态
- 社交间谍 — 监控
/msg、/tell、/w、/r
- 员工聊天 — 私有频道,一键切换开关
?️ 员工警告系统 (仅限所有者)
- 向员工发出正式警告,并存储在数据库中
- 可配置的警告阈值(默认:3 次警告)
- 达到阈值时 → 降级 GUI 自动弹出
- 所有者通过视觉选择目标职位等级 —— 无需命令
- LuckPerms 集成 — 等级变更即时且自动完成
- 降级后警告自动清除(可配置)
?️ 服务器运维
- 维护模式(阻止非员工加入)
- 聊天锁定(静默玩家)
- 世界清理(一键重置白天天气)
- 实体清除(掉落物、箭矢、雪球)
? 审计日志
- 在单个可滚动的 GUI 中展示最近 20 次封禁记录 + 员工警告
? 安装
- 下载
SentinelMC-1.0.0.jar
- 将其放入服务器的
plugins/ 文件夹中
- 重启服务器 —— 不要使用
/reload
- 编辑
plugins/SentinelMC/config.yml 以设置你的职位等级名称和偏好
- 分配权限(见下文)
LuckPerms 是可选的。 所有功能均可在没有 LuckPerms 的情况下正常工作 —— 只有自动降级功能需要 LuckPerms。
? 权限
| 权限 |
描述 |
默认值 |
sentinel.use |
完全访问管理 GUI |
op |
sentinel.owner |
员工警告面板 + 等级降级 |
false |
配合 LuckPerms 的快速设置:
/lp group mod permission set sentinel.use true
/lp group owner permission set sentinel.owner true
⌨️ 命令
| 命令 |
描述 |
/sentinel |
打开管理中心 |
/sen |
别名 |
/mod |
别名 |
/staff |
别名 |
在旁观模式下,/sentinel 会退出旁观模式并恢复你之前的游戏模式。
⚙️ 配置亮点
config.yml 包含详尽的注释。关键选项如下:
# 你的 LuckPerms 组名,从高到低排列
rank-hierarchy:
- owner
- admin
- mod
- helper
- member
# 员工降级的警告阈值
staff-warns:
max-warns: 3
clear-after-demotion: true
# 是否向员工广播消息
broadcast:
bans: true
kicks: true
freeze: true
# 自定义惩罚数值
punishments:
sky-launch:
velocity-y: 5.5
divine-smite:
strike-count: 2
# 完全可自定义的屏幕文本(支持颜色代码)
messages:
ban-screen: "&c&l☠ YOU ARE BANNED\n&7Reason: &f%reason%"
? 兼容性
|
|
| 服务端软件 |
仅支持 Paper 1.20 – 1.21.x |
| Java |
17 或更高版本 |
| LuckPerms |
5.x —— 可选(软依赖) |
| Spigot / CraftBukkit |
❌ 不支持 |
此插件使用了 Paper 特有的 API(AsyncChatEvent、Adventure)。它会在 Spigot 上拒绝加载。
?️ 从源码构建
git clone https://github.com/MarcialKT/SentinelMC
cd SentinelMC
mvn clean package
# 输出:target/SentinelMC-1.0.0.jar
? 问题与支持
请提交 GitHub Issue,并包含以下内容:
- Paper 版本号(在游戏中输入
/version)
- SentinelMC 版本
logs/latest.log 中的完整堆栈跟踪(如果有)
- 复现步骤
? 许可证
MIT —— 可免费使用、修改和分发,但需注明出处。
由 MarcialKT 用 ❤️ 制作
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
| Action |
Online |
Offline |
| Permanent Ban |
✅ |
✅ |
| Unban |
✅ |
✅ |
| Kick |
✅ |
— |
| Freeze (movement lock) |
✅ |
— |
| Shadow Jail (blindness + lock) |
✅ |
— |
| Sky Launch |
✅ |
— |
| Drain HP |
✅ |
— |
| Divine Smite (real lightning) |
✅ |
— |
| Ignite |
✅ |
— |
| Wither II |
✅ |
— |
| Nausea II |
✅ |
— |
| Heal |
✅ |
— |
| InvSee (live inventory) |
✅ |
— |
| EnderChest inspect |
✅ |
— |
| Teleport to player |
✅ |
— |
| Spectate (exit with /sentinel) |
✅ |
— |
? 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
- Download
SentinelMC-1.0.0.jar
- Drop it in your server's
plugins/ folder
- Restart the server — do not use
/reload
- Edit
plugins/SentinelMC/config.yml with your rank names and preferences
- Assign permissions (see below)
LuckPerms is optional. All features work without it — only automatic rank demotion requires LuckPerms.
? Permissions
| Permission |
Description |
Default |
sentinel.use |
Full access to the moderation GUI |
op |
sentinel.owner |
Staff Warn panel + rank demotion |
false |
Quick setup with LuckPerms:
/lp group mod permission set sentinel.use true
/lp group owner permission set sentinel.owner true
⌨️ Commands
| Command |
Description |
/sentinel |
Open the moderation hub |
/sen |
Alias |
/mod |
Alias |
/staff |
Alias |
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
|
|
| Server software |
Paper 1.20 – 1.21.x only |
| Java |
17 or higher |
| LuckPerms |
5.x — optional (softdepend) |
| Spigot / CraftBukkit |
❌ Not supported |
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
评论 0
登录后参与评分
还没有评论,来抢沙发吧