保持投掷,修正落点
安全着陆 · 狭窄间隙检测 · 可配置保护
末影珍珠是冒险的一部分,但卡进墙里就不该如此。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 / 一次设置,按需调整
安装与配置
-
将
DS-PearlFix-7.0.jar放入服务器的plugins文件夹并启动服务器。 -
打开
plugins/DS-PearlFix/Settings.yml。选择检查项目、最小间隙高度、排除的世界、退款和警报设置。 -
授予工作人员所需命令和警报权限。仅将
pearlfix.bypass分配给需要豁免的玩家。 -
运行
/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
你是这个资源的作者?登录后可认领此资源。
相似资源
ExyliaPlugins 的库。
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
使床在所有维度中爆炸的模组
为 Armor Poser 模组添加兼容性
SkyBlock、OneBlock、Boxed、SkyGrid、AcidIsland、CaveBlock、Poseidon、StrangerRealms——以及更多!这些只是由 BentoBox 支持的基于岛屿的游戏模式之一。来自原版 ASkyBlock 的作者。
一个在游戏内运行的 Minecraft 地图编辑器! 支持选区、蓝图、复制粘贴、笔刷和脚本。 可在创造模式中使用,也可在生存模式中临时使用。
评论 0
登录后参与评分
还没有评论,来抢沙发吧