MSMP Entity

A server-side Fabric mod that extends the Minecraft Server Management Protocol (MSMP) by providing additional functions for getting and setting entity data.

This mod is designed for tooling, dashboards, automation systems, external monitoring tools, and integrations that need structured access to entity information without relying on command parsing or RCON hacks.

Installation

1. Download the mod .jar and place it in your server's mods/ folder.
2. Enable the Management Server in server.properties: management-server-enabled=true
3. Start the server. The Management Server will listen on localhost:25576 by default.

Configuration

On first start, the mod generates a configuration file at <server_root_dir>/config/msmp/entity/config.yml, where you can tune the notification system for the tracked events that use threshold/interval-based polling:

# Main configuration file for MSMP Entity. # Configuration for position-related settings. position: # Settings for notifications. notification: # Number of server ticks between position change checks for subscribed entities. # Lower values result in more frequent checks and potentially more notifications, but can increase server load. # @default: 20 interval-ticks: 20 # Minimum distance in blocks that an entity must move to trigger a position change notification. # Setting this to 0.0 will trigger a notification for any movement. # @default: 1.0 block-delta: 1.0 # Configuration for rotation-related settings. rotation: # Settings for notifications. notification: # Number of server ticks between rotation change checks for subscribed entities. # Lower values result in more frequent checks and potentially more notifications, but can increase server load. # @default: 20 interval-ticks: 20 # Minimum change in yaw or pitch, in degrees, that an entity must rotate to trigger a rotation change notification. # Setting this to 0.0 will trigger a notification for any rotation change. # @default: 10.0 rotation-delta: 10.0

Lower interval values mean more frequent checks (and potentially more notifications), at the cost of slightly more server load. Setting a delta to 0.0 triggers a notification on any change, however small.

RPC Methods

The mod currently provides the following MSMP RPC methods. All of these methods are also automatically discoverable through the standard rpc.discover MSMP endpoint.

Method Description entity:dimension Returns the current dimension of any loaded entity by UUID, or a player by name entity:dimension/set Transfers any loaded entity to the given dimension, keeping its current position and rotation entity:dimension/changed Returns a list of all tracked entities for the dimension changed event entity:dimension/changed/add Add entities to the dimension change notification tracker entity:dimension/changed/clear Clear all entities for the dimension changed event entity:dimension/changed/remove Remove entities from the dimension change notification tracker entity:health Returns the current and maximum health of any LivingEntity entity:health/set Partially updates the health and/or maximum health of any LivingEntity entity:health/changed Returns a list of all tracked entities for the health changed event entity:health/changed/add Add entities to the health change notification tracker entity:health/changed/remove Remove entities from the health change notification tracker entity:items Returns all occupied inventory slots of an online player in Vanilla NBT format entity:items/set Partially updates an online player's inventory using a diff approach entity:items/changed Returns a list of all tracked entities for the items changed event entity:items/changed/add Add players to the items change notification tracker entity:items/changed/remove Remove entities from the items change notification tracker entity:position Returns the current position of any loaded entity entity:position/set Teleports any loaded entity to the given position within its current dimension entity:position/changed Returns a list of all tracked entities for the position changed event entity:position/changed/add Add entities to the position change notification tracker entity:position/changed/remove Remove entities from the position change notification tracker entity:rotation Returns the current rotation of any loaded entity by UUID, or a player by name entity:rotation/set Sets the rotation of any loaded entity, preserving its position and dimension entity:rotation/changed Returns a list of all tracked entities for the rotation changed event entity:rotation/changed/add Add entities to the rotation change notification tracker entity:rotation/changed/remove Remove entities from the rotation change notification tracker entity:saturation Returns the current food level and saturation of an online player entity:saturation/set Partially updates the food level and/or saturation of an online player entity:saturation/changed Returns a list of all tracked entities for the saturation changed event entity:saturation/changed/add Add players to the saturation change notification tracker entity:saturation/changed/remove Remove entities from the saturation change notification tracker entity:uuid Returns the UUID of an online player by name

RPC Notifications

The mod also provides the following MSMP RPC notifications that clients can subscribe to:

Method Description entity:notification/dimension/changed Fires when a tracked entity changes dimension entity:notification/health/changed Fires when a tracked LivingEntity's health changes entity:notification/items/changed Fires when a tracked player's inventory or equipment changes entity:notification/position/changed Fires when a tracked entity moves at least blockDelta blocks entity:notification/rotation/changed Fires when a tracked entity rotates at least rotationDelta degrees entity:notification/saturation/changed Fires when a tracked player's food level or saturation changes

If you want more methods or notifications for other purposes, please open an issue

License

LGPL-3.0