?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacksServers
Settings
MSMP Entity

MSMP Entity

Extends the Minecraft Server Management Protocol (MSMP) by providing additional functions for getting and setting entity data

56
0
56
0

Compatibility

Minecraft: Java Edition

26.2
26.1.x

Platforms

Supported environments

Dedicated servers only

Links

Report issues View source

Tags

Creators

Details

Published last month

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