1.0.0
release
Chat Logger
Complete chat, command & connection logging per player and per server for your Minecraft server
52
Chat Logger
<div align="center">
📝 ChatLogger
> Complete chat, command & connection logging for your Minecraft server
A lightweight plugin that keeps detailed logs of everything that happens on your server. Perfect for moderation, auditing, and keeping track of player activity—all stored in simple, readable text files. No database required.
</div>
---
✨ Features
- ⚡ No Database — Logs sorted into `players`, `admins`, and `server_log` folders - ⚡ No Database — When a player gains OP or admin permission, their logs automatically move to the admins folder (and back when they lose it) - ⚡ No Database — Every chat message recorded with timestamps - ⚡ No Database — All commands executed by players are logged - ⚡ No Database — Commands run from the server console are logged in `server_log` and in `admins/console.txt` - ⚡ No Database — Join and disconnect times captured - ⚡ No Database — Easy to find and review any player's history - ⚡ No Database — Combined log per day (`server_log/yyyy-MM-dd.txt`) with chat, commands, console commands, joins & quits from all players — newest entries at top - ⚡ No Database — Use UTC, CET, or any timezone you need - ⚡ No Database — Flexible formatting (dd/MM/yy, HH:mm:ss, etc.) - ⚡ No Database — Pure text files, no setup required
---
📋 What Gets Logged?
Per-player logs (`players/` & `admins/`): - Header: Nickname, UUID, Last activity, Last IP - Entries (newest first): `[CHAT]`, `[CMD]`, `[JOIN]`, `[QUIT]`
Server-wide daily logs (`server_log/`): - All chat messages, player commands, console commands, joins and quits - One file per day (e.g. `2025-12-12.txt`) - Newest entries at top
Console log (`admins/console.txt`): - All commands executed from the server console only - Newest entries at top
---
⚙️ Configuration
```yaml
Time zone (UTC, Europe/Warsaw, CET, America/New_York, etc.)
timezone: "UTC"
Date/time format for log entries
dd=day, MM=month, yy=year, HH=hour, mm=minute, ss=second
datetime-format: "dd/MM/yy HH:mm:ss"
Permission for admin folder (players with OP or this permission go to admins/)
admin-permission: "chatlogger.admin" ```
---
🎮 Permissions
| Permission | Description | |------------|-------------| | `chatlogger.admin` | Players with this permission (or OP) have logs stored in the `admins` folder |
---
📦 Compatibility
- Java: 1.20.x – 1.21.x (1.19.3+ for chat logging) - Java: Paper (required for chat events) - Java: 17+
---
🚀 Installation
1. Download the latest `ChatLogger.jar` 2. Place it in your server's `plugins` folder 3. Start or restart your server 4. Edit `plugins/ChatLogger/config.yml` if needed 5. Done! Logs appear in `plugins/ChatLogger/`
---
📜 Example Logs
Player file (`players/Steve.txt`): ```
Nickname: Steve
UUID: 069a79f4-44e9-1234-a1aaa-aa11aa11223abd
Last activity: 21/02/25 14:30:45
Last IP: 000.000.1.100
--- [21/02/25 14:30:45] [QUIT] Disconnected from server [21/02/25 14:30:12] [CMD] /msg Alex hello! [21/02/25 14:30:05] [CHAT] Hey everyone! [21/02/25 14:30:00] [JOIN] Connected to server ```
Server log (`server_log/2025-02-21.txt`): ``` [21/02/25 14:31:00] [CONSOLE] /say Server restart in 5 min [21/02/25 14:30:45] [QUIT] Steve: Disconnected from server [21/02/25 14:30:12] [CMD] Steve: /msg Alex hello! [21/02/25 14:30:05] Steve: Hey everyone! [21/02/25 14:30:00] [JOIN] Steve: Connected to server ```
Console log (`admins/console.txt`): ``` [21/02/25 14:31:00] [CONSOLE] /say Server restart in 5 min [21/02/25 14:00:00] [CONSOLE] /op Admin1 ```
---
<div align="center">
🛡️ Privacy & Performance
- Local storage only — File writes don't block the server - Local storage only — Lightweight design - Local storage only — All data stays on your server
---
🌟 License
The source code is not publicly available, but if you want to edit something in the plugin for your own needs, update the plugin to a new version or anything else, contact me on discord nickname: we_rt and we will definitely come to an agreement
---
Support
- contact me on discord nickname: we_rt, only with important bug related things
---
*Made with ❤️ for Minecraft Community*