CCLogger: Full Player Action Logging for Paper Servers

CCLogger: Full Player Action Logging for Paper Servers

Running a Minecraft server means constantly asking the same questions: Who said what? Which command changed the world? When did that player join or leave? Keeping track of everything manually is a losing battle, especially when your community grows beyond a handful of friends. CCLogger: Full Player Action Logging for Paper Servers steps in as a dedicated audit tool that records player activity in the background, giving you a clear, searchable timeline of everything that happens on your server. What makes this plugin stand out is not just that it logs events, but how much control it gives you over the process. From choosing where the data lives to deciding how sensitive information is handled, CCLogger adapts to your server's size and your personal privacy requirements. It is a fresh take on server moderation, built for administrators who want transparency without the performance hit.

What Events Does CCLogger Track?

The plugin focuses on three core areas of player activity, giving you a complete picture of your server's daily life.

Chat Messages

Every message sent in chat is captured with a timestamp, the world name, and the exact coordinates of the player who sent it. This is invaluable for resolving disputes or investigating griefing incidents, as you can pinpoint not just what was said, but where the speaker was standing.

Executed Commands

All commands entered by players or the console are recorded. Sensitive commands like /login or /register can be added to a blacklist, ensuring passwords and other confidential input never appear in plain text within your logs. This small feature goes a long way toward protecting your players.

Connection Events

Logins, logouts, and kicks are all logged. You can easily see who was online at any given time, spot unusual connection patterns, and keep a reliable record of player attendance.

Five Storage Backends for Every Server Size

A major advantage of CCLogger: Full Player Action Logging for Paper Servers is its support for five different storage backends. You are not locked into a single approach, which means the plugin scales from a small vanilla-style server to a large network. - File: Simple text files that are human-readable and require zero configuration. Perfect for small servers that just need basic logging. - SQLite: A local database that allows you to run SQL queries without setting up a separate database server. - MySQL: A familiar relational database ideal for server networks that need centralized log access across multiple worlds. - MongoDB: A document-oriented store that scales horizontally, great for projects with rapidly growing data volumes. - Redis: An in-memory database that delivers lightning-fast writes, suitable for high-traffic servers where every millisecond counts. All write operations are asynchronous, and connection pools are managed efficiently to protect your server's tick rate. Even with thousands of events per minute, your gameplay experience remains smooth.

Privacy and GDPR Compliance Built In

Modern server administration requires careful handling of IP addresses. CCLogger offers four distinct modes for logging IPs, allowing you to comply with regional regulations without sacrificing your audit trail. - disabled: IP addresses are not stored at all. - truncated: The last octet is zeroed out, so 192.168.1.42 becomes 192.168.1.0. - hashed: A bcrypt hash with a daily rotating salt is stored. This is irreversible but allows for hash comparison. - full: The complete address is stored, if your jurisdiction permits it. This flexible approach means you can tailor the level of detail to your needs while keeping player privacy in mind.

Real-Time Alerts for Suspicious Activity

Beyond passive logging, CCLogger actively monitors for red flags. You can define a list of trigger words (like "hack", "cheat", or "exploit") and specific commands (such as /op or /gamemode). The moment a player uses one of these triggers, operators with the cclogger.notify permission receive an instant in-game notification. All triggers are also saved to a separate file, so you can review them later at your leisure.

The Built-In Web Dashboard for Deep Analysis

One of the most exciting additions is the optional web dashboard, built with React. It is disabled by default, but once enabled, it transforms how you interact with your logs. - An overview page with event type breakdowns and a distribution chart. - A live activity feed that updates automatically, with pause and filter options. - Full-text search across all records, filterable by player, date, and category. - Player profiles with avatars (via Crafatar), statistics summaries, and action histories. - Export functionality to JSON or CSV for external analysis. - A built-in REST API with JWT authentication and rate limiting for integration with external systems. Getting started is as simple as enabling the web interface in the config and specifying a port. The dashboard is a game-changer for server owners who want more than just raw text files.

How to Install CCLogger on Your Server

CCLogger: Full Player Action Logging for Paper Servers for Minecraft runs on Paper 1.21+ and Folia, and it requires Java 21. Installation is straightforward. To install, you need to download CCLogger: Full Player Action Logging for Paper Servers and place the JAR file into your plugins/ folder. After restarting the server, a default configuration file is generated at plugins/CCLogger/config.yml. The plugin immediately starts logging to SQLite. If you prefer a different backend, just change the storage.type parameter and run /cclogger reload. For those looking for a smoother way to manage server plugins, many administrators turn to launchers that allow direct updates from a menu. This keeps your focus on configuration rather than file management.

Commands and Permissions Overview

The plugin includes a set of straightforward commands for daily management. - /cclogger displays help for all subcommands. - /cclogger reload reloads the config (requires cclogger.reload). - /cclogger count <word> [player] counts how often a word appears in the logs (requires cclogger.statistics). - /cclogger clear archives and clears the current logs (requires cclogger.admin). Key permissions include cclogger.* for full access (granted to operators by default), cclogger.notify for receiving alerts, and cclogger.exempt to exclude a player from logging entirely. Full details are available in the plugin's documentation.

Final Thoughts: Transparency Without Compromise

CCLogger: Full Player Action Logging for Paper Servers answers the need for detailed server auditing without forcing you to sacrifice performance or privacy. With five storage options, smart real-time alerts, a powerful web dashboard, and a flexible permission system, it is a versatile tool for administrators at any level. Set it up once, and you will always know exactly what is happening in your world, whether you run a small community or a large server network. The plugin turns raw data into actionable insight, making it an essential addition to any serious Paper server setup.