DS-PearlFix

插件

· 作者 VyrByte

现在修复这个令人作呕的末影珍珠漏洞

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

最新 7.0 · 26.3 · Bukkit / Paper

一键开服(送7天)

保持投掷,修正落点

安全着陆 · 狭窄间隙检测 · 可配置保护

末影珍珠是冒险的一部分,但卡进墙里就不该如此。DS-PearlFix 帮助确保珍珠落在可用空间内,并阻止通过玩家无法通过的狭窄开口进行传送,同时提供可适应你服务器需求的设置。

DS-PearlFix 7.0 · Minecraft 1.13–26.3 Spigot & Paper · 单个 JAR 文件 · 无需额外插件

01 / 更好的落点

两项检查协同工作:一项检查玩家的落点,另一项追踪珍珠穿过狭窄开口的路径。

  • 让玩家留在方块外。 安全着陆检查将玩家的碰撞箱与目的地周围的碰撞形状进行比对。墙壁、角落、天花板和部分方块都会被检查;在可能的情况下,着陆点会微调以容纳玩家。

  • 关闭狭窄捷径。 间隙检查会追踪珍珠穿过栅栏、玻璃板、铁栏杆、台阶、门和陷阱门周围开口的路径。该检查会将可用空间与配置的间隙高度进行比较。

  • 处理不可能的落点。 如果搜索无法找到安全的落点,则取消传送。可选的珍珠退款功能会在非创造模式下返还物品;完整库存掉落功能会将物品掉落在玩家所在位置。

  • 保留正常投掷。 已经合适的目的地保持不变。重构后的系统不再应用旧的固定投掷距离限制。

查看 DS-PearlFix 的实际效果

录制于早期构建版本;7.0 版本使用了重构的检测系统。

02 / 你的服务器,你的设置

  • 选择检查项目。 分别启用安全着陆和狭窄间隙检测。设置全局启用开关或排除选定的世界。

  • 设置最小间隙高度。 选择 0.6 到 1.8 个方块的 Gap-Height(间隙高度)。安全着陆使用玩家的实际姿态尺寸;间隙检测使用你配置的最小值。缩放后的玩家尺寸也会被考虑在内。

  • 为工作人员提供有用的反馈。 被阻挡的间隙警报包括玩家、世界和坐标信息。在调查投掷时启用个人聊天调试,或使用控制台调试以获得更广泛的视图。

  • 控制豁免权限。 仅在需要的地方授予可配置的 bypass(绕过)权限。操作员不会自动绕过珍珠检查。

  • 让消息符合你的服务器风格。 使用 MiniMessage 样式或旧版颜色代码自定义前缀和所有反馈消息。将消息设置为空字符串即可隐藏它。

诊断信息与工作人员警报

/pearlfix status 报告当前激活的方块形状读取器以及已检查的珍珠数量、调整的目的地、被阻挡的间隙和无空间取消的次数。这些计数器保存在内存中;插件重启后会重置它们。

/pearlfix debug 切换请求玩家聊天中的详细信息。当该玩家登出或再次关闭此功能时结束。设置 Plugin-Config.Debug: true 以启用控制台日志记录;从控制台运行此命令时会显示此说明。

Pearl-Checks.Alerts 向控制台和在线工作人员发送关于被阻挡间隙的通知,使用的是配置的 Permissions.Staff 节点权限。警报被限制为每两秒每个玩家一条。无空间取消会使用其玩家反馈和可选的调试输出。

03 / 一个 JAR 文件。熟悉的安装方式。

安装一个服务器插件并在 Settings.yml 中进行配置。其文本库已捆绑,因此启动时不会下载额外的库。

  • 服务器支持: Spigot 和 Paper,Minecraft 1.13–26.3。安装在 Minecraft 服务器上。未声明对 Folia 和代理的支持。

  • Java: 使用你的服务器软件所需的版本。该插件针对 Java 8 字节码;较新的服务器版本仍需其各自的更新 Java 运行时环境。

  • 依赖项: 无需额外插件。没有 PlaceholderAPI 依赖或集成。

  • 其他插件: 已被其他插件取消的末影珍珠传送事件将不受影响。在向玩家开放服务器之前,请先测试你自己的区域、战斗和传送规则。

碰撞形状与玩家尺寸

Minecraft 1.17 及更高版本使用服务器碰撞形状 API。Minecraft 1.13–1.16 使用反射的方块碰撞形状,并在运行时验证。如果无法获得精确的形状读取器或失败,插件将使用保守的边界框回退方案。检查 /pearlfix status 以查看当前处于活动状态的模式。

安全着陆检查玩家当前的碰撞箱,包括服务器暴露的姿态尺寸。较旧的 1.13 服务器使用站立尺寸的维度。支持现代缩放玩家。Gap-Height 仍然是路径检查的可配置最小值,而不是随玩家姿态自动切换。

04 / 一次设置,按需调整

安装与配置

  1. 将 DS-PearlFix-7.0.jar 放入服务器的 plugins 文件夹并启动服务器。

  2. 打开 plugins/DS-PearlFix/Settings.yml。选择检查项目、最小间隙高度、排除的世界、退款和警报设置。

  3. 授予工作人员所需命令和警报权限。仅将 pearlfix.bypass 分配给需要豁免的玩家。

  4. 运行 /pearlfix reload,然后运行 /pearlfix status。使用 /pearlfix debug 并在服务器的重要建筑周围测试几次投掷。

Commands — complete reference

命令:/pearlfix · 别名:/dspearlfix 和 /pfix。不带参数运行会显示用法;Tab 补全会建议你可以使用的子命令。

/pearlfix reload

默认权限: pearlfix.reload OR pearlfix.admin 重新加载 Settings.yml 和消息。无效的 YAML 将保留上一个正常工作的配置。玩家和控制台均可使用。

/pearlfix status

默认权限: pearlfix.admin 显示插件和 Minecraft 版本、当前启用的碰撞体模式,以及已检查的珍珠数、调整落地数、被阻止的间隙数和因空间不足取消的次数。玩家和控制台均可使用。

/pearlfix debug

默认权限: pearlfix.admin 在你自己的聊天窗口中切换珍珠检查消息的显示,直到你登出或再次运行该命令。从控制台运行时,此命令说明如何启用 Plugin-Config.Debug;它不会切换控制台的日志记录。

权限名称可在 Permissions 下配置。status 和 reload 对控制台可用;debug 仅为玩家切换个人聊天输出。

Permissions — complete reference

pearlfix.admin — 默认为操作员(Operator)。授予 status、个人 debug 和更新通知权限。它还允许 reload。声明的默认节点包含 pearlfix.reload 和 pearlfix.alerts 作为子节点;不包含 bypass。 配置键: Permissions.Admin

pearlfix.reload — 默认为操作员(Operator)。允许重新加载配置。配置的 admin 节点也允许此命令。 配置键: Permissions.Reload

pearlfix.alerts — 默认为操作员(Operator)。当珍珠在狭窄间隙被阻止且 Pearl-Checks.Alerts 启用时接收警报。这不是针对每个取消的珍珠的警报。 配置键: Permissions.Staff

pearlfix.bypass — 默认不授予,包括操作员。拥有此节点的玩家投掷的珍珠将不受检查。 配置键: Permissions.Bypass

admin 节点授予管理访问权限和默认的 alert/reload 子权限,但不包含 bypass。如果你在 Settings.yml 中重命名了权限节点,请通过你的权限管理器授予这些新名称;声明的操作员默认值和子链接关系适用于原始名称。

从版本 6 升级时,现有的 Permissions.Staff: pearlfix.message 值将被保留。继续授予配置的节点,或者故意将其更改为新的默认值 pearlfix.alerts。pearlfix.message 是一个迁移值,不是版本 7 中的额外默认权限。

Configuration — example & every setting

将这些部分合并到你生成的 Settings.yml 中。示例使用了默认的保护设置和权限名称。

# Merge these sections into the generated Settings.yml.
# Keep the generated Plugin-Version and Config-Version values.
Plugin-Config:
  Enabled: true
  Update-Checker: true
  Debug: false
  Disabled-Worlds: []

Pearl-Checks:
  Safe-Landing: true
  Block-Gaps: true
  Gap-Height: 0.6
  Refund-Pearl: true
  Alerts: true

Permissions:
  Bypass: "pearlfix.bypass"
  Staff: "pearlfix.alerts"
  Reload: "pearlfix.reload"
  Admin: "pearlfix.admin"
  • Plugin-Config.Enabled. 默认值为 true。启用或禁用所有珍珠检查。

  • Plugin-Config.Update-Checker. 默认值为 true。在启动时异步检查 Spigot,并通知控制台和授权管理员有新版本可用。

  • Plugin-Config.Debug. 默认值为 false。将珍珠检查详细信息记录到控制台。个人聊天调试通过 /pearlfix debug 单独控制。

  • Plugin-Config.Disabled-Worlds. 默认值为 []。世界名称匹配不区分大小写;这些世界中的珍珠不会被检查。

  • Pearl-Checks.Safe-Landing. 默认值为 true。使用玩家的真实包围盒来确保落地点位于方块碰撞体外;如果找不到安全的位置,则进行本地调整或取消。

  • Pearl-Checks.Block-Gaps. 默认值为 true。追踪珍珠的路径,并阻止穿过比配置的玩家通行宽度更窄的开口进行的传送。

  • Pearl-Checks.Gap-Height. 默认值为 0.6;范围 0.6–1.8 个方块。这是配置的最小高度,而不是根据玩家当前姿态自动选择的值。0.6 是爬行大小的基准,1.5 是潜行大小的基准,1.8 是站立大小的基准。已考虑缩放后的玩家尺寸。

  • Pearl-Checks.Refund-Pearl. 默认值为 true。在这些检查导致取消后,非创造模式下返还一颗末影珍珠。如果背包已满,珍珠将在玩家位置掉落。

  • Pearl-Checks.Alerts. 默认值为 true。将间隙被阻止的警报发送给控制台和具有 Permissions.Staff 权限的工作人员。警报被节流处理,每两秒每个玩家最多一条。

  • Permissions. 四个可配置的节点:Bypass、Staff、Reload 和 Admin。空白值回退到默认节点名称。使用你的权限管理器授予重命名的节点;描述符的操作员默认值和子链接关系适用于原始名称。

  • Plugin-Version / Config-Version. 由插件管理。保持原样不变,以便安全地运行配置升级。

Messages — formatting & built-in variables

消息支持 MiniMessage 颜色和样式、传统的 & 代码以及 HEX 颜色。完整的 RGB 显示需要 Minecraft 1.16 或更高版本;旧版本使用最接近的传统颜色。消息输出序列化为 Bukkit 文本,因此交互式的点击和悬停组件不属于本插件的消息系统。

将任何消息设置为 "" 以静音。插件会替换其自己的 {...} 变量;这些不需要 PlaceholderAPI。对于珍珠检查和工作人员反馈中涉及的玩家,可以使用 {player}。

  • Messages.Prefix. 插件消息前使用的前缀。设置为空字符串以移除它。

  • Messages.No-Perms / Usage. 命令权限反馈与命令用法。

  • Messages.Reload / Reload-Failed. 重载结果。Reload-Failed 支持 {error}。

  • Messages.Unsafe-Location. 当无法找到安全落点时向玩家提供的反馈。

  • Messages.Through-Gap. 当窄缝检测取消传送时向玩家提供的反馈。

  • Messages.Pearl-Returned. 当被取消的珍珠被退款时向玩家提供的反馈。

  • Messages.Block-Glitch-Message. 工作人员关于缝隙的警报。支持 {player}、{world}、{x}、{y} 和 {z}。

  • Messages.Debug-On / Debug-Off. 个人聊天调试功能的反馈。

  • Messages.Status. 支持 {version}、{minecraft}、{shapes}、{checked}、{moved}、{gaps} 和 {room}。

  • Messages.Update-Available. 支持 {version}(可用版本)和 {current}(已安装版本)。

Messages:
  Prefix: "<color:#B09CAA><bold>PearlFix</bold></color> <dark_gray>» </dark_gray>"
  Through-Gap: "<gray>Your pearl passed through an opening too small for you.</gray>"
  Pearl-Returned: "<gray>Your pearl has been returned.</gray>"
  Block-Glitch-Message: "<gray>{player} was stopped at a gap in {world}: {x}, {y}, {z}.</gray>"
从版本 6 升级及安全重载

版本 7 围绕碰撞形状和共享追踪器重建了珍珠检测机制。在升级之前,请备份插件文件夹,停止服务器,替换旧的 JAR 文件并重新启动服务器。

配置更新会保留受支持的自定义值,并在重写文件之前将副本保存至 old-configs/ 目录下。旧的 Check-Distance、No-Corner 和 Very-Close 设置已被两个新的检测项取代。旧的消息占位符 %player% 和 %coords% 已迁移为 {player} 和 {x}, {y}, {z}。

请勿更改 Plugin-Version 和 Config-Version。现有的工作人员权限名称将被保留,包括较旧的 pearlfix.message 值。

无效的 YAML 文件不会被覆盖。如果重载失败,将报告错误并保留之前正常工作的设置。如果启动时无法读取配置文件,插件将使用内置的默认保护设置,直到你修复文件并重新加载。

文档与支持

需要帮助解决某个设置或投掷行为异常的问题吗?请与社区分享你的服务器版本、/pearlfix status 输出以及相关调试详情。

合作伙伴

Teramont 是我们的主机合作伙伴。使用代码 Byte 可享受首月费用 15% 的折扣。

© 2026 FruitForge Studios

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源