Minecraft-plugin spark

🔌 Om spark

spark är en prestandaprofilare för Minecraft-servrar, klienter och proxyprogramvara. Den erbjuder verktyg för att inspektera CPU-aktivitet, samla in grundläggande minnesnappar och heap dumps samt rapportera serverhälsomått (TPS, ticktider, CPU-/minnes-/diskanvändning). Projektet är open-source och utformat för att ge läsbart profileringsutdata med minimal installation.

🎯 Syfte

spark:s kärnsyfte är att hjälpa serveradministratörer och utvecklare att diagnostisera orsakerna till dålig prestanda (lagg, låg tick rate, hög CPU-användning, överdrivet minnesutnyttjande) genom att skapa samplade CPU-profiler, minnessammanfattningar, heap dumps och kontinuerliga hälsomått.

⚙️ Funktioner

• CPU-profilering (statistical sampling) med två motorer: en Java ThreadMXBean-baserad motor och en valfri native/async-profiler-motor (native-motorn finns tillgänglig på Linux och macOS).
• Minnesinspektion inklusive heapsammanfattningar och möjligheten att skapa fullständiga HPROF heap dumps för extern analys.
• Rapportering av serverhälsa: TPS-mätningar, statistik över ticktid, CPU- och minnesanvändning samt övervakning av diskanvändning.
• Lättläst profileringsutdata avsedd att visas i projektets viewer-komponent.
• Lättviktsdesign avsedd att kunna användas på produktionsservrar med minimal konfiguration.

🧩 För vem är detta

• Serveradministratörer och operatörer som felsöker prestandaproblem på Survival-, SMP-, minigame- eller proxy-baserade nätverk.
• Plugin- och modutvecklare som behöver exakt profileringsdata för kodvägar och minnesanvändning.
• Operatörer som kör Fabric/Forge/Spigot/Paper/Proxy-upplägg som kräver djupare diagnostik än enkla TPS-avläsningar.

🏗️ Exempel på användning

• Fånga en kort CPU-profil för att identifiera vilket plugin, mod eller serveruppgift som använder mest CPU under laggspikar.
• Ta en heapsammanfattning eller heap dump för att undersöka överdrivna instansantal eller minnesläckor.
• Övervaka TPS och ticktider kontinuerligt för att koppla prestandaförsämringar till serverhändelser eller extern belastning.

⚙️ Installation

📥 Setup

• Ladda ner rätt plugin-/mod-jar för din plattform.
• Placera jar-filen i serverns plugins/-mapp (eller mods/plugins) för målplattformen.
• Starta om servern och bekräfta att pluginen/modden laddas genom att kontrollera serverns konsol/loggar.

(Dessa är standardinstallationsstegen för Bukkit/Spigot/Paper-liknande plugins och andra stödjda plattformar.)

🧠 Tekniska anteckningar

• Projektet tillhandahåller plattformsspecifika komponenter (Bukkit/Paper, Fabric, Forge, proxy-builds, etc.).
• Den native async-profiler-motorn finns endast på Linux och macOS; den Java-baserade profilaren fungerar på alla JVM:er men använder en annan samplingmetod.
• spark kan skapa HPROF heap dumps för extern analys med standardverktyg för JVM.
• Projektet släpps under GNU GPLv3-licensen.

🤝 När detta plugin är användbart

Om du behöver konkret, samplingsbaserad profilering och minnesinspektion för att hitta grundorsaken till lagg eller minnesproblem på en Minecraft-server eller proxy, erbjuder spark den profilering, heap-inspektion och de hälsomått som behövs för att fatta välgrundade felsöknings- och trimningsbeslut.