MC Chat Logger

Support & Updates / Chat Log Viewer

A lightweight client-side mod that logs public chat messages in servers to JSON files.

Features

• Automatic logging - All public chat messages are captured and saved automatically
• Organized by server - Each server gets its own folder (e.g., chatlogs/hypixel_net/)
• Session-based files - Each play session creates a new JSON file, so your logs stay organized
• Real-time saving - Messages are saved immediately to prevent data loss if your game crashes

Coming soon: Web UI to visualize chat logs, examples for finetuning a LLM on chatlogs, and more.

Output Format

Logs are saved to .minecraft/chatlogs/<server>/session_<date>_<id>.json (or the chatlogs folder in your Minecraft folder):

{
    "server": "play_example_com",
    "sessionId": "a1b2c3d4",
    "sessionStart": "2024-01-15 14:30:00",
    "lastUpdated": "2024-01-15 15:45:30",
    "messageCount": 127,
    "messages": [
        {
            "timestamp": "2024-01-15 14:31:05",
            "epochMillis": 1705329065000,
            "senderUuid": "069a79f4-44e9-4726-a5be-fca90e38aaf5",
            "senderName": "Notch",
            "message": "<Notch> Hello everyone!"
        }
    ]
}

Use Cases

• Archive memorable conversations
• Paper trail for reports
• Monitor chat while AFK
• Analyze chat patterns
• Create chat statistics
• Build external tools that read your chat history

Support

Feel free to DM me on Discord (bl4747) if you need any support. You can also join my server.

Note

Make sure you acquire all necessary consent before recording chat messages! You are fully responsible for your use of this mod.