Plugin Minecraft nightcore

🔌 Giới thiệu NightCore

NightCore là một thư viện nhẹ dành cho việc phát triển plugin máy chủ Minecraft. Nó cung cấp các tiện ích có thể tái sử dụng, công cụ dữ liệu và cầu nối tích hợp để các plugin khác không phải tự triển khai lại các chức năng phổ biến. Dự án được phân phối theo GPL-3.0 và được duy trì cùng với một bộ plugin phụ thuộc vào nó.

🎯 Mục đích

NightCore tồn tại để tập trung các nhu cầu chung của lập trình viên (cấu hình, bản địa hóa, trợ giúp cơ sở dữ liệu, phân tích lệnh, cầu nối item và economy, v.v.) ताकि tác giả plugin có thể tập trung vào logic tính năng thay vì hạ tầng. Nó hữu ích cho các nhà phát triển và quản trị viên server đang chạy hoặc triển khai nhiều plugin được NightExpress/NightCore hỗ trợ.

⚙️ Tính năng

• Cầu nối server cung cấp hỗ trợ thống nhất cho Spigot, Paper và Folia.
• Cầu nối economy để giao tiếp với nhiều plugin tiền tệ/economy.
• Cầu nối item và hỗ trợ nhà cung cấp item tùy chỉnh cho các hệ thống item của bên thứ ba.
• Cầu nối quyền hạn để tích hợp với các plugin permission khác nhau.
• Tiện ích lệnh: phân tích tham số, kiểu tham số tùy chỉnh, và trợ giúp tab completion.
• Công cụ cấu hình YAML với đọc/ghi kiểu schema và giữ nguyên comment.
• Công cụ bản địa hóa cho các file ngôn ngữ có cấu trúc và thông điệp có tham số.
• Công cụ cơ sở dữ liệu hỗ trợ SQLite và MySQL cùng các helper để đồng bộ dữ liệu bảng.
• Tiện ích trợ giúp cho Inventory GUI và màn hình dialog.
• Helper và wrapper tiện ích cho Player, entity, location và ItemStack.
• Helper PersistentDataContainer và tiện ích reflection cho các tác vụ nâng cao.
• Bộ theo dõi block do người chơi đặt, lưu dữ liệu vị trí trong bộ nhớ chunk gốc.

🧩 Dành cho ai

• Các nhà phát triển plugin đang xây dựng hoặc duy trì plugin Spigot/Paper/Folia, đặc biệt là họ plugin NightExpress.
• Quản trị viên server chạy nhiều plugin và muốn dùng một lớp tiện ích dùng chung.

🏗️ Ví dụ sử dụng

• Một plugin dùng cầu nối economy của NightCore để tương tác với bất kỳ plugin economy nào có trên server.
• Một nhà phát triển dùng các schema cấu hình và bản địa hóa của NightCore để tránh viết đi viết lại mã xử lý file.
• Một server cài plugin NightExpress yêu cầu NightCore như một thư viện dùng chung.

⚙️ Cài đặt

📥 Thiết lập

• Tải JAR plugin NightCore chính thức từ trang phân phối của dự án.
• Đặt JAR vào thư mục plugins/ của server cùng với các plugin tương thích Bukkit khác.
• Khởi động lại server và kiểm tra trong console rằng NightCore đã tải thành công.

📦 Phụ thuộc

• Không có phụ thuộc bên ngoài nào được ghi là bắt buộc; NightCore cung cấp các cầu nối để tích hợp với các hệ thống phổ biến (economy, permission, item tùy chỉnh) khi các hệ thống đó có mặt.

🧠 Ghi chú kỹ thuật

• Các nền tảng được hỗ trợ đã xác nhận: Spigot, Paper, Purpur và Folia.
• Các mục tương thích được tài liệu hóa bao gồm các dải phát hành Minecraft hiện đại (ví dụ được hiển thị trên các trang phân phối chính thức). Chủ server nên dùng bản NightCore khớp với phiên bản Minecraft của server mình.
• Được cấp phép theo GPL-3.0.

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

Nếu bạn đang duy trì hoặc phát triển các plugin cần các tiện ích server phổ biến (config, bản địa hóa, helper DB, phân tích lệnh, tích hợp economy/item/permission), NightCore giảm công việc lặp lại bằng cách cung cấp một lớp thư viện dùng chung, được duy trì.