ThreadSight

# ThreadSight: Real-Time Performance Intelligence **ThreadSight** is a lightweight, high-performance server performance monitoring plugin for **Minecraft 1.21.1** (Paper / Folia). It is designed for administrators who need a "live pulse" on their server health—specifically MSPT, entity counts, and loaded chunks—without the overhead or complexity of deep-dive profilers. --- ## Why use ThreadSight? * **Zero Overhead Monitoring:** Built with a thread-safe, interface-driven architecture that samples metrics every 20 ticks (1 second) by default, avoiding heavy per-tick world scans. * **Folia Native:** Auto-detects Folia at startup and utilizes a specialized `FoliaRegionCollector` to safely identify entity hotspots across different region threads. * **Proactive Alerts:** Includes an alert system that broadcasts warnings to ops when MSPT or entity counts exceed your configurable thresholds. * **Dashboard Ready:** Native **PlaceholderAPI** support allows you to expose real-time metrics in scoreboards, tab lists, and chat. * **Historical Snapshots:** Query a history of the last 60 snapshots in-game to see if performance issues are a momentary blip or a steady trend. --- ## 🛠 Quick Start 1. Place the `Thread Sight-1.0-SNAPSHOT.jar` in your server's `plugins/` folder. 2. Restart the server; the plugin is ready to use immediately with sensible defaults. 3. Use `/threadsight` for an instant global metrics check (MSPT, entities, chunks). 4. Use `/threadsight regions` (Folia only) to locate the top entity hotspots by chunk. --- ## 💡 Custom Development Looking for a custom mod, a specific plugin, or a unique feature tailored to your server's needs? Let's build something great together! **Get your custom project done here:** (https://www.fiverr.com/s/BRYKYXb)