KBControl

插件

· 作者 volcqnn

一款功能强大且高度可定制的击退插件,旨在为服务器管理员提供对战斗物理效果的完全控制。

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

需要前置:PacketEvents

最新 v1.0.0 · 26.3 · Paper

一键开服(送7天)

KBControl (Paper)

KBControl 是一款轻量级的 PaperMC PvP 插件,用于控制战斗击退效果。 它会在受追踪实体受到伤害后不久拦截玩家收到的速度数据包,并独立缩放水平和垂直的击退分量,使其适用于 练习服务器、PvP 平衡调整以及自定义击退实验。

该插件可能与反作弊系统存在兼容性问题。请谨慎使用。

功能特性

  • 分别调整水平击退(X/Z)和垂直击退(Y)。
  • 使用 /knockback 或其别名 /kb 来检查、更改或重载倍率。
  • 将命令修改持久化保存至 config.yml。
  • 利用短暂的玩家伤害标记过滤速度数据包。

依赖项

安装步骤

  1. 安装兼容的 Paper 服务器。
  2. 在同一服务器上安装 PacketEvents 插件。
  3. 构建或下载 KBControl/CustomKB JAR 文件。
  4. 将 JAR 文件放入服务器的 plugins/ 目录中。
  5. 启动服务器一次以生成默认的 plugins/CustomKB/config.yml。
  6. 编辑生成的配置文件,或在游戏/控制台使用 /kb set ...。
  7. 手动修改配置后,运行 /kb reload。

快速开始

/kb get
/kb set horizontal 0.9
/kb set vertical 1.05
/kb reload

默认值为中性倍率,因此在你设置其他值之前,原版/服务器的击退效果保持不变。

命令

所有命令均需权限 customkb.command.knockback。

命令 别名 参数 行为
/knockback get /kb get 无 显示当前的水平和垂直倍率。
/knockback set horizontal <value> /kb set horizontal <value> value 为小数,>= 0.0 保存水平倍率。
/knockback set vertical <value> /kb set vertical <value> value 为小数,>= 0.0 保存垂直倍率。
/knockback reload /kb reload 无 从 config.yml 重载数值。

当前源码中没有单独的 help 子命令。

权限

权限节点 默认分配 覆盖范围
customkb.command.knockback op 访问所有 /knockback 和 /kb 子命令。

配置

生成的默认配置:

knockback:
  # 应用于战斗击退水平(X/Z)分量的倍率。
  horizontal-multiplier: 1.0
  # 应用于战斗击退垂直(Y)分量的倍率。
  vertical-multiplier: 1.0

实用的 PvP 示例:

knockback:
  # 略微减少横向/向后移动。
  horizontal-multiplier: 0.85
  # 保持向上抬升接近默认值。
  vertical-multiplier: 1.0

如何读取倍率数值:

  • 1.0 保持该分量不变。
  • 0.0 移除被处理战斗击退中的该分量。
  • 0.5 将该分量减半。
  • 2.0 将该分量加倍。

命令输入限制为 >= 0.0 的值。手动编辑的配置作为双精度浮点数加载,若缺失则回退默认为 1.0;当前源码在读取文件时不会添加额外的验证或截断处理。

击退控制原理

Minecraft 使用实体速度数据包来传递运动信息,包括战斗击退。KBControl 追踪未取消的 EntityDamageByEntityEvent 事件中的玩家受害者,保留该待处理的战斗击退标记 250 毫秒,并在玩家收到自身的 ENTITY_VELOCITY 数据包时消耗该标记。

当数据包匹配时,插件按以下方式重新缩放速度:

newX = oldX * horizontal-multiplier
newY = oldY * vertical-multiplier
newZ = oldZ * horizontal-multiplier

这使得水平和垂直调整相互独立,同时避免大多数非战斗相关速度变化受到影响。

行为与限制

  • 仅追踪玩家受害者。
  • 仅修改接收者自身实体的速度数据包。
  • 待处理伤害标记仅被消耗一次,并在 250 毫秒后过期。
  • 已取消的伤害事件将被忽略。
  • 其他实体的速度数据包,或在 250 毫秒内没有待处理伤害标记的数据包,将被忽略。这是一种时间启发式方法:在此期间到达的不相关速度可能会被缩放并消耗掉标记。
  • 其他修改伤害、速度、数据包或反作弊行为的插件可能会影响最终结果;请在你的完整服务器插件堆栈中进行测试。
  • 当前源码声明的是 Paper API,而非 Spigot/Bukkit 兼容性。

使用示例

查看当前设置:

/kb get

使 PvP 击退更低更平:

/kb set horizontal 0.75
/kb set vertical 0.8

创建高抬升的练习击退,同时保持水平移动不变:

/kb set horizontal 1.0
/kb set vertical 1.4

手动编辑 config.yml 后:

/kb reload

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源