Plugin Minecraft spark

🔌 Giới thiệu spark

spark là một công cụ profiler hiệu năng cho máy chủ Minecraft, client và phần mềm proxy. Nó cung cấp các công cụ để kiểm tra hoạt động CPU, thu thập các memory snapshot cơ bản và heap dump, đồng thời báo cáo các chỉ số sức khỏe của server (TPS, thời lượng tick, mức sử dụng CPU/bộ nhớ/ổ đĩa). Dự án là open-source và được thiết kế để tạo ra đầu ra profiling dễ đọc với thiết lập tối thiểu.

🎯 Mục đích

Mục đích cốt lõi của spark là giúp quản trị viên server và nhà phát triển chẩn đoán nguyên nhân của hiệu năng kém (lag, tick rate thấp, sử dụng CPU cao, giữ bộ nhớ quá mức) bằng cách tạo các CPU profile theo mẫu, bản tóm tắt bộ nhớ, heap dump và các chỉ số sức khỏe liên tục.

⚙️ Tính năng

• Profiling CPU (statistical sampling) với hai engine: một engine dựa trên Java ThreadMXBean và một engine native/async-profiler tùy chọn (engine native có sẵn trên Linux và macOS).
• Kiểm tra bộ nhớ bao gồm các bản tóm tắt heap và khả năng tạo full HPROF heap dump để phân tích bên ngoài.
• Báo cáo sức khỏe server: đo TPS, thống kê thời lượng tick, mức sử dụng CPU và bộ nhớ, cùng giám sát mức sử dụng ổ đĩa.
• Đầu ra profile dễ đọc, được thiết kế để xem trong thành phần viewer của dự án.
• Thiết kế nhẹ, phù hợp để dùng trên server production với cấu hình tối thiểu.

🧩 Dành cho ai

• Quản trị viên và người vận hành server đang xử lý sự cố hiệu năng trên các mạng Survival, SMP, minigame hoặc mạng dùng proxy.
• Nhà phát triển plugin và mod cần dữ liệu profiling chính xác cho các luồng code và mức sử dụng bộ nhớ.
• Người vận hành các thiết lập Fabric/Forge/Spigot/Paper/Proxy cần chẩn đoán sâu hơn so với chỉ xem TPS.

🏗️ Ví dụ sử dụng

• Ghi lại một profile CPU ngắn để xác định plugin, mod hoặc tác vụ server nào đang tiêu tốn nhiều CPU nhất khi lag spike xảy ra.
• Tạo bản tóm tắt heap hoặc heap dump để kiểm tra số lượng instance quá nhiều hoặc rò rỉ bộ nhớ.
• Theo dõi liên tục TPS và thời lượng tick để đối chiếu các đợt giảm hiệu năng với sự kiện server hoặc tải từ bên ngoài.

⚙️ Cài đặt

📥 Thiết lập

• Tải jar plugin/mod phù hợp cho nền tảng của bạn.
• Đặt jar vào thư mục plugins/ của server (hoặc mods/plugins) cho nền tảng đích.
• Khởi động lại server và xác nhận plugin/mod đã tải bằng cách kiểm tra console/logs của server.

(Đây là các bước cài đặt tiêu chuẩn cho plugin kiểu Bukkit/Spigot/Paper và các nền tảng được hỗ trợ khác.)

🧠 Ghi chú kỹ thuật

• Dự án cung cấp các thành phần riêng cho từng nền tảng (Bukkit/Paper, Fabric, Forge, bản dựng proxy, v.v.).
• Engine async-profiler native chỉ có trên Linux và macOS; profiler dựa trên Java chạy trên bất kỳ JVM nào nhưng dùng phương pháp sampling khác.
• spark có thể tạo HPROF heap dump để phân tích bên ngoài bằng các công cụ JVM tiêu chuẩn.
• Dự án được phát hành theo giấy phép GNU GPLv3.

🤝 Khi nào plugin này hữu ích

Nếu bạn cần profiling dựa trên mẫu và kiểm tra bộ nhớ cụ thể để tìm nguyên nhân gốc của lag hoặc vấn đề bộ nhớ trên server hay proxy Minecraft, spark cung cấp profiling, kiểm tra heap và các chỉ số sức khỏe cần thiết để đưa ra quyết định debug và tối ưu hợp lý.