Plugin Minecraft TitleManager

🔌 Giới thiệu TitleManager

TitleManager là một plugin Minecraft quản lý các phần trình bày hiển thị cho người chơi: tiêu đề và phụ đề ở giữa màn hình có hiệu ứng, actionbar, header và footer của tab-list có hiệu ứng, cùng sidebar scoreboard có thể cấu hình. Nó hoạt động như một lớp trình bày cho các server muốn có thông báo vào server, thông báo chung và hiển thị tab/scoreboard trực quan hơn.

🎯 Mục đích

Plugin này tập trung các tính năng hiển thị (titles, actionbar, tab-list, sidebars) lại một nơi để chủ server có thể ارائه thông tin nhất quán, có hiệu ứng và dùng placeholder cho người chơi mà không cần tự viết code. Nó dành cho quản trị viên server muốn quản lý thông báo join/welcome, các announcement luân phiên, và giao diện TAB/scoreboard động.

⚙️ Tính năng

• Titles và actionbar cho join và first join có thể cấu hình, kèm tùy chọn thời gian và biến thể.
• Header và footer của tab-list có hiệu ứng và hỗ trợ gradient, với placeholder cho số người online, thời gian thế giới/server và các giá trị động khác.
• Sidebar scoreboard có thể cấu hình với tối đa 15 dòng có hiệu ứng, dựa trên hệ thống scoreboard của server.
• Broadcast và các announcement theo lịch được gửi dưới dạng titles hoặc actionbar.
• Bộ máy hiệu ứng với các file animation có thể dùng lại và bản xem trước (animation playground có trong tài liệu chính thức).
• Tích hợp placeholder (placeholder tích hợp sẵn của TitleManager và hỗ trợ các hệ thống placeholder bên ngoài nếu có).
• Reload dạng giao dịch: việc tải lại cấu hình được áp dụng an toàn và có thể hoàn tác nếu config mới không hợp lệ.
• Một API nhỏ dành cho nhà phát triển để tích hợp tùy chọn và sử dụng giữa các plugin.

🧩 Dành cho ai

• Các server Survival và SMP muốn giao diện join/announcement đẹp hơn.
• Các server dùng placeholder và tích hợp bên ngoài (cho giá trị động trong phần hiển thị).
• Quản trị viên cần tab và scoreboard có hiệu ứng mà không phải viết plugin riêng.
• Nhà phát triển muốn tích hợp tính năng trình bày vào plugin khác qua API được cung cấp.

🏗️ Ví dụ sử dụng

• Hiển thị title chào mừng và actionbar có hiệu ứng khi người chơi vào server, với thông báo khác khi first join.
• Giữ tab player list sinh động bằng cách hiển thị thời gian server, số người online và header/footer gradient.
• Luân phiên các title hoặc actionbar announcement có hiệu ứng theo lịch để thông báo sự kiện hoặc nội quy.
• Dùng sidebar scoreboard để hiển thị bảng xếp hạng, thống kê hoặc thông tin server động.

⌨️ Lệnh

Lưu ý: các lệnh ở trên được dự án tài liệu hóa. Các node quyền cụ thể không được liệt kê trong nguồn dùng ở đây và nên xem trong tài liệu của plugin để biết chính xác node và giá trị mặc định.

⚙️ Cài đặt

📥 Thiết lập

• Tải file JAR của plugin từ bản phát hành của dự án hoặc trang tài nguyên của plugin.
• Đặt JAR vào thư mục plugins/ của server.
• Khởi động lại server.
• Chỉnh sửa các file config được tạo trong plugins/TitleManager/ để điều chỉnh titles, animations và cài đặt player-list.
• Dùng /tm reload để áp dụng thay đổi cấu hình; plugin thực hiện reload theo kiểu giao dịch để tránh áp dụng config bị lỗi.

📦 Phụ thuộc

• PlaceholderAPI (tích hợp tùy chọn cho placeholder bên ngoài).
• Vault (tùy chọn, dùng cho giá trị placeholder khi có sẵn).
• BungeeCord (hành vi nhận biết tích hợp khi dùng trong thiết lập proxy).

Các tích hợp này là tùy chọn và được dùng khi có; plugin vẫn chạy بدون chúng nhưng có thể dùng dữ liệu của chúng khi उपलब्ध.

🧠 Ghi chú kỹ thuật

• Mục tiêu runtime chính thức bao gồm Minecraft 1.8 đến 1.21.x (tài liệu dự án có nhắc hỗ trợ rõ ràng đến 1.21.11). Hành vi thay đổi theo phiên bản server: các phiên bản Minecraft mới dùng API Bukkit/Paper hiện đại, còn các phiên bản cũ dựa vào các mô-đun tương thích theo từng phiên bản.
• TitleManager công bố một API nhỏ dành cho Bukkit cho các tích hợp tùy chọn và cung cấp tài liệu API được tạo tự động.
• Có các lệnh safe reload và diagnostics để hỗ trợ xử lý sự cố cấu hình và runtime.

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

Nếu bạn muốn điều khiển phần trình bày tập trung, có hiệu ứng và dùng placeholder (titles, actionbar, tab-list và sidebars) được quản lý từ cấu hình thay vì viết mã riêng, TitleManager cung cấp một plugin và API có tài liệu để hiển thị các phần UI đó một cách nhất quán trên toàn bộ môi trường server của bạn.