mcsl

<div align="center"> # 📋 MCSL — MineCraftServerLogs ### The fastest way to capture, analyse, and share your Minecraft server logs. (https://img.shields.io/badge/Minecraft-1.8.8--1.21.x-brightgreen?style=for-the-badge&logo=minecraft&logoColor=white)](https://modrinth.com/plugin/mcsl) (https://img.shields.io/badge/Platform-Spigot%20%7C%20Paper%20%7C%20Folia-blue?style=for-the-badge)](https://modrinth.com/plugin/mcsl) (https://img.shields.io/badge/License-MIT-purple?style=for-the-badge)](https://github.com/protectcord/mcsl/blob/main/LICENSE) (https://img.shields.io/badge/Powered%20by-HasteLog-0ea5e9?style=for-the-badge)](https://logs.protectcord.com) (https://img.shields.io/bstats/servers/30872?style=for-the-badge&label=Servers&color=orange)](https://bstats.org/plugin/bukkit/MCSL/30872) --- > **MCSL** is a lightweight Minecraft server plugin that gives server administrators a single command to upload, parse, redact, and share server logs — all powered by (https://logs.protectcord.com), a fast and free log-sharing service. No more copy-pasting giant log files into chat or Discord. One command and your log is live on the web, ready to share with support staff, developers, or your community. --- ``` : ────────────────────────────────────────────────── : MCSL — MineCraftServerLogs v1.0.0 : Powered by https://logs.protectcord.com : ────────────────────────────────────────────────── : /mcsl upload — Upload latest.log to HasteLog : /mcsl info — Print server info summary : /mcsl errors — Show recent errors in chat : /mcsl players — Show player events from log : /mcsl plugins — List all plugins & status : /mcsl share — Upload full diagnostic report : /mcsl crash — Upload latest crash report : ────────────────────────────────────────────────── ``` </div> --- ## 🎯 Who Is This Plugin For? MCSL is built specifically for **server administrators and developers** who spend time diagnosing issues on Bukkit, Spigot, Paper, Purpur, or Folia servers. | If you are... | MCSL helps you... | |---|---| | A **server owner** with a broken plugin | Upload errors instantly and share the link with the plugin's support team | | A **developer** debugging your own plugin | Get a full diagnostic report — version, all loaded plugins, errors, TPS — in one link | | A **network admin** managing multiple servers | Run `/mcsl share` on any node and get a single URL to compare behaviour across servers | | A **support volunteer** on a help Discord | Ask users to run `/mcsl upload errors` instead of pasting 3,000 lines of log | | A **hosting provider** | Include MCSL on your pre-installed plugin list — your clients get self-service diagnostics | --- ## ✨ Features ### 🔼 One-Command Log Upload Upload your entire `latest.log` — or just the last N lines, or only errors — to (https://logs.protectcord.com) with a single command. You get back a short, shareable URL that you can click directly from your in-game chat. ### 🔍 Intelligent Log Parsing MCSL automatically scans your logs and categorises what it finds: - **Errors & Exceptions** — full stack traces, ``, `` entries - **Warnings** — `` and `` entries - **Plugin events** — which plugins enabled, disabled, or failed to load - **Player events** — join, leave, kick, and ban entries - **Crash signals** — Minecraft crash report headers and unhandled exceptions ### 🔒 Privacy-First Redaction Before anything leaves your server, MCSL scrubs sensitive data: - IPv4 and IPv6 addresses → `` - JWT tokens → `` - API keys and Bearer tokens → `` - JDBC/database passwords → `password=` - Your own custom regex patterns (defined in `config.yml`) All redaction is configurable and can be turned on or off per category. **Player IPs are redacted by default.** ### 📊 Full Server Diagnostic Reports `/mcsl share` produces a rich, structured report including: - Server software, version, and full build string - All loaded plugins with version and enabled/disabled status - All loaded mods (Forge 1.12, Forge 1.13+, and Fabric all supported via reflection) - Memory usage, TPS (1m/5m/15m), and server uptime - MOTD, gamemode, difficulty, online mode, max players - Parsed errors, warnings, and player events - The full log tail ### 💥 Automatic Crash Detection If your server crashes unexpectedly, MCSL's JVM shutdown hook fires automatically, uploads the last 1,000 log lines along with the parsed error summary, and logs the HasteLog URL to console — even if the Bukkit scheduler is no longer running. Online o