Plugin Minecraft eco

🔌 Về eco

eco là một thư viện phát triển Spigot (một plugin Minecraft độc lập) được thiết kế để đơn giản hóa việc phát triển plugin và cung cấp các tính năng engine có thể tái sử dụng cho những plugin khác. Nó cung cấp API cho lệnh và cấu hình, các bộ chuyển đổi lưu trữ lâu dài, hệ thống GUI và item tùy chỉnh, cùng nhiều tích hợp để tác giả plugin có thể tái sử dụng các chức năng chung thay vì tự triển khai lại.

🎯 Mục đích

eco tồn tại để tập trung các hệ thống phổ biến mà những plugin hiện đại cần ở phía nhà phát triển: phân tích lệnh, định dạng màu và tin nhắn, định dạng cấu hình, truy cập dữ liệu lâu dài, các thành phần GUI, xử lý item và tích hợp với các hệ thống phía server khác. Nó dành cho các tác giả plugin muốn xây dựng tính năng nhanh chóng trên một framework dùng chung, được duy trì.

⚙️ Tính năng

• API lệnh hiện đại và phân tích
• Phân tích màu gốc với hỗ trợ hex / RGB / MiniMessage
• Hệ thống cấu hình hỗ trợ YAML, JSON và TOML
• API lưu trữ dữ liệu lâu dài với các backend YAML, MySQL và MongoDB
• API GUI và các thành phần dựng sẵn
• Item tùy chỉnh và xử lý ItemStack siêu nhanh
• Hiển thị item qua packet và vòng lặp sự kiện packet nhẹ
• API AI của entity với ánh xạ NMS gần như 1:1
• Placeholder API và các tích hợp gốc (dự án liệt kê hơn 30 tích hợp)
• Trừu tượng hóa giá/kinh tế (hệ thống giá hỗ trợ plugin kinh tế, XP, item)
• Hỗ trợ native bStats và kiểm tra cập nhật plugin
• Hệ thống extension (plugin cho plugin) và công cụ dependency injection cho nhà phát triển

🧩 Dành cho ai

• Nhà phát triển plugin xây dựng plugin tương thích Spigot/Paper và muốn một framework có thể tái sử dụng
• Chủ server đang chạy các plugin phụ thuộc vào eco (eco phải được cài như một dependency)
• Các dự án cần item tùy chỉnh, GUI hoặc bộ công cụ thống nhất cho lưu trữ và lệnh

🏗️ Ví dụ sử dụng

• Một nhà phát triển tạo một gói item tùy chỉnh sử dụng API tìm kiếm item và GUI của eco.
• Một plugin dùng API lưu trữ của eco để hỗ trợ cả YAML cục bộ và backend MongoDB từ xa mà không phải lặp lại mã.
• Nhiều plugin nhỏ chia sẻ eco để xử lý lệnh và phân tích màu nhất quán.

⚙️ Cài đặt

📥 Thiết lập

• Cài eco như một plugin trên bất kỳ server nào cần nó bằng cách đặt file JAR vào thư mục plugins/ của server và khởi động lại server.
• Nếu plugin khác phụ thuộc vào eco, hãy khai báo trong plugin.yml của plugin đó ở depend: với - eco để server tải eco trước.

📦 Dependency (cho nhà phát triển plugin)

• Dự án cung cấp repository Maven và tọa độ Gradle để dùng compile-only. Dự án có artifact được phát hành (ví dụ với group com.willfp và các version tag) để nhà phát triển thêm eco như một dependency provided khi build.

🧠 Ghi chú kỹ thuật

• Phần mềm server được hỗ trợ: dự án chính thức cho biết hỗ trợ Spigot, Paper, Purpur và Folia.
• Phiên bản Minecraft được hỗ trợ: dự án nêu hỗ trợ từ 1.21.4 trở lên, và các bản build sau nhắm tới dòng 1.21.x hiện đại.
• Backend lưu trữ: framework cung cấp các adapter YAML, MySQL và MongoDB.
• Giấy phép: eco được phát hành dưới giấy phép MIT.

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

Nếu bạn đang phát triển nhiều tính năng hoặc plugin có nhu cầu chung (lệnh, định dạng cấu hình, thành phần GUI, lưu trữ, item tùy chỉnh), eco giúp giảm công việc lặp lại bằng cách cung cấp một framework được duy trì và các tích hợp mà những plugin khác có thể phụ thuộc vào.