Plugin Minecraft SimpleTpa

🔌 Giới thiệu về SimpleTPA

SimpleTPA là một plugin Minecraft cung cấp hệ thống yêu cầu dịch chuyển (TPA) đơn giản cho server. Plugin cho phép người chơi gửi yêu cầu dịch chuyển đến người chơi khác, chấp nhận hoặc từ chối yêu cầu đến, hủy yêu cầu đã gửi, và chặn yêu cầu đến bằng một nút bật/tắt. Plugin tập trung vào quy trình làm việc gọn nhẹ, có thể cấu hình cho yêu cầu dịch chuyển trong game và cấu hình phía server.

🎯 Mục đích

SimpleTPA giải quyết nhu cầu phổ biến về dịch chuyển có kiểm soát giữa người chơi trên server nhiều người. Nó ngăn spam bằng cooldown và quy tắc chỉ một yêu cầu đang chờ, hỗ trợ warmup/trễ trước khi dịch chuyển, và cho quản trị viên server các thiết lập có thể cấu hình cho thời gian chờ, âm thanh và ghi log.

⚙️ Tính năng

• Yêu cầu dịch chuyển giữa người chơi qua /tpa và yêu cầu ngược qua /tpahere.
• Các thao tác chấp nhận, từ chối và hủy yêu cầu (/tpaccept, /tpdeny, /tpacancel).
• Bật hoặc tắt nhận yêu cầu bằng /tpatoggle.
• Timeout yêu cầu có thể cấu hình (mặc định hiển thị là 60 giây).
• Cooldown có thể cấu hình giữa các lần gửi yêu cầu để giảm spam.
• Warmup/trễ dịch chuyển với đếm ngược ở action bar và hủy khi di chuyển hoặc bị sát thương.
• Chỉ một yêu cầu đang chờ cho mỗi người chơi để tránh chồng lấn yêu cầu.
• Hiệu ứng âm thanh có thể tùy chỉnh cho yêu cầu, chấp nhận, từ chối và dịch chuyển thành công.
• Hỗ trợ đầy đủ mã màu cho tin nhắn và tùy chọn ghi log chi tiết cho admin.

🧩 Dành cho ai

• Các server Survival/SMP nhỏ và vừa muốn một hệ thống TPA nhẹ.
• Các server thích hành vi yêu cầu dịch chuyển tối giản, có thể cấu hình thay vì một bộ dịch chuyển lớn hơn.
• Quản trị viên muốn cấu hình riêng cho từng server về cooldown, warmup và ghi log.

🏗️ Ví dụ sử dụng

• Một người chơi dùng /tpa để yêu cầu dịch chuyển đến bạn bè; người bạn chấp nhận bằng /tpaccept và plugin áp dụng warmup đã cấu hình trước khi dịch chuyển.
• Nhân viên server bật /tpatoggle cho thành viên staff để chặn các yêu cầu dịch chuyển ngẫu nhiên trong sự kiện hoặc khi làm nhiệm vụ kiểm duyệt.
• Admin đặt cooldown để ngăn người chơi spam yêu cầu dịch chuyển.

⌨️ Lệnh

🔐 Quyền

⚙️ Cài đặt

📥 Thiết lập

• Tải JAR của plugin từ trang tài nguyên chính thức của plugin.
• Đặt file .jar đã tải vào thư mục plugins/ của server Spigot.
• Khởi động lại server và kiểm tra console để xem thông báo tải plugin.

📦 Phụ thuộc

• Không có phụ thuộc bắt buộc nào được ghi nhận.

🧾 Cấu hình

• Plugin sử dụng một file cấu hình (được ghi là config.yml trên trang tài nguyên của plugin). Khi nâng cấp qua các phiên bản lớn, tác giả khuyến nghị xóa config.yml hiện có trước khi khởi động lại để các khóa mặc định mới được áp dụng.
• Các tùy chọn cấu hình gồm timeout yêu cầu, cooldown, warmup dịch chuyển, hủy khi di chuyển/bị sát thương, cài đặt âm thanh, mã màu tin nhắn và tùy chọn ghi log.

🧠 Ghi chú kỹ thuật

• Các phiên bản Minecraft được xác nhận hỗ trợ (theo trang tài nguyên của plugin): 1.19, 1.20, 1.20.6 và 1.21.
• Nền tảng được xác nhận: Spigot.
• Plugin triển khai timeouts, cooldowns và cơ chế warmup phía server, đồng thời tự động dọn dẹp các yêu cầu đã hết hạn.

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

SimpleTPA hữu ích khi bạn cần một hệ thống yêu cầu dịch chuyển tập trung, có thể cấu hình mà không cần thêm một bộ teleportation/homes đầy đủ. Nó phù hợp với các server muốn quy trình /tpa đơn giản, cooldown để tránh spam và hành vi warmup để dịch chuyển an toàn hơn.