MSMP Entity

MSMP Entity

Серверный мод для Fabric, расширяющий Minecraft Server Management Protocol (MSMP) за счёт дополнительных функций для получения и изменения данных сущностей. Мод предназначен для инструментов, дашбордов, систем автоматизации, внешнего мониторинга и интеграций, которым нужен структурированный доступ к информации о сущностях без парсинга команд или костылей через RCON.

Установка

1. Скачай .jar мода и положи его в папку mods/ на сервере.

2. Включи Management Server в server.properties:

   management-server-enabled=true

3. Запусти сервер. Management Server по умолчанию будет слушать localhost:25576.

Конфигурация

При первом запуске мод создаёт файл конфигурации по пути <server_root_dir>/config/msmp/entity/config.yml, где можно настроить систему уведомлений для отслеживаемых событий, использующих опрос по порогу/интервалу:

# 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

Меньшие значения интервала означают более частые проверки (и потенциально больше уведомлений) ценой немного большей нагрузки на сервер. Установка дельты в 0.0 вызывает уведомление при любом изменении, каким бы малым оно ни было.

RPC-методы

На данный момент мод предоставляет следующие RPC-методы MSMP. Все они также автоматически обнаруживаются через стандартную конечную точку MSMP rpc.discover.

| 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, на которые могут подписаться клиенты:

Если вы хотите больше методов или уведомлений для других целей, пожалуйста, откройте issue

Лицензия

LGPL-3.0