SimpleWhitelist
SimpleWhitelist 是一款轻量级、通用的基于昵称的白名单插件与模组,适用于私人 Minecraft 服务器(1.12 – 26.x)。
为什么选择 SimpleWhitelist?
- 基于昵称 (
whitelist.txt) — 在线模式、离线模式、代理以及 Geyser / Floodgate Bedrock 服务器均可无缝运行(支持.,*,+,-前缀和空格); - 全平台通用支持(12 种平台)(
1.12 – 26.x)— 涵盖代理、Bukkit 分支、Sponge 及模组加载器; - 完全可定制 Adventure MiniMessage 消息,位于
config.yml中; - 拦截加入日志与操作 — 可选的控制台通知(
logBlockedJoins)和自定义控制台命令(onBlockedJoinCommands); - 细粒度权限控制 — 支持 LuckPerms / 原生 PermissionAPI 及 Brigadier 标签补全的子命令权限。
快速开始
- 在
server.properties中禁用原版白名单(white-list=false); - 将 JAR 文件放入
plugins/(Bukkit/Sponge/代理)或mods/(Fabric/Quilt/Forge/NeoForge)目录; - 启动你的服务器;
- 通过
/swl add <name>添加玩家,并通过/swl enable//swl disable切换白名单状态。
命令与权限
别名:/simplewhitelist, /swl, /simplewl
| 命令 | 权限 | 描述 |
|---|---|---|
/swl add <name> |
simplewhitelist.command.add |
将玩家添加到白名单 |
/swl remove <name> |
simplewhitelist.command.remove |
从白名单中移除玩家 |
/swl list |
simplewhitelist.command.list |
显示已列入白名单的玩家 |
/swl enable |
simplewhitelist.command.enable |
启用白名单 |
/swl disable |
simplewhitelist.command.disable |
禁用白名单 |
/swl reload |
simplewhitelist.command.reload |
重新加载 config.yml 和 whitelist.txt |
/swl help |
任意 simplewhitelist.command.* |
显示命令帮助 |
通配符/基础权限:simplewhitelist.command.* 或 simplewhitelist.command。
配置 (config.yml)
enabled: true— 启用/禁用白名单检查;caseSensitive: false— 区分大小写的昵称匹配;enforceWhitelist: true— 在执行enable/remove/reload时踢出当前在线但未列入白名单的玩家;logBlockedJoins: true— 在控制台中记录被阻止的加入尝试及其用户名;onBlockedJoinCommands: []— 当未列入白名单的玩家尝试加入时执行的控制台命令(使用<name>占位符)。
SimpleWhitelist
SimpleWhitelist is a lightweight, universal nickname-based whitelist plugin & mod for private Minecraft servers (1.12 – 26.x).
Why SimpleWhitelist?
- Nickname-based (
whitelist.txt) — works seamlessly on online-mode, offline-mode, proxy, and Geyser / Floodgate Bedrock servers (supports.,*,+,-prefixes and spaces); - Universal 12-platform support (
1.12 – 26.x) — proxies, Bukkit forks, Sponge, and mod loaders; - Fully customizable Adventure MiniMessage messages in
config.yml; - Blocked-join logging & actions — optional console notifications (
logBlockedJoins) and custom console commands (onBlockedJoinCommands); - Granular permissions — per-subcommand permissions with LuckPerms / native PermissionAPI & Brigadier tab-completion.
Quick Start
- Disable vanilla whitelist in
server.properties(white-list=false); - Put the JAR into
plugins/(Bukkit/Sponge/Proxies) ormods/(Fabric/Quilt/Forge/NeoForge); - Start your server;
- Add players via
/swl add <name>and toggle via/swl enable//swl disable.
Commands & Permissions
Aliases: /simplewhitelist, /swl, /simplewl
| Command | Permission | Description |
|---|---|---|
/swl add <name> |
simplewhitelist.command.add |
Add a player to the whitelist |
/swl remove <name> |
simplewhitelist.command.remove |
Remove a player from the whitelist |
/swl list |
simplewhitelist.command.list |
Show whitelisted players |
/swl enable |
simplewhitelist.command.enable |
Enable the whitelist |
/swl disable |
simplewhitelist.command.disable |
Disable the whitelist |
/swl reload |
simplewhitelist.command.reload |
Reload config.yml and whitelist.txt |
/swl help |
Any simplewhitelist.command.* |
Show command help |
Wildcard / base permissions: simplewhitelist.command.* or simplewhitelist.command.
Configuration (config.yml)
enabled: true— enable/disable whitelist check;caseSensitive: false— case-sensitive nickname matching;enforceWhitelist: true— kick online non-whitelisted players onenable/remove/reload;logBlockedJoins: true— log blocked join attempts with username in console;onBlockedJoinCommands: []— console commands executed when a non-whitelisted player tries to join (<name>placeholder).
下载 SimpleWhitelist
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SimpleWhitelist
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SimpleWhitelist
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SimpleWhitelist
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SimpleWhitelist
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SimpleWhitelist
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SimpleWhitelist
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SimpleWhitelist
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SimpleWhitelist
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 SimpleWhitelist
2.1.0 版本发布
- 单一分支全面支持 Minecraft
1.12 – 26.x的 12 个平台:- Spigot、Paper、Purpur、Folia(
1.12 – 26.x); - BungeeCord、Waterfall、Velocity(
1.12 – 26.x); - Fabric(
1.14 – 26.x)与 Quilt(1.18.2 – 26.x),且无 Fabric API 版本锁定; - Forge(
1.12 – 1.12.2及1.13.2 – 26.x)和 NeoForge(1.20.2 – 26.x); - Sponge API 7(
1.12 – 1.12.2)及 API 8+(1.16.5 – 26.x);
- Spigot、Paper、Purpur、Folia(
- 完整支持 Adventure MiniMessage 格式化语法;
- 统一的
/simplewhitelist(/swl,/simplewl)Brigadier 命令树,支持自动补全以及完整的 Geyser/Floodgate Bedrock 昵称支持(.、*、+、-、空格); - 细粒度的子命令权限控制(
simplewhitelist.command.<subcommand>),兼容 LuckPerms / 原生 PermissionAPI; - 可配置的阻止加入控制台日志记录(
logBlockedJoins)及自定义控制台命令(onBlockedJoinCommands); - 具备自我修复能力且故障时安全关闭的 YAML 配置加载器(修复 SnakeYAML 全局标签在重载/Velocity 环境下的错误);
- 可选的
enforceWhitelist实时断开在线未列入白名单玩家的功能。
版本 2.0.0
- !重大更改! 配置格式从
JSON更改为YAML; - 支持 Adventure MiniMessage 格式;
/simplewhitelist现在是通过 brigadier 创建的单一命令。- 不再支持 Forge
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
查看物品与配方
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
AE2:一款流行的自动化与存储模组
模组
一个基于构建器的 Minecraft 配置库!
评论 0
登录后参与评分
还没有评论,来抢沙发吧