Plugin Minecraft InteractiveChat

🔌 Về InteractiveChat

InteractiveChat là một plugin Minecraft giúp cải thiện chat trong game bằng cách thay thế tên người chơi và từ khóa thông thường bằng nội dung tương tác (thông báo khi rê chuột, hành động khi nhấp chuột), đồng thời cho phép người chơi hiển thị vật phẩm, túi đồ và ender chest trực tiếp trong chat. Plugin được thiết kế để hoạt động bên trên các plugin định dạng chat hiện có bằng cách chỉnh sửa packet thay vì thay thế hệ thống chat.

🎯 Mục đích

InteractiveChat giải quyết vấn đề của chat tĩnh chỉ có văn bản bằng cách thêm các phần tử tương tác và placeholder phong phú, để người chơi có thể chia sẻ chi tiết vật phẩm/công cụ và nội dung túi đồ với tương tác hover và click. Nó cũng hỗ trợ chức năng liên server trên các mạng proxy, cho phép các tính năng chat tương tác hoạt động trên nhiều backend server.

⚙️ Tính năng

• Thay thế tên người chơi trong chat bằng nội dung tương tác hover/click.
• Hiển thị xem trước vật phẩm đang cầm trong chat bằng một từ khóa (ví dụ: [item]).
• Hiển thị nội dung túi đồ của người chơi trong chat bằng một từ khóa (ví dụ: [inv]) và chọn bố cục hiển thị.
• Hiển thị nội dung ender chest trong chat bằng một từ khóa (ví dụ: [ender]).
• Tạo từ khóa/placeholder tương tác tùy chỉnh để dùng trong chat.
• Gọi tên người chơi với thông báo tùy chọn (âm thanh, title, action bar, boss bar) khi phiên bản server hỗ trợ.
• Hỗ trợ liên server cho BungeeCord và Velocity khi được cấu hình trên proxy và backend.
• Hỗ trợ placeholder của PlaceholderAPI và tích hợp với việc dịch tên vật liệu vật phẩm sang ngôn ngữ của client.
• Mã màu RGB và hỗ trợ font tùy chỉnh cho tin nhắn trên các server hỗ trợ chúng (các tính năng RGB cần 1.16+).

🧩 Dành cho ai

• Quản trị viên server muốn có tương tác chat phong phú hơn và nội dung hover/click được.
• Các network dùng proxy (BungeeCord/Velocity) cần chat tương tác trên nhiều backend server.
• Các cộng đồng muốn người chơi khoe vật phẩm hoặc túi đồ trong chat mà không cần mod ngoài.

🏗️ Ví dụ sử dụng

• Một người chơi gõ [item] trong chat toàn server để hiện tooltip tương tác của vật phẩm đang cầm cho người khác xem.
• Một moderator gửi tin nhắn chat được định dạng bằng placeholder và xem trước túi đồ ngay trong dòng để hỗ trợ hoặc kiểm tra.
• Một network proxy bật plugin trên proxy và backend để mention và placeholder hoạt động xuyên server.

⌨️ Lệnh

Lưu ý: chỉ những lệnh được nguồn chính thức liệt kê rõ ràng mới xuất hiện ở trên. Các node permission được đưa vào khi plugin có tài liệu; nếu không, cột permission sẽ hiển thị "không xác định".

🔐 Permissions

(Chỉ các node permission được nêu rõ trong tài liệu chính thức của plugin mới được liệt kê ở trên.)

⚙️ Cài đặt

📥 Thiết lập

• Tải file JAR chính thức của plugin và các plugin phụ thuộc cần thiết.
• Đặt InteractiveChat.jar (và các file JAR phụ thuộc) vào thư mục plugins/ của server.
• Khởi động server.
• Chỉnh cấu hình plugin nếu cần và khởi động lại server để áp dụng thay đổi.

📦 Phụ thuộc

Các phụ thuộc đã xác nhận cần có trên backend server (Spigot/Paper/etc.):

• ProtocolLib (hoặc) PacketEvents (+ module packet liên quan)
• PlaceholderAPI
• Vault

Lưu ý: các phụ thuộc không cần trên phần mềm proxy; nếu bạn định dùng plugin với BungeeCord hoặc Velocity, hãy cài InteractiveChat trên cả proxy lẫn backend server và bật tùy chọn proxy/bungeecord trong cấu hình InteractiveChat trên từng backend server.

🧠 Ghi chú kỹ thuật

• Plugin chỉnh sửa chat ở cấp packet; cần một thư viện packet (ProtocolLib hoặc PacketEvents) để chặn/chỉnh sửa tin nhắn trên backend server.
• Hỗ trợ proxy: BungeeCord và Velocity được hỗ trợ; để bật placeholder và mention xuyên server, plugin phải được cài trên proxy và tất cả backend server, đồng thời bật tùy chọn bungeecord trong cấu hình của từng backend.
• PlaceholderAPI được dùng để xử lý placeholder và cần cài riêng các expansion cần thiết để placeholder hoạt động.
• Tên vật liệu của vật phẩm sẽ được dịch sang ngôn ngữ client của từng người chơi khi áp dụng.
• Mã màu RGB và thẻ font tùy chỉnh được hỗ trợ trên các server/client có hỗ trợ tính năng này (hành vi RGB cần hỗ trợ từ server/client, thường có sẵn từ 1.16+).

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

Nếu bạn muốn thêm xem trước vật phẩm/công cụ có thể kiểm tra, chia sẻ túi đồ, từ khóa chat có thể nhấp và các tính năng chat tương tác xuyên server trong khi vẫn giữ plugin định dạng chat hiện tại, InteractiveChat cung cấp tích hợp ở cấp packet, chồng nội dung tương tác lên trên hệ thống chat tiêu chuẩn.