Skip to content

HuHoBot-Penguin_Spigot v1.17.0

Choose a tag to compare

@Shabby-666 Shabby-666 released this 04 Oct 05:25
· 5 commits to master since this release

HuHoBot-Penguin_Spigot v1.17.0

强制绑定、配置文件自动升级,以及 WebUI 分节介绍改写。

下载

文件 用途 大小
HuHoBot-Penguin_Spigot-1.17.0.jar 主插件,必需。放在 plugins/ 22.7 MB
HuHoBot-Engine-GraalJs-1.17.0.jar 可选。仅当你要写 .js 脚本时需要,放进 plugins/HuHoBotPenguin/engines/ 34.1 MB
HuHoBot-Engine-GraalPy-1.17.0.jar 可选。仅当你要写 .py 脚本时需要,放进 plugins/HuHoBotPenguin/engines/ 124.6 MB

只想用现成附属插件的话,只下载主插件即可,两个引擎包不必装。
.lua 脚本不需要任何引擎——LuaJ 已经打进主 jar,不放引擎包插件照常启动,只是对应语言的脚本加载失败,其它语言不受影响。
引擎包需与主插件同一次构建产出(文件名版本号要一致,对不上时启动会给出告警)。

强制绑定

开启后,没绑定的玩家一进服务器就会被踢出,并拿到一个 5 位验证码。在 QQ 群执行 /绑定 <验证码> 完成绑定,重新进服即可游玩。解绑的瞬间,其在线连接也会被立即断开。

binding:
  force-bind: true
  force-bind-groups:
    - "123456789"

踢出画面里带全部信息:服务器名、说明、验证码、群号与命令、重新进入会刷新验证码的提示。

开启前请注意

  • 不要叠加任何白名单插件,也不要开启 Minecraft 自带白名单。否则未绑定玩家会在白名单阶段先被拦下,拿到不了验证码。
  • 强制绑定依赖 QQ 机器人可用。QQ 未连接时插件会自动把 binding.force-bind 改回 false 并在日志说明,避免把人挡在门外却绑不了。
  • 强制绑定开启时,绑定与解绑不再执行白名单同步命令。

绑定时的游戏内验证(binding.require-game-verification)在强制绑定下不生效。

配置文件自动升级

以前升级插件时,旧 config.yml 里经常缺一堆新配置项(比如 update-check、placeholder-api),因为 config.contains() 会回落到 jar 模板的默认值,误判成"已存在"就跳过了。

现在改成文本级增量升级:

  • 缺失的配置项连同注释补进对应段落,缺失的中间层级自动创建
  • 旧配置里被清掉的注释每次启动自动补回
  • 只增不删,你改过的值原样保留

配置版本号升到 9。

WebUI

每个分节的介绍改为手写文案,说明这一页是干什么的、有什么坑,而不是把各字段说明拼成一长串。

升级提示

从 1.16.x 升级无需改配置,启动时会自动补齐新增配置项。建议停服替换 jar 后启动一次,让配置升级逻辑跑完。

需要注意:此前没有配置过 binding.require-game-verification 的服务器,升级后该项会补为 true,即绑定需要游戏内 /qqbind 验证。不希望改变的服务器请手动填 false。