Plugin Minecraft InteractionVisualizer

🔌 Giới thiệu về InteractionVisualizer

InteractionVisualizer là một plugin Minecraft hiển thị các biểu diễn trực quan và hoạt ảnh ở phía client cho các khối chức năng và các thực thể liên quan (ví dụ: crafting table, furnace, enchantment table). Hiệu ứng được gửi đến người chơi qua packets và không tạo ra blocks hoặc entities ở phía server — chúng hoàn toàn là hiển thị phía client và không ảnh hưởng đến trạng thái thế giới.

🎯 Mục đích

Plugin này giúp các tương tác của người chơi với những khối chức năng thường dùng trở nên dễ thấy hơn đối với những người chơi ở gần bằng cách hiển thị item, tiến trình, holograms và hoạt ảnh khi người chơi sử dụng GUI. Nó dành cho chủ server muốn có phản hồi hình ảnh phong phú và hữu ích hơn khi người chơi tương tác với giao diện trong thế giới.

⚙️ Tính năng

• Trực quan hóa nhiều khối chức năng và các item/entity tương ứng bằng hoạt ảnh (crafting table, furnace, enchantment table và các khối khác).
• Chỉ hiển thị phía client: visuals không tạo ra entities server vĩnh viễn hoặc có thể tương tác.
• Bật/tắt hiển thị theo từng block và bật/tắt module toàn cục.
• Trạng thái bật/tắt của người chơi được lưu vào cơ sở dữ liệu (mặc định là SQLite; hỗ trợ MySQL).
• Có sẵn placeholder của PlaceholderAPI cho trạng thái bật/tắt của người chơi.
• Cung cấp developer API / wiki cho add-on.
• Nhận biết tích hợp với các plugin phổ biến để tắt hoặc điều chỉnh hoạt ảnh (vanish plugins, OpenInv, v.v.).

🧩 Dành cho ai

• Các server Survival và SMP muốn phản hồi hình ảnh sống động hơn cho tương tác với block.
• Các server trang trí/roleplay thích hiển thị phía client gọn gàng mà không thay đổi dữ liệu thế giới.
• Quản trị viên server muốn có quyền kiểm soát tùy chọn theo từng người chơi đối với hiệu ứng hình ảnh.

🏗️ Ví dụ sử dụng

• Hiển thị item xuất hiện trên crafting table khi người chơi điền các ô công thức để những người chơi gần đó thấy được tiến trình.
• Hiển thị hologram tiến trình của furnace và hình ảnh item xuất hiện khi người chơi tương tác với giao diện furnace.
• Cho phép người chơi chọn các module hiển thị mà họ muốn thấy (itemstands, dropped items, holograms).

⌨️ Lệnh

🔐 Permissions

⚙️ Cài đặt

📥 Thiết lập

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

📦 Phụ thuộc

• ProtocolLib (cần cho các phiên bản server cũ / xử lý packets ở nơi được chỉ định).
• LightAPI Fork (cần cho các phiên bản cũ khi được dùng).

Các tích hợp mềm/tùy chọn được dự án ghi chú (dùng để điều chỉnh hành vi): EssentialsX, OpenInv, PlaceholderAPI, SuperVanish, PremiumVanish, CMI.

🧾 Cấu hình

• Plugin lưu các tùy chọn bật/tắt theo từng người chơi trong SQLite theo mặc định và hỗ trợ MySQL cho lưu trữ bền vững giữa các server.
• Mỗi hiển thị block và mỗi module có thể bị vô hiệu hóa qua cấu hình plugin.

🧠 Ghi chú kỹ thuật

• Được xây dựng dựa trên API của Spigot; cũng báo tương thích với Paper và một số bản build server hiện đại.
• Các hiển thị chỉ ở phía client và không tạo ra entities server có thể bị giết hoặc tồn tại lâu dài.
• Plugin cung cấp developer API cho các add-on bên thứ ba và bản dịch do cộng đồng duy trì.
• Dự án nêu một hạn chế: có thể không hoạt động trên Minecraft 1.10.2 hoặc thấp hơn.

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

Nếu bạn muốn phản hồi hình ảnh nhẹ nhàng, mang tính trang trí cho tương tác của người chơi mà không thay đổi trạng thái phía server, InteractionVisualizer cung cấp hoạt ảnh dựa trên packets và điều khiển theo từng người chơi để tăng độ nhập vai trong khi vẫn giữ nguyên thế giới.