Plugin Minecraft ItemJoin

🔌 Giới thiệu về ItemJoin

ItemJoin là một plugin Minecraft dùng để tự động trao cho người chơi các vật phẩm tuỳ chỉnh có mức độ cấu hình rất cao. Vật phẩm có thể được cấp khi xảy ra các sự kiện như join, first-join, respawn, world-switch, region-enter và region-leave. Plugin tập trung vào các định nghĩa vật phẩm linh hoạt (itemflags), các sự kiện kích hoạt và lệnh gắn với vật phẩm, ताकि server có thể cung cấp menu lobby, starter kit hoặc công cụ theo ngữ cảnh mà không cần mod client tuỳ chỉnh.

🎯 Mục đích

ItemJoin giải quyết vấn đề cấp cho người chơi các vật phẩm tuỳ chỉnh hoặc tương tác một cách đáng tin cậy, gắn với sự kiện và thế giới của server. Plugin hữu ích cho các server hub/lobby, server minigame, mạng survival (nơi vật phẩm phải được giới hạn theo từng world) và các mạng cần menu điều khiển bằng vật phẩm hoặc vật phẩm kích hoạt lệnh.

⚙️ Tính năng

• Cấp vật phẩm theo các trigger có thể cấu hình: join, first-join, respawn, world-switch, region-enter/exit và các sự kiện tương tự.
• itemflags riêng cho từng vật phẩm để thay đổi hành vi (slot, overwrite, quy tắc stack, chặn di chuyển/nhặt, giới hạn gamemode, xác suất nhận được, cooldowns).
• ItemCommands: gắn lệnh vào vật phẩm và cấu hình ngữ cảnh thực thi (console, player, server, message) cùng các kiểu hành động (click trái/phải, click trong inventory, physical, multi-click).
• Tích hợp PlaceholderAPI cho tên/lore vật phẩm động và hỗ trợ placeholders.
• Hỗ trợ head người chơi tuỳ chỉnh (textures và owners tuỳ chỉnh), ảnh map, tipped arrows, sách, banners, pháo hoa, tuỳ biến áo giáp da và cấp enchant tuỳ chỉnh.
• Tuỳ chọn chặn việc di chuyển vật phẩm hoặc nhặt vật phẩm trong các world cụ thể và giới hạn vật phẩm theo địa chỉ IP hoặc trạng thái first-join.
• Trình tạo GUI trong game để xây dựng bộ vật phẩm và quy trình import/creator tích hợp sẵn.
• API cho plugin khác: có tại me.RockinChaos.itemjoin.api.ItemJoinAPI.

🧩 Dành cho ai

• Chủ server cần vật phẩm lobby/hub tự động hoặc starter kit.
• Người vận hành minigame và network cần vật phẩm theo world hoặc la bàn menu.
• Nhà phát triển muốn một hệ thống vật phẩm có thể hook qua API.

🏗️ Ví dụ sử dụng

• Cấp cho người chơi một la bàn menu khi join và chạy các lệnh khác nhau khi nhấp vào.
• Cung cấp starter kit một lần khi first-join đồng thời ngăn chuyển vật phẩm giữa các world được chỉ định.
• Tạo các vật phẩm tương tác thực thi lệnh economy/shop với cooldowns và chi phí.

⌨️ Lệnh

Lưu ý: các lệnh và subcommand này được lấy từ bộ lệnh đã được tài liệu của plugin. Plugin cung cấp thêm subcommand trong wiki và phần trợ giúp được tạo tự động.

🔐 Quyền

Hành vi quyền riêng cho từng vật phẩm có thể cấu hình; việc kiểm tra quyền vật phẩm bị tắt theo mặc định và phải bật trong cấu hình plugin thì mới có hiệu lực.

⚙️ Cài đặt

📥 Thiết lập

• Tải file jar chính thức của ItemJoin và đặt vào thư mục plugins/ của server.
• Đảm bảo không có file jar ItemJoin trùng lặp trong plugins/ (ví dụ ItemJoin(1).jar).
• Khởi động lại server để plugin có thể tạo cấu hình và đăng ký các tính năng cho phiên bản server của bạn.
• Kiểm tra log console của server để xác nhận plugin đã tải và tham khảo wiki của plugin để thiết lập chi tiết.

📦 Phụ thuộc

Plugin không có yêu cầu runtime bắt buộc, nhưng có liệt kê một số soft-dependencies và tích hợp phổ biến (tuỳ chọn và sẽ bật khi có mặt):

• Vault
• AuthMe
• BetterNick
• HeadDatabase
• PlaceholderAPI
• SkinRestorerX
• TokenEnchant
• WorldEdit
• WorldGuard

Hãy bật hoặc cấu hình các tích hợp khi cần; plugin vẫn hoạt động بدون chúng, nhưng các tính năng như placeholders, head/skin tuỳ chỉnh và economy hooks phụ thuộc vào các plugin tương ứng.

🧠 Ghi chú kỹ thuật

• Nền tảng: đã xác nhận cho server kiểu Spigot (Spigot, Bukkit, Paper, Purpur, Folia).
• Phạm vi Minecraft được hỗ trợ/đã kiểm thử: từ 1.8 đến 1.21.
• Mã nguồn và các bản phát hành đã được công bố, và dự án cung cấp API tại me.RockinChaos.itemjoin.api.ItemJoinAPI để plugin khác hook vào.
• Giấy phép: LGPL-3.0.

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

Nếu bạn cần một hệ thống linh hoạt, có thể cấu hình để cung cấp cho người chơi các vật phẩm theo ngữ cảnh và tương tác (menu, starter kit, công cụ theo world) và muốn có API cho tích hợp, ItemJoin cung cấp những tính năng đó đồng thời hỗ trợ các plugin placeholder và skin phổ biến.