Plugin Minecraft NPC

🔌 Giới thiệu về NPC

NPC là một plugin Minecraft dành cho máy chủ Spigot, cho phép quản trị viên tạo các NPC đơn giản và tồn tại lâu dài. Mỗi NPC có thể sao chép skin của người chơi hoặc dùng skin dựa trên entity, được lưu xuống đĩa để vẫn tồn tại sau khi máy chủ khởi động lại, và hiển thị một thông báo có thể cấu hình khi người chơi tương tác với nó.

🎯 Mục đích

Plugin này cung cấp một cách nhẹ nhàng để đặt các NPC trang trí hoặc tương tác trong thế giới máy chủ, phục vụ cho dấu hiệu staff, bộ chọn lobby, người bán hàng tĩnh, hoặc các tương tác đơn giản khác khi không cần đến những framework NPC đầy đủ tính năng.

⚙️ Tính năng

• Tạo NPC mặc định sao chép skin của người chơi đã tạo nó.
• Có tùy chọn chỉ định entity hoặc tên skin để thay đổi ngoại hình NPC.
• NPC vẫn tồn tại sau khi máy chủ khởi động lại nhờ lưu vị trí và dữ liệu skin vào tệp data.yml.
• Mỗi NPC có thể hiển thị thông báo riêng khi được nhấp.
• Các lệnh tạo và xóa cơ bản cho quản trị trong game.
• Plugin lưu dữ liệu trong thư mục plugin (NpcMain) và tạo data.yml ở lần chạy đầu tiên.
• Các phiên bản do tác giả cung cấp nhắm tới các bản phát hành Minecraft/Spigot cụ thể (mỗi phiên bản server được hỗ trợ có một file jar riêng).

🧩 Dành cho ai

Plugin này hướng đến các quản trị viên máy chủ Spigot quy mô nhỏ đến trung bình cần các NPC đơn giản, tồn tại lâu dài mà không cần sự phức tạp của những framework NPC lớn hơn. Nó phù hợp cho máy chủ lobby hoặc survival cần các NPC tĩnh để hiển thị thông báo hoặc làm điểm nhấn trang trí.

🏗️ Ví dụ sử dụng

• Đặt một NPC tại spawn để hiển thị luật máy chủ khi nhấp vào.
• Tạo một bức tượng trang trí có skin giống một thành viên staff.
• Dùng NPC làm các bộ chọn có tên và có thể nhấp trong lobby để mở menu (qua thông báo NPC hoặc kết hợp với các plugin khác).

⌨️ Lệnh

(Các lệnh trên được mô tả trong tài nguyên chính thức của plugin.)

⚙️ Cài đặt

📥 Thiết lập

• Tải xuống file jar plugin phù hợp với phiên bản máy chủ Spigot của bạn.
• Đặt file jar vào thư mục plugins/ của máy chủ.
• Khởi động hoặc khởi động lại máy chủ.
• Ở lần tải đầu tiên, plugin sẽ tạo một thư mục plugin (NpcMain) và một tệp data.yml để lưu các mục NPC.

📦 Phụ thuộc

• Tác giả không ghi nhận phụ thuộc bắt buộc nào.

🧾 Cấu hình

• Dữ liệu NPC (vị trí, tên, skin signatures, thông báo) được lưu trong data.yml bên trong thư mục plugin.
• Việc chỉnh sửa data.yml cho phép đổi tên hoặc thay đổi thông báo của NPC; cần khởi động lại máy chủ để tải các thay đổi thủ công.

🧠 Ghi chú kỹ thuật

• Tác giả phát hành các bản build riêng cho những phiên bản Spigot/Minecraft cụ thể; bản build hiện tại của repository nhắm tới Spigot 1.18.2 và ghi chú dự án cho biết các phiên bản không tương thích ngược giữa các bản phát hành máy chủ lớn.
• Repository của dự án được cấp phép theo giấy phép MIT.
• Plugin có bao gồm số liệu sử dụng (bStats) như được thể hiện bởi repository và metadata của tài nguyên.

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

Nếu bạn cần các NPC đơn giản, tồn tại lâu dài, hiển thị thông báo hoặc đóng vai trò dấu hiệu trang trí/staff mà không muốn dùng một framework NPC lớn hơn, plugin này cung cấp một giải pháp nhỏ gọn, theo từng phiên bản cho máy chủ Spigot.