GhastQoL

插件

· 作者 b-F-1

对快乐鬼怪(Happy Ghast)的生活品质改进,包括:提升飞行速度、覆盖“飞行未启用”设置、跟随视线转向以及旋转锁定。

0 本站下载 0 关注 更新于 3 个月前

最新 2.0.0 · 26.2 · Paper / Purpur

一键开服(送7天)

GhastQoL

经典的快乐恶魂插件。

快乐的恶魂本有潜力成为有史以来最棒的交通工具,不幸的是它们飞行缓慢且难以追赶,当你站在它们身上时还会因为“飞行”而被踢出服务器。这个插件修复了所有这些问题以及其他更多问题。

适用于 Minecraft 21.X & 26.X 的 Paper 插件,为快乐恶魂提供了一系列生活质量优化: 它们飞得更快(对其 flying_speed 属性进行加成),并且在看向玩家时会飞向该玩家。还添加了旋转锁定功能,使在恶魂周围建造变得更加容易。此插件还移除了站在快乐恶魂上时出现的“此服务器上未启用飞行”的错误提示。

不支持:Spigot/Bukkit(使用了仅 Paper 的 API)或 Folia。 插件会在启动时运行自检,并在 Folia 或早于 26 版本的 Minecraft 上禁用自身并输出清晰的日志消息。

配置 (plugins/GhastQoL/config.yml)

speed-multiplier: 3.0     # 原版飞行速度的 3 倍
only-when-ridden: true   # true = 仅在玩家骑乘时加速

follow:                   # 让无人骑乘的恶魂跟随最近的玩家
  enabled: true
  range: 32.0             # 仅在此距离内的玩家才会被跟随
  stop-distance: 4.0      # 接近到此距离后停止靠近
  speed: 1.0              # 导航速度倍数

跟随机制

每个恶魂都有一个家(它休息的地方——加载时设置,当骑手离开时重新设置为当前位置,模仿原版行为)。只有在家 range 范围内的玩家才会被跟随,并且不会超出此范围追逐;如果它漂移出去了,它会转向回家。

触发跟随的条件取决于 follow.trigger:

  • look(默认)— 恶魂会跟随看着它的玩家(在 look-angle 度范围内,如果开启 require-line-of-sight 则需视线畅通)。在他们移开视线后的 look-linger-seconds 秒内继续保持跟随状态,这样快速瞥向别处不会让它立即停下。
  • timer — 恶魂按照周期跟随:follow-seconds 的追逐时间,然后是 rest-seconds 的原版正常飞行时间,循环往复。

调优建议:range 是家的牵引半径;look-angle 扩大/缩小“看着它”的锥形区域;speed 缩放滑行速度;stop-distance 是它靠近的最大距离。

编辑后使用 /ghastqol reload 重载配置(权限 ghastqol.reload,默认为 OP)。

命令

  • /ghastqol reload — 重载配置(权限 ghastqol.reload,默认为 OP)。
  • /ghastqol rotate — 将你正在骑乘的(或在 rotate.range 范围内的最近一只)快乐恶魂的偏航角调整为 0°,使其与方块网格对齐。在使用恶魂作为建筑平台时非常有用。权限 ghastqol.rotate(默认:所有人)。
  • /ghastqol check — 看向(或站在附近)一只恶魂并运行此命令,以查看它是否附加了跟随目标和速度加成,以及其家和范围信息。它会即时重新附加任何缺失的部分——非常适合那些成长或重载后丢失了我们逻辑的恶魂。
  • /ghastqol settings — 列出所有可编辑的设置及其当前值。
  • /ghastqol settings <path...> <value> — 实时更改设置(无需重启或重载)。 空格分隔的路径映射到配置键,因此 follow enabled 表示 follow.enabled。 示例:/ghastqol settings speed-multiplier 5、/ghastqol settings follow trigger timer、 /ghastqol settings follow enabled false。值会进行类型检查和范围检查,Tab 补全会遍历路径并建议值,更改会保存到 config.yml 并立即应用于所有已加载的恶魂。权限 ghastqol.settings(默认为 OP)。 注意:Minecraft AI 可能会重新旋转生物,因此在对齐后,插件会短暂暂停该恶魂的跟随功能(rotate.hold-seconds)以使其保持静止。当玩家正在骑乘并操控时,骑手的输入仍然控制朝向——请在静止时对齐,或者先跳下来。

工作原理

原版快乐恶魂的 flying_speed 基础值约为 ~0.05,感觉行动迟缓。 插件添加了一个标量属性修改器,使有效速度变为 base × speed-multiplier。当恶魂进入世界时(生成或区块加载)应用此修改器,如果你禁用/移除插件,修改器会被干净地移除。

注意事项

  • only-when-ridden 使用挂载/卸载事件,使得恶魂仅在乘客在场时变快,然后恢复正常。
  • 极高的倍数会使恶魂难以操控——2–4 是一个舒适的范围。
  • 这是标准的 Paper API;对于 Folia,你需要将调度器调用替换为区域/实体调度器。

“此服务器上未启用飞行”踢出问题

Minecraft 有一个内置检查,会踢出看似在空中停留过久的玩家(Player was kicked for floating too long!)。它不把实体的碰撞箱算作地面,所以站在快乐恶魂上——用它作为建筑平台——即使你什么都没做错,也可能导致你被踢出。

GhastQoL 会取消该踢出操作,但仅当玩家确实站在快乐恶魂上时。它会检查踢出的原因是飞行检查,然后确认玩家位于恶魂碰撞箱的顶部(或边缘)。其他所有踢出操作——封禁、/kick、超时、真正的反作弊——均不受影响,而没有恶魂在下面的真正漂浮仍会被踢出。

flight-kick-fix:
  enabled: true
  vertical-tolerance: 3.0   # 高出碰撞箱多远仍算作站在上面
  horizontal-padding: 1.5   # 边缘周围的余量,用于站在边缘附近
  log-saves: false          # 记录每次被取消的踢出操作(测试时很有用)

用法

MIT 许可证,如果您重新分发,请链接回原始仓库以进行错误报告和维护等。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源