💎 CrystalGuard

CrystalGuard là plugin bảo vệ server Minecraft (Spigot / Paper / Purpur / Folia 1.20+) chống lại việc lạm dụng Tinh Thể End (End Crystal) và Neo Hồi Sinh (Respawn Anchor) làm vũ khí PvP gây nổ sát thương lớn (Crystal PvP).

---

✨ Tính Năng Nổi Bật

🛡️ Bảo Vệ Vụ Nổ (Explosion Protection)

• Vụ Nổ Tinh Thể End: Tùy chỉnh hoặc triệt hạ hoàn toàn sát thương từ nổ End Crystal (mặc định: 0.0).
• Vụ Nổ Neo Hồi Sinh: Kiểm soát sát thương nổ Respawn Anchor khi đặt sai chiều không gian ngoài Nether.
• Bảo Vệ Địa Hình (Terrain Protection): Ngăn nổ phá hủy block, rương đồ, redstone, quặng, công trình.
• Tương Thích Triệu Hồi Rồng (Dragon Respawn Support): Tự động cho phép nổ End Crystal khi làm lễ triệu hồi Rồng Ender ở thế giới The End.

🚫 Chặn Tương Tác & Chống Exploit (Interaction & Anti-Exploit)

• Chặn Đặt & Phá Hủy: Cấu hình độc lập việc chặn đặt hoặc chặn kích nổ End Crystal / Respawn Anchor.
• Xử Lý NMS & Velocity Mượt Mà:
  • Hủy block ảo qua NMS Packet trực tiếp không giật camera.
  • Chống exploit spam nhảy đặt bằng cơ chế hạ vận tốc (Velocity knockdown Y = -0.5), không bị lơ lửng hay giật lag góc nhìn.

🛠️ Chặn Chế Tạo & Sở Hữu (Craft & Inventory Protection)

• Chặn Craft Vật Phẩm: Vô hiệu hóa công thức chế tạo End Crystal hoặc Respawn Anchor (tương thích Bàn chế tạo và khối Crafter tự động 1.21+).
• Chặn Sở Hữu (Possession Control): Tự động xóa vật phẩm cấm trong túi đồ khi người chơi nhặt, di chuyển trong rương hoặc vừa tham gia máy chủ.

🗡️ Cooldown Đòn Lướt Spear (Spear Lunge Cooldown)

• Hỗ trợ thời gian hồi đòn lướt của ngọn giáo Spear trên các bản Paper 1.21.11+.

⚡ Tương Thích Folia 100%

• Hỗ trợ kiến trúc đa luồng Region-threading của Folia thông qua FoliaEntityScheduler, teleportAsync và NMS async packet.

---

📜 Lệnh & Quyền Hạn (Commands & Permissions)

Lệnh	Alias	Mô tả	Quyền hạn
/crystalguard reload	/cg reload	Tải lại cấu hình config.yml và messages.yml	crystalguard.admin

Quyền Hạn (Permissions):

• crystalguard.admin: Quyền quản trị plugin (mặc định: OP).
• crystalguard.bypass: Quyền bỏ qua tất cả các cơ chế bảo vệ của CrystalGuard.

---

⚙️ Cấu Hình (Configuration)

Tất cả cấu hình chính nằm trong config.yml, thông báo tùy chỉnh trong messages.yml.

• Whitelist Worlds: Danh sách thế giới ngoại lệ cho phép dùng Crystal PvP bình thường.
• Actionbar & Chat Messages: Tùy chỉnh linh hoạt kênh gửi thông báo tới người chơi khi bị chặn.

---

🛠️ Biên Dịch & Đóng Gói (Build)

Yêu cầu:

• JDK 21+
• Gradle 8+

Lệnh Biên Dịch:

# Build chuẩn Gradle:
./gradlew build

# Hoặc đóng gói & mã hóa obfuscate (Windows):
powershell -ExecutionPolicy Bypass -File .\build-obfuscated.ps1

---

📄 License & Author

Được phát triển bởi OmhVN.