SurvivalAdmin
适用于 Minecraft 生存服务器的专业管理插件,支持基于角色的访问控制。
一个 JAR 文件,兼容 Paper/Purpur/Spigot。由 Omega 制作
✨ 功能
-
基于角色的访问控制 — 支持 user、staff、owner,具备权限继承功能
-
基于 UUID 的角色存储 — 按玩家 UUID 存储角色信息,不受名称更改和欺骗影响
-
命令拦截 — 普通用户仅可使用白名单中的命令;其余所有命令均被拦截
-
命名空间/别名绕过防护 — 拦截 /bukkit:plugins、/minecraft:gamemode 等命令
-
Tab 补全过滤 — 被拦截的命令不会出现在补全建议中
-
自定义消息 — 支持配置加入、离开、死亡及击杀消息,并支持占位符
-
15+ 条管理员命令 — heal(治疗)、feed(喂食)、tp(传送)、gamemode(游戏模式)、fly(飞行)、god(上帝模式)、time(时间)、weather(天气)、invsee(查看物品栏)、kick(踢出)、ban(封禁)、tempban(临时封禁)、mute(静音)、vanish(隐身)、sit(坐下)
-
物品栏检查 — /inv <玩家> 可查看/编辑玩家物品栏
-
带时长的封禁 — /getoff <玩家> <时长> [理由] 支持 1h、1d、30m、permanent(永久)
-
隐身模式 — /invis / /vanish 使自己在 TAB 列表和世界范围内不可见
-
细粒度权限 — survivaladmin.kick、survivaladmin.ban、survivaladmin.mute 等
-
原子文件写入 — 防崩溃的角色存储
-
审计日志 — 所有管理员操作均会记录时间戳和操作者
-
YAML 配置 — 方便编辑 config.yml
📦 安装
- 从 Releases 下载
SurvivalAdmin-2.0.0.jar
- 放入
plugins/ 目录
- 启动服务器 —— 将创建
plugins/SurvivalAdmin/ 目录并生成 config.yml
- 编辑
config.yml 以设置管理员和工作人员
- 重启服务器
⚙️ 配置
config.yml
# 角色
roles:
default: "user" # 新玩家的默认角色
staff: [] # 工作人员玩家名称列表(首次加入时自动迁移为 UUID)
owner:
- "DevOmega" # 所有者玩家名称列表(首次加入时自动迁移为 UUID)
# 每个角色的细粒度权限
permissions:
user: []
staff:
- survivaladmin.kick
- survivaladmin.ban
- survivaladmin.tempban
- survivaladmin.unban
- survivaladmin.mute
- survivaladmin.unmute
- survivaladmin.tp
- survivaladmin.heal
- survivaladmin.feed
- survivaladmin.gamemode
- survivaladmin.fly
- survivaladmin.god
- survivaladmin.time
- survivaladmin.weather
- survivaladmin.invsee
- survivaladmin.vanish
owner:
- survivaladmin.* # 所有权限
# 允许普通用户使用的命令(其他命令均被禁止)
user-commands:
- "sit"
- "msg"
- "tell"
- "w"
- "me"
- "list"
- "help"
自定义消息(使用 {player}、{role}、{killer} 占位符)
messages:
no-permission: "§c您没有此命令的权限"
command-blocked: "§c此命令在此服务器上不可用"
role-given: "§a已向玩家 {player} 分配角色 {role}"
role-removed: "§c已从玩家 {player} 移除角色 {role}"
unknown-role: "§c未知的角色:{role}"
player-not-found: "§c未找到玩家 {player}"
join: "§a{player} 加入了游戏"
quit: "§c{player} 离开了游戏"
death: "§c{player} 死亡"
kill: "§c{player} 被玩家 {killer} 击杀"
### roles.json(自动生成)
角色以 **UUID** 形式存储在 `plugins/SurvivalAdmin/roles.json` 中:
```json
{
"c1c3bec8-a19f-3fc5-afef-b5c7e1c3ab21": {"role": "owner", "name": "DevOmega"},
"550e8400-e29b-41d4-a716-446655440000": {"role": "staff", "name": "Player1"}
}
旧版基于名称的角色(来自较早版本)会在玩家加入时自动迁移为 UUID。
🔧 命令
所有玩家可用
| 命令 |
描述 |
/sit |
坐下 |
/msg <player> <message> |
发送私聊消息 |
/help |
显示可用命令 |
仅管理员使用(需要管理员或所有者权限)
| 命令 |
描述 |
/admin |
显示管理面板 |
/kick <player> [reason] |
踢出玩家 |
/ban <player> [reason] |
封禁玩家 |
/tempban <player> <duration> [reason] |
临时封禁 |
/unban <player> |
解封玩家 |
/mute <player> [reason] |
静音玩家 |
/unmute <player> |
取消静音玩家 |
/heal [player] |
治疗玩家 |
/feed [player] |
喂饱玩家 |
/tp <player> |
传送至玩家 |
/gm <0-3> [player] |
更改游戏模式 |
/fly [player] |
切换飞行模式 |
/god [player] |
切换上帝模式 |
/time <day/night/number> |
更改时间 |
/weather <clear/rain/thunder> |
更改天气 |
/inv <player> |
查看/编辑玩家物品栏 |
/getoff <player> <time> [reason] |
封禁指定时长的玩家并说明原因 |
/invis / /vanish |
切换隐身状态 |
仅限所有者使用
| 命令 |
描述 |
/staff <玩家> |
授予工作人员权限 |
/unstaff <玩家> |
移除工作人员权限 |
/owner <玩家> |
授予所有者权限 |
/unowner <玩家> |
移除所有者权限 |
🔒 权限
| 权限 |
描述 |
默认值 |
survivaladmin.owner |
管理员权限 |
op |
survivaladmin.staff |
工作人员权限 |
false |
survivaladmin.user |
用户权限 |
true |
survivaladmin.kick |
踢出玩家 |
false |
survivaladmin.ban |
封禁玩家 |
false |
survivaladmin.tempban |
临时封禁玩家 |
false |
survivaladmin.unban |
解除封禁 |
false |
survivaladmin.mute |
禁言玩家 |
false |
survivaladmin.unmute |
解除禁言 |
false |
survivaladmin.tp |
传送至玩家位置 |
false |
survivaladmin.heal |
治疗玩家 |
false |
survivaladmin.feed |
喂食玩家 |
false |
survivaladmin.gamemode |
更改游戏模式 |
false |
survivaladmin.fly |
切换飞行模式 |
false |
survivaladmin.god |
切换创造/无敌模式 |
false |
survivaladmin.time |
更改时间 |
false |
survivaladmin.weather |
更改天气 |
false |
survivaladmin.invsee |
查看玩家物品栏 |
false |
survivaladmin.vanish |
切换隐身模式 |
false |
🛠️ 构建
./build.sh
# -> target/SurvivalAdmin-2.0.0.jar
需要 Paper/Purpur API jar(自动从 ../../servers/ 检测)。
SurvivalAdmin
Professional administration plugin for Minecraft Survival servers with role-based access control.
One jar, Paper/Purpur/Spigot compatible. Made by Omega
✨ Features
- Role-based access control —
user, staff, owner with permission inheritance
- UUID-based role storage — roles stored by player UUID, immune to name changes and spoofing
- Command blocking — regular users can only use whitelisted commands; all others are blocked
- Namespace/alias bypass prevention — blocks
/bukkit:plugins, /minecraft:gamemode, etc.
- Tab completion filtering — blocked commands hidden from suggestions
- Custom messages — join, quit, death, kill messages with placeholders
- 15+ admin commands — heal, feed, tp, gamemode, fly, god, time, weather, invsee, kick, ban, tempban, mute, vanish, sit
- Inventory inspection —
/inv <player> to view/edit player inventory
- Ban with duration —
/getoff <player> <time> [reason] supports 1h, 1d, 30m, permanent
- Vanish mode —
/invis / /vanish to become invisible in TAB and the world
- Granular permissions —
survivaladmin.kick, survivaladmin.ban, survivaladmin.mute, etc.
- Atomic file writes — crash-safe role storage
- Audit log — every admin action is logged with timestamp and actor
- YAML config — easy to edit
config.yml
📦 Installation
- Download
SurvivalAdmin-2.0.0.jar from Releases
- Put in
plugins/
- Start server —
plugins/SurvivalAdmin/ is created with config.yml
- Edit
config.yml to set owners and staff
- Restart server
⚙️ Configuration
config.yml
# Roles
roles:
default: "user" # Default role for new players
staff: [] # List of staff player names (auto-migrated to UUID on first join)
owner:
- "DevOmega" # List of owner player names (auto-migrated to UUID on first join)
# Granular permissions per role
permissions:
user: []
staff:
- survivaladmin.kick
- survivaladmin.ban
- survivaladmin.tempban
- survivaladmin.unban
- survivaladmin.mute
- survivaladmin.unmute
- survivaladmin.tp
- survivaladmin.heal
- survivaladmin.feed
- survivaladmin.gamemode
- survivaladmin.fly
- survivaladmin.god
- survivaladmin.time
- survivaladmin.weather
- survivaladmin.invsee
- survivaladmin.vanish
owner:
- survivaladmin.* # All permissions
# Commands allowed for regular users (all others are blocked)
user-commands:
- "sit"
- "msg"
- "tell"
- "w"
- "me"
- "list"
- "help"
# Custom messages (use {player}, {role}, {killer} placeholders)
messages:
no-permission: "§cУ вас немає доступу до цієї команди"
command-blocked: "§cЦя команда недоступна на цьому сервері"
role-given: "§aГравцю {player} видано роль {role}"
role-removed: "§cУ гравця {player} забрано роль {role}"
unknown-role: "§cНевідома роль: {role}"
player-not-found: "§cГравця {player} не знайдено"
join: "§a{player} приєднався до гри"
quit: "§c{player} покинув гру"
death: "§c{player} помер"
kill: "§c{player} був убитий гравцем {killer}"
roles.json (auto-generated)
Roles are stored by UUID in plugins/SurvivalAdmin/roles.json:
{
"c1c3bec8-a19f-3fc5-afef-b5c7e1c3ab21": {"role": "owner", "name": "DevOmega"},
"550e8400-e29b-41d4-a716-446655440000": {"role": "staff", "name": "Player1"}
}
Legacy name-based roles (from older versions) are automatically migrated to UUID on player join.
🔧 Commands
For all players
| Command |
Description |
/sit |
Sit down |
/msg <player> <message> |
Send private message |
/help |
Show available commands |
For staff (requires staff or owner role)
| Command |
Description |
/admin |
Show admin panel |
/kick <player> [reason] |
Kick a player |
/ban <player> [reason] |
Ban a player |
/tempban <player> <duration> [reason] |
Temporarily ban |
/unban <player> |
Unban a player |
/mute <player> [reason] |
Mute a player |
/unmute <player> |
Unmute a player |
/heal [player] |
Heal player |
/feed [player] |
Feed player |
/tp <player> |
Teleport to player |
/gm <0-3> [player] |
Change gamemode |
/fly [player] |
Toggle flight |
/god [player] |
Toggle god mode |
/time <day/night/number> |
Change time |
/weather <clear/rain/thunder> |
Change weather |
/inv <player> |
View/edit player inventory |
/getoff <player> <time> [reason] |
Ban with time and reason |
/invis / /vanish |
Toggle invisibility |
For owners only
| Command |
Description |
/staff <player> |
Give staff role |
/unstaff <player> |
Remove staff role |
/owner <player> |
Give owner role |
/unowner <player> |
Remove owner role |
🔒 Permissions
| Permission |
Description |
Default |
survivaladmin.owner |
Owner permissions |
op |
survivaladmin.staff |
Staff permissions |
false |
survivaladmin.user |
User permissions |
true |
survivaladmin.kick |
Kick players |
false |
survivaladmin.ban |
Ban players |
false |
survivaladmin.tempban |
Temporarily ban players |
false |
survivaladmin.unban |
Unban players |
false |
survivaladmin.mute |
Mute players |
false |
survivaladmin.unmute |
Unmute players |
false |
survivaladmin.tp |
Teleport to players |
false |
survivaladmin.heal |
Heal players |
false |
survivaladmin.feed |
Feed players |
false |
survivaladmin.gamemode |
Change gamemode |
false |
survivaladmin.fly |
Toggle flight |
false |
survivaladmin.god |
Toggle god mode |
false |
survivaladmin.time |
Change time |
false |
survivaladmin.weather |
Change weather |
false |
survivaladmin.invsee |
View player inventory |
false |
survivaladmin.vanish |
Toggle invisibility |
false |
🛠️ Build
./build.sh
# -> target/SurvivalAdmin-2.0.0.jar
Requires Paper/Purpur API jar (auto-detected from ../../servers/).
评论 0
登录后参与评分
还没有评论,来抢沙发吧