[DP] 开发者助手

[DP] DevAssist

针对 Fabric 服务端的数据包性能分析和运行检查工具。

[DP] DevAssist 专为数据包作者、地图制作者以及技术服务器管理员打造，他们无需离开 Minecraft 即可查看世界中正在发生的事情。它将服务端卡顿分析器与客户端实体、标记、展示实体、命令存储、计分板、标签及原始 SNBT 检查器结合在了一起。

功能说明

• 分析服务端上的数据包函数和命令。
• 每 5 个游戏刻向客户端推送一次紧凑的实体性能快照。
• 显示 30 格范围内的附近实体，包括隐形实体和原版标记实体。
• 显示每个实体的单刻耗时、峰值 MSPT 消耗、生命周期、热点路径以及最近的刻历史。
• 提供完整的游戏内检查器，用于查看实体 SNBT、计分板数值、计分板标签和命令存储。
• 包含原始 SNBT 编辑以及结构化的树状视图，便于检查。
• 为 SNBT、计分板和存储增加了可搜索的文本视图。
• 允许有权限的玩家传送至被检查的实体或将其删除。
• 包含飞行中的创造模式透墙功能，由服务端授权，类似于 Carpet 的创造模式透墙行为。

为什么使用它

数据包卡顿很难从游戏外部诊断。[DP] DevAssist 让你在站在受影响区域时，就能查看涉及的实体和函数。

用它来回答诸如以下问题：

• 是哪个标记实体或展示实体导致了卡顿尖峰？
• 当前哪个函数路径是热点？
• 这个实体的 SNBT 内部发生了什么变化？
• 有哪些计分板数值附加到了这个实体上？
• 存在哪些命令存储条目，它们包含什么内容？
• 服务端 MSPT 尖峰是全球性的，还是与特定实体相关？

基本用法

默认辅助键为 左 Alt。按住辅助键可在世界中显示实体标记和紧凑的运行时信息。按住辅助键时，右键点击实体标记或目标实体可打开检查器。

检查器包括：

• 按热度排序的实体列表
• 服务器和实体 MSPT 快照
• 分析器热点路径
• 实体概览
• 计分板数值
• 计分板标签
• 原始 SNBT 编辑器
• 结构化的 SNBT 树状视图
• 命令存储浏览和编辑器

当服务端允许时，创造模式透墙会自动生效：进入创造模式，开始飞行，即可穿过方块。此功能不会自行强制进入飞行状态。

命令

主命令：

/dpdevassist

短别名：

/dpda

可用子命令：

/dpdevassist status
/dpdevassist monitor on
/dpdevassist monitor off
/dpdevassist threshold spike <毫秒数>
/dpdevassist threshold command <毫秒数>
/dpdevassist threshold function <毫秒数>

所有命令都需要管理员级别的命令权限。在单人游戏中，世界所有者会被自动授权。

安全提示

这是一个面向开发者和操作员的工具。它可以编辑实体 SNBT、计分板数值、计分板标签、命令存储，并且可以删除实体。请在正式环境的世界中谨慎使用。

建议：

• 在编辑 SNBT 或存储之前，备份重要世界。
• 先在测试副本中测试更改。
• 仅授予受信任的操作员访问权限。

性能提示

[DP] DevAssist 旨在保持响应速度，同时避免淹没客户端：

• 实体概要每 5 个刻同步一次。
• 完整的实体 SNBT 仅在请求时发送。
• 计分板解析受到限制。
• 客户端仅渲染附近已同步的实体，并将繁重的编辑视图保留在检查器内部。