MSMP Entity

模组

· 作者 Mqx

通过提供用于获取和设置实体数据的附加功能,扩展 Minecraft 服务器管理协议(MSMP)。

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

需要前置:Fabric API

最新 1.7.2 · 26.2 · Fabric

一键开服(送7天)

MSMP Entity

一个服务端 Fabric 模组,通过提供用于获取和设置实体数据的额外功能,扩展了 Minecraft Server Management Protocol (MSMP)。

此模组专为工具、仪表板、自动化系统、外部监控工具以及需要结构化访问实体信息而不依赖命令解析或 RCON 黑盒集成的场景而设计。

安装

  1. 下载模组 .jar 文件并将其放入服务器的 mods/ 文件夹中。
  2. 在 server.properties 中启用管理服务器:
    management-server-enabled=true
    
  3. 启动服务器。默认情况下,管理服务器将在 localhost:25576 上监听。

配置

首次启动时,模组会在 <server_root_dir>/config/msmp/entity/config.yml 生成配置文件,你可以在其中调整通知系统,针对使用基于阈值/间隔轮询的跟踪事件进行配置:

# MSMP Entity 的主配置文件。

# 与位置相关的设置配置。
position:
  # 通知设置。
  notification:
    # 对已订阅实体的位置变更检查之间的服务器刻数。
    # 较低的值会导致更频繁的检查并可能产生更多通知,但可能会增加服务器负载。
    # @default: 20
    interval-ticks: 20
    # 实体必须移动的最小距离(以方块为单位)以触发位置变更通知。
    # 将其设置为 0.0 将对任何移动触发通知。
    # @default: 1.0
    block-delta: 1.0
# 与旋转相关的设置配置。
rotation:
  # 通知设置。
  notification:
    # 对已订阅实体的旋转变更检查之间的服务器刻数。
    # 较低的值会导致更频繁的检查并可能产生更多通知,但可能会增加服务器负载。
    # @default: 20
    interval-ticks: 20
    # 实体必须旋转的最小偏航角或俯仰角变化量(以度为单位)以触发旋转变更通知。
    # 将其设置为 0.0 将对任何旋转变化触发通知。
    # @default: 10.0
    rotation-delta: 10.0

较低的间隔值意味着更频繁的检查(以及可能更多的通知),代价是略微增加的服务器负载。将增量设置为 0.0 将对任何变化(无论多小)触发通知。

RPC 方法

该模组目前提供以下 MSMP RPC 方法。所有这些方法也可以通过标准的 rpc.discover MSMP 端点自动发现。

方法 描述
entity:dimension 通过 UUID 或玩家名称返回任何已加载实体的当前维度
entity:dimension/set 将任何已加载的实体转移到指定维度,保持其当前位置和旋转角度
entity:dimension/changed 返回维度变化事件中所有被跟踪实体的列表
entity:dimension/changed/add 向维度变化通知跟踪器添加实体
entity:dimension/changed/clear 清除维度变化事件中的所有实体
entity:dimension/changed/remove 从维度变化通知跟踪器中移除实体
entity:health 返回任何 LivingEntity 的当前生命值和最大生命值
entity:health/set 部分更新任何 LivingEntity 的生命值和/或最大生命值
entity:health/changed 返回生命值变化事件中所有被跟踪实体的列表
entity:health/changed/add 向生命值变化通知跟踪器添加实体
entity:health/changed/remove 从生命值变化通知跟踪器中移除实体
entity:items 以原版 NBT 格式返回在线玩家所有占用的物品栏槽位
entity:items/set 使用差异方法部分更新在线玩家的物品栏
entity:items/changed 返回物品变化事件中所有被跟踪实体的列表
entity:items/changed/add 向物品变化通知跟踪器添加玩家
entity:items/changed/remove 从物品变化通知跟踪器中移除实体
entity:position 返回任何已加载实体的当前位置
entity:position/set 将任何已加载的实体传送至其当前维度内的指定位置
entity:position/changed 返回位置变化事件中所有被跟踪实体的列表
entity:position/changed/add 向位置变化通知跟踪器添加实体
entity:position/changed/remove 从位置变化通知跟踪器中移除实体
entity:rotation 通过 UUID 或玩家名称返回任何已加载实体的当前旋转角度
entity:rotation/set 设置任何已加载实体的旋转角度,保留其位置和维度
entity:rotation/changed 返回旋转变化事件中所有被跟踪实体的列表
entity:rotation/changed/add 向旋转变化通知跟踪器添加实体
entity:rotation/changed/remove 从旋转变化通知跟踪器中移除实体
entity:saturation 返回在线玩家的当前饥饿值和饱和度
entity:saturation/set 部分更新在线玩家的饥饿值和/或饱和度
entity:saturation/changed 返回饱和度变化事件中所有被跟踪实体的列表
entity:saturation/changed/add 向饱和度变化通知跟踪器添加玩家
entity:saturation/changed/remove 从饱和度变化通知跟踪器中移除实体
entity:uuid 通过玩家名称返回在线玩家的 UUID

RPC 通知

该模组还提供以下 MSMP RPC 通知,供客户端订阅:

方法 描述
entity:notification/dimension/changed 当被跟踪的实体改变维度时触发
entity:notification/health/changed 当被跟踪的 LivingEntity 的生命值发生变化时触发
entity:notification/items/changed 当被跟踪的玩家物品栏或装备发生变化时触发
entity:notification/position/changed 当被跟踪的实体移动至少 blockDelta 格时触发
entity:notification/rotation/changed 当被跟踪的实体旋转至少 rotationDelta 度时触发
entity:notification/saturation/changed 当被跟踪的玩家的饥饿值或饱和度发生变化时触发

如果您需要更多用于其他目的的方法或通知,请提交问题

许可证

LGPL-3.0

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源