Player Behavior Record

Mod Overview

The Player Behavior Record mod provides a specialized solution for collecting and transmitting data about player actions on Minecraft servers. This tool is designed for systematic analytics and monitoring of user behavior through integration with the Apache Kafka platform.

Main Configuration Parameters

threadPoolSize Number of thread pool workers for data processing. Default setting: 10

serverName Server identifier that helps distinguish data when the mod is installed on multiple servers. Standard value: server

dataPointIntervalMs Interval for periodic data collection in milliseconds. Default: 500

kafkaBootstrapServers Kafka bootstrap server addresses for connection. Standard configuration: localhost:9092

kafkaReconnectBackoffMaxMs Maximum wait time before reconnecting to Kafka. Default value: 5000

kafkaTopic Kafka topic name for data transmission

Functional Capabilities

Player Location Tracking

The system regularly captures player coordinates at set time intervals.

Key: player_location

Data:

{
  "time": "2024-01-01T00:00:00.000Z",
  "serverName": "server",
  "playerUUID": "00000000-0000-0000-0000-000000000000",
  "playerName": "player",
  "worldName": "minecraft:overworld",
  "x": 0.0,
  "y": 0.0,
  "z": 0.0
}

Player Activity Monitoring

Records player login and logout events, as well as total time spent on the server.

Key: player_activity

Data structure:

{
  "time": "2024-01-01T00:00:00.000Z",
  "serverName": "server",
  "playerUUID": "00000000-0000-0000-0000-000000000000",
  "playerName": "player",
  "loginIP": "127.0.0.1",
  "loginAt": "2024-01-01T00:00:00.000Z",
  "logoutAt": "2024-01-01T00:00:00.000Z",
  "onlineTimeSeconds": 0
}