插件介绍
本插件是一个比原版更好用的白名单插件.
第一种模式.当玩家没有白名单的情况下,是允许进服的,
但是只能进行参观,无法进行除了移动外任何操作,别的玩家也对没有白名单的玩家无法进行操作 就像个空气人 (配置文件可以开启允许使用"/login","/register"),并且在玩家进行不允许的操作时,向玩家发送消息,消息内容可自定义(玩家可以看到的消息,都可以自定义),怪物都不会搭理没白名单的玩家.

第二种模式.当玩家没有白名单的情况下,是不允许进服的,

当玩家的白名单被移除,玩家也会被强制掉线

此功能可以用来防御假人压测...
本插件无论是盗版服还是正版服,均可兼容,并且使用相同命令,插件会自动检测并开启插件的正版/盗版 模式.
3.3.2版本后,允许添加白名单不加QQ号(如果你不想对接群的话),但是如果这样,就无法使用qremove 和 qban命令.
白名单插件在正版模式下,会储存玩家的UUID ID QQ号,盗版模式下会储存玩家的ID QQ号.
当服务器是盗版服的情况下,只保留ID和QQ,绕过UUID,并且仅允许玩家使用/register和/login命令,和移动 这样实现了兼容盗版服.
插件内置了各种相关命令(具体指令以及权限可以在下方查看),
你可以通过玩家QQ号查找玩家ID,还可以反过来查询,你还可以通过玩家QQ号来ban玩家.
还有更多,具体请看命令介绍以及特性介绍!
本插件还有个很大的亮点就是可以对接QQ群,
你可以让玩家在群里自助申请 就像,这样
(以下演示均用QQ小号,加我小号的好友均不回复)

这时候你可能会担心,如果群里的人申请多个ID怎么办? 不存在的,一个QQ只能对应一个ID.
那如果很多玩家申请一个ID呢? 也不用担心,我们都考虑了!
不止这样,当QQ群人数减少,我们的插件会自动移除退出者的白名单!(可以开启退群ban功能)

还有个问题,如果玩家被踢出群,那他会被移除白名单吗,他换个号怎么办?

被踢出群,就是这样的后果 被移除白名单然后被封禁
以上操作,均可以在游戏中通过命令执行.
为什么选这个插件(一些问题的处理)
这时候可能会有人问:既然插件有正版模式和盗版模式,自动检测,
假如开了很久的正版服,突然换成盗版服,那是不是whitelist.json要删除重新申请?
答:不是的,我们的插件有自动转换功能, 无论是正版服到盗版服,还是盗版服到正版服都是支持的.你问怎么个支持法?


就是这样,检测到你更换服务器正盗版模式,自动转换(反过来也是一样)!
之前每次版本更新都要求删除储存文件,那以后的每次更新,我们是不是都要换一次Whitelist.json(本插件的储存文件)?
不,从3.2版本往后,不需要再删除储存文件了,你只需要换插件,插件在检测到服务器启动时,会自动更新储存文件,并且保留原有数据!(无需联网)
我们还注意到,正版模式下UUID由服务器服务端生成,不一定是正版玩家的真实UUID,
在正版模式下,添加白名单有可能会拿到错误的uuid,或者在用插件的自动转换功能的时候,也可能出现拿到错误的UUID,而导致玩家无法得到白名单!
但是问题不大,因为,我们已经解决了!
在正版服的情况下,玩家进服,但是UUID/Name不对,我们的插件将会要求玩家进行验证.
在验证之前,相当于没有白名单,但是提示消息不一样 而且要求玩家验证?
没有被要求验证的玩家,在群里验证是只能验证失败的!
这样就避免了UUID不正确的问题!(可能出现的Bug我们已经为您测试过了!就算重启 reload还是怎么样,都不能逃过!)
如图

这时候就要玩家在群里@机器人 验证 验证成功 则更改UUID!

这时候你可能会想到一个问题,正版服下,如果玩家白名单UUID不正确,并且没进入过服务器,那是不是就无法用/wl remove <ID>移除白名单了?
答:不存在的!
我们的插件如果在删除时,找不到玩家的UUID,就会去找玩家的名字.确保不会出现这种bug!
当你只知道玩家QQ或者Name,想找到对方的QQ/Name,而又不像去翻找储存文件?
好的,没问题,我们有wl get <qq/name>功能
当你输入的是name 我们返回QQ,当你输入QQ 我们返回name!

一个一个获取太麻烦?没关系,我们有批量查询的方式!
你可以在游戏里输入/wl list来获取谁都有白名单!
经过上一个版本的测试,我们已经修复了大部分bug!
并且盗版服也可以使用此命令了!

还不够?有时候管理员在外面,不能上线,也不能上后台,怎么办?
没关系,这次版本,我们加入了较为简单的群执行命令功能,你可以直接通过群来执行命令,所有命令!
不存在的也行,如果你想的话.

下面来说说,插件对盗版服的兼容优化!
1.在盗版模式下,我们不储存UUID,只储存Name和QQ 确保盗版玩家不用进入服务器再申请!
2.和正版模式使用同样的命令,插件的命令针对不同模式,进行不同路线!
3.盗版服,也可以使用/wl list命令来批量查看!
4.哪天,你不想开盗版服了,想开正版服,插件检测到你把OnlineMode改为了true 在你开服的时候,会自动将玩家数据进行转换!
我如果只想在群里手动给玩家白名单,而不想要玩家申请,怎么办?
可以的,我们的whitelist.ini文件中可以关掉玩家自助申请功能!
注意:盗版服无法使用wl nonameremove和wl confirm命令,这是因为盗版服白名单里没有储存UUID(简单来说就是盗版服不需要这两个命令)
之前用的原版的白名单插件,现在想用这个可以导入吗?
可以的, 可以使用 /wl import mojang命令来导入原版的白名单列表的玩家
但是使用此命令导入的玩家没有QQ号,也就是说,这样导入的玩家只能通过/wl remove <id>删除
这个插件Bug多吗?
答:不多,每一个功能我们都是经过很多次测试,远程调试等,确保平常使用不会遇到bug.
但是是程序,就会有bug,如果各位遇到,也欢迎来反馈bug!
对于一些储存文件被手动更改以至于无法解析储存文件的问题,我们都已经捕捉异常并进行提示,提示会告诉你怎么做!
[spoiler=如何使用?]第一步,在服务器服务端安装本插件,并且重启.
(实际上,如果你不对接机器人的话,到这一步就结束了.大部分人用此插件都会想着对接机器人吧,那就继续往下看吧!)
在server.properties中,将enable-rcon改为true,然后重启.重启你会看到
rcon.port(Rcon端口,注意,不能和服务器是同一个端口!),rcon.password(rcon密码),这些可以按照自己想的来设置!
设置完后,请将server.properties文件中的server-ip=后面去掉(否则很可能机器人无法连接服务器)!
然后开启服务器.
下一步,下载酷Q机器人(不需要买pro 免费的Air就可以),将本帖提供的机器人插件(cpk),放到机器人目录下的app文件里,启动机器人,
然后打开 你的酷Q目录\data\app\white.dsbbs2.top\whitelist.ini进行设置
里面的内容为(=后面的内容不一样没关系):
[td][settings] address=127.0.0.1 port=9487 password=rcon Tester=1302399643 CrazyMode=No GroupAdminCMD=Yes
[/td]adress为服务器ip,如果服务器和机器人在一台机器上,那就将=后面填127.0.0.1
port改为rcon端口
password改为你设置的rcon密码
Tester为测试者,填入你的QQ号
CrazyMode如果设置为Yes,每次玩家退群,不但会被移除白名单,还会被ban,默认为NO
GroupAdminCMD如果为Yes,则管理员可以在群里执行命令,就如上面的图那样.No则不可以
设置好后,重启酷Q.
都设置好后,可以用Tester对应的QQ号,对机器人发"测试",然后会返回是否对接成功!成功的话,就全部完成了,将你的机器人邀请进服务器群吧!
这边再补充一下服务端插件的配置文件
配置文件有
"mess": "你还不在白名单中,在此之前你将不能进行任何对此服务器的实质性动作",
"congratulate": "恭喜您获得白名单!",
"unCongratulate": "您失去了白名单!",
"on_UUID_Is_Right_But_Name": "检测到您的白名单中的Name错误,请在群里 \u0027@机器人+验证\u0027,如果服务器没有对接群,请找管理员输入/wl confirm \u003c您的QQ号\u003e",
"on_Name_Is_Right_But_UUID": "检测到您的白名单中的UUID错误,请在群里 \u0027@机器人+验证\u0027,如果服务器没有对接群,请找管理员输入/wl confirm \u003c您的QQ号\u003e",
"isOnlineServer": "正版服(自动检测,更改无效)",
"uesLoginPluginOrNot": true,[/td]这些内容(你可以用§作为颜色符号,而非&),
mess为当玩家没有白名单时,提示的内容
congratulate为当我安家获取白名单时提示的内容
unCongratulate为玩家失去白名单时提示的内容
on_UUID_Is_Right_But_Name:为当玩家Name有错,需要在群里验证时,提示的内容(盗版服可以无视)
on_Name_Is_Right_But_UUID:为当玩家UUID有错,需要在群里验证时,提示的内容(盗版服可以无视)
isOnlineServer:为自动检测内容,请勿更改,并且更改无效!
uesLoginPluginOrNot:为你是否允许玩家在没白名单情况下输入 "/login" "/register"命令.
useSkinonWLList:是否开启/wl list命令显示头颅皮肤,默认关闭,开启后容易卡死主线程.
新增:
"canNoWhitePlayerGetIn": false, 玩家在没有白名单的时候,是否可以进服(进服只能参观),默认为true(可以进服)
"PlayerCantJoinMSG": "您目前没有白名单,无法进入,请先申请白名单!", 当玩家由于白名单问题无法进服 会提示这条消息
[注意]:插件配置文件的文本,如果要用颜色符号,请用§ 而不是&
如果看不懂以上教程,可以看视频教程.
[spoiler=机器人可用命令]@机器人 申请白名单 <id> -> 自助申请白名单 - 默认全体群员,可以在配置文件关闭 @机器人 验证 -> 验证账号(需要的时候,服务器会提示玩家)- 全体玩家可用,对盗版服没用.
@机器人 执行 <命令> -> 让服务器执行命令 - 群管理可用,有返回消息,可在配置文件关闭.
私聊机器人 : "测试" -> 用来测试是否能对接到服务器,配置文件指定的QQ可用
插件可用命令
/wl add <id> <QQ号> 添加白名单 权限:whitelist.add-默认op可用
/wl add <id> 不储存玩家QQ,添加白名单(需要对接群的,请不要使用) 权限:whitelist.add-默认op可用
/wl remove <id> 移除玩家白名单 权限:whitelist.remove-默认op可用
/wl qremove <QQ号> 根据QQ移除白名单 权限:whitelist.remove-默认op可用
/wl qban <QQ号> 根据QQban玩家 权限 权限:whitelist.ban-默认op可用
/wl list 查看已有白名单玩家列表(需要在游戏里使用) 权限:whitelist.list-默认op可用
/wl reload 重载配置文件 权限:whitelist.reload-默认op可用
/wl get <QQ号/ID> 获取该QQ/ID对应的ID/QQ 权限:whitelist.get-默认op可用
/wl confirm <QQ号> 验证该QQ号 权限:whitelist.confirm-默认op可用
/wl debug 开启/关闭 debug模式 权限:whitelist.debug-默认op可用
/wl help 查看插件帮助 权限:whitelist.help-默认op可用
/wl import mojang 将原版白名单的玩家,导入到此插件的白名单 权限:whitelist.import-默认op可用
新旧版本功能对比(给旧版本钉子户)[/spoiler]
[spoiler=更新历史]v1.0-插件发布
v1.1-修复了因为指令写错导致的数组下标越界bug
v.1.21-修复了一个bug:添加的时候会出现空指针
v1.3-增加可根据QQ号ban玩家 可根据QQ号移除玩家,实现了群和服务器的对接功能
v1.4-修改了代码架构,修复发生几率很低的安全问题,修改了提示,每个玩家的提示不再一直弹出
v1.5-增加了可自定义端口,可自定义ip功能,修改了提示文本自定义的方式,增加了§转义为&功能
v1.6-修复白名单却未更改模式和重复申请导致新ID无法申请的bug,新增当玩家获得白名单,可以自定义要执行的指令,玩家未获得白名单,将无法使用任何指令.
v1.7-修复了一个发生几率极小的漏洞,增加了配置文件变量<%player>,兼容了Authme
v1.8-修复了当用户名已存在又被申请的重复bug,增加在没有白名单情况下无法右键,增加whitecom(指令白名单,命令用空格隔开{开头不用空格})指令白名单,增加/white list命令(测试中) 现在用来查看谁有白名单 这个功能为以后的GUI管理白名单做准备.
v1.9-修复了部分bug:如无法拦截没白名单的情况下,用户的操作
v1.9.5-代码架构优化
v2.0-增加无白名单情况下的冒险者模式和禁止进入模式
v2.1-无白名单禁止进入模式下的提示可以自定义了
以上版本将不再公布,提供,并不建议使用-----------------------------------------------------------------------------------------
v3.0-代码全部更新 全部重写 更稳定 功能更强大
v3.1-增加get命令 可以通过QQ获取玩家名 或者通过 玩家名 获取QQ
v3.2-将原先的手动对接服务器,改为自动对接.修复wl list显示的bug,开始同时兼容盗版服务器,自动检测正盗版服来做出优化.可以从QQ群直接@机器人来执行命令了.盗版情况下,和正版模式下使用同样的命令.增加群机器人的返回消息.现在插件的返回消息更详细了,允许玩家关闭自助申请白名单功能.修复1.14.4在rcon不断开的情况下,无法关服bug(服务端问题,spigot和paper都这样,既然不修复,只能我对我的插件进行随机应变了.).增加了当UUID为错误时,或Name为错误时的QQ群验证.增加玩家失去白名单后的提示.优化remove命令(当找不到玩家uuid,就去找玩家name).
v3.2.1-修复了,有白名单(不确定是否有)下,tab报错的bug.将/wl list是否显示头颅皮肤改为可设置,默认关闭,如果开启会加载玩家皮肤,容易卡死主线程.
v3.2.2-修复了1.12.2盗版服获取白名单后,无法使用tab补全功能的问题[已测试 测试服务端:akarin-1.12.2]
v3.2.3-修复了由于服务端版本过新,TinyProtocol无法调用类的bug.修复了当指令参数出现空字符会报错的问题(解决方法 判断每个参数是否为空字符).增加了debug模式,可以在无报错,但是出现问题的时候 开启 5分钟后 发送日志给本插件开发者.
v3.2.4-修复了 在玩家是生存以外的模式的情况下 获取白名单 会导致玩家还在"inv"模式
v3.2.5-修复盗版服 输入wl remove的时候 用tab补全会造成找不到uuid问题,修复在盗版服 部分debug信息输出处代码会空指针的问题.plugin.yml里author加入mayukowo.
v3.3-把其他插件的假人当做玩家的问题进行try catch(捕捉异常).增加wl help功能,以便新用户查看帮助.增加无法进入服务器的模式(可防假人压测).
v3.3.1-撤销针对 与"Senxxxx"插件的冲突问题 的try catch,这个问题属于"Senxxxx"插件的问题,不属于whitelist,这个插件伪造玩家,并允许伪造的玩家触发事件(他主要问题)
v3.3.2-允许添加白名单 不加qq号 例如可以这样输入"/wl add white_cola".(如果你想对接群,请加上QQ)
2020年3月25日 在本帖加入视频教程
v3.3.3-修复由于某阿里规范插件(已删除)删了/wl list代码的某个括号,导致的报错.
v3.4-增加导入原版白名单的功能.无权限提示更详细了, 当玩家无权限,会提示玩家需要的权限.[/spoiler]
[spoiler=开发者名单](排名不分先后) White_cola - a3f48db8-9fee-47cc-b229-f3d8af14d27a
-算法编写,插件开发,算法优化,插件维护,接收用户反馈消息...
lvxinlei - 40691a57-1c57-4b1c-9331-a1355853d8cf
-框架制作,架构优化,提供方案,提出解决方案,插件开发,插件维护...
mayukowo - aac95095-bca1-4a39-932e-8bb08bdb5a7d
-算法编写,算法优化,提供方案,插件开发...[/spoiler]
[spoiler=下载地址](不再提供旧版本插件)
前往原贴下载[/spoiler]
[spoiler=常见问题]1.我使用后,我家网变慢了,怎么回事 答:和插件没什么关系!
2.cpu或内存占用很大 答:并不很大,比起其他插件
3.我如果服务器和机器人的服务器不在一起,可以用吗? 答:可以,但是需要映射下服务端rcon的端口
4.玩家申请了也进不去服务器 答: 如果是显示没有白名单,请检查用户的申请ID是否正确(解决不了就在帖子提问).如果显示其他的,和whitelist无关.
5.有三个人参与开发,我遇到问题该问谁? 答:你可以加我QQ来问或者在帖子里问(如果你是问完就删好友那种,你还是在帖子里问吧!)
6.对接失败了,怎么办? 答:请确认enable-rcon是否开启,然后rcon的port和password是否已经和whitelist.ini文件里的一样.server-ip=后面的内容是否是什么都不写.
8.我可以提意见吗? 答:当然,很欢迎你提出宝贵意见awa
9.是否接受定制插件 答:不接受,请不要再问了.
10.使用这个白名单插件是否需要开启原版白名单 答:不需要 这个白名单插件是完全独立的, 如果判断是否需要? 如果教程没写 就说明不需要.
11.是否接受赞助? 答:不接受
12.插件没有任何报错,但是确实出现了问题,怎么办? 答:开启debug模式(当出现问题的时候 输入/wl debug) 然后重复发生问题的动作 最后将服务器log文件发给我.可以在帖子里发 也可以发到我的QQ.
13.如果玩家名字变了(申请了错误ID)怎么办? 答:找管理员 @机器人 执行 wl remove/qremove xxx awa
14.遇到问题怎么办? 答:可以在帖子中提问,但是,请不要提问和本插件无关的问题(或不是本插件造成的)精力有限 最近有些人用了本插件后,连启动器出问题都要来找我...)
15.遇到问题了,懒得反馈,我去直接用旧版本行吗? 答;没问题,如果你不想得到最新版插件,和帮助的话.
16.旧版本出现问题,新版本没有,我该反馈吗? 答:请换成最新版本.
17.Failed to Verify username! 或者 无法验证用户名 答: 这个和插件没什么关系,请从启动器退出自己的正版账号,然后重新登录,之后即可进入服务器.[/spoiler]
[spoiler=更新预告]1.当玩家没有白名单的情况下,可以通过配置文件设置为无法进入(同时可防御假人压测).[已完成]
2.将推出APP,以便不在家的服主可以通过手机APP对白名单插件进行操作.
3.机器人插件的ini文件中,可配置可自助申请的群名单.
4.将加入wl help功能,方便新人手动使用命令.[已完成]
5.对于我之前不愿意加入第一条功能,某个人因此对我进行人身攻击, 所以白名单很可能将自带QQ黑名单,限制某个对我态度恶劣的人的QQ号.
6.兼容1.12以下的版本.(已取消计划)(由于1.12版本以下的模组bug太多,如果装了此插件,服务器由于被注入导致被熊 很可能会有人说是本插件的问题!)
7.做一个bungeeCord版本.
注意:所有功能不会一下更新完.需要一点一点更新.如果你还有其他意见,可以在帖子中评论提出.[/spoiler]
[spoiler=授权申请]已获得授权[/spoiler]
|