---

✨ Features

• 📂 Organized Storage — Logs sorted into players, admins, and server_log folders
• 🔄 Smart Categorization — When a player gains OP or admin permission, their logs automatically move to the admins folder (and back when they lose it)
• 💬 Full Chat Logging — Every chat message recorded with timestamps
• ⌨️ Command Tracking — All commands executed by players are logged
• 🖥️ Console Logging — Commands run from the server console are logged in server_log and in admins/console.txt
• 🔌 Connection Events — Join and disconnect times captured
• 📄 One File Per Player — Easy to find and review any player's history
• 📋 Daily Server Log — Combined log per day (server_log/yyyy-MM-dd.txt) with chat, commands, console commands, joins & quits from all players — newest entries at top
• 🌍 Configurable Timezone — Use UTC, CET, or any timezone you need
• 📅 Custom Date Format — 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

# 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

• Minecraft: 1.20.x – 1.21.x (1.19.3+ for chat logging)
• Server: 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

---