HonHoan - Soul Ring RPG

Requirements
• Software: Spigot / Paper / Purpur
• Version: 1.20.x - 1.21.x (or newer)
• Java: 21+
• Optional: LevelledMobs, PlaceholderAPI, WorldGuard, Vault

️Installation Guide
IMPORTANT: This system uses a License Key. The installation requires 2 steps:
1. The first time you drop the plugin into plugins/ and start the server, it will throw an error in the console and disable itself. Don't worry, this is a security feature! It will generate a folder at plugins/HonHoan/.
2. Open the plugins/HonHoan/key.yml file and paste your purchased License Key. Restart your server (or reload), and the plugin will verify your key and run perfectly!

Soul Ring System
Kill mobs to drop Soul Rings on the ground, stand near them to absorb (5s), and each ring grants a unique Soul Skill. Stronger mobs drop higher-tier rings (White → Red). Absorb duplicates to level skills up.


⚔️42 Unique Soul Skills
Active (AoE, blink, fireballs, sonic wave, flight…) + Passive (crit, lifesteal, reflect, auto-revive…). Each scales with ring tier + level.


Spirit Bones
6 body slots × 4 qualities. Passives apply real stat bonuses (armor, damage, attack/move speed, mana regen). Each has an active skill.


10 Ranks & Soul Power
Climb ranks for chat prefix and level-up broadcast. Live Soul Power (mana) action-bar and auto-regen.


️Full GUI Menus
Main menu, rings, skills, bones, profile, and leaderboard management.

Controls
• Sneak + Right-Click — cast the Soul Skill bound to your held hotbar slot ( /hh bind).
• Sneak + F — activate the Spirit Bone bound to your slot ( /hh bindbone).

⌨️Commands & Permissions
Player Commands:
• /hh or /honhoan — Open Main Menu
• /hh rings — View your Soul Rings
• /hh skills — View your Soul Skills
• /hh bones — View your Spirit Bones
• /hh profile — View your Player Profile
• /hh top — View Leaderboard
• /hh bind — Bind active skill to hotbar
• /hh bindbone — Bind active bone to hotbar
• /hh show — Toggle skill action bar
Admin Commands:
• /hh admin — Open Admin Menu (give/drop/reload/reset)

Permissions:
• honhoan.use — Access player commands & absorb rings (Default: everyone)
• honhoan.admin — Access admin commands (Default: OP)


Hệ Thống Hồn Hoàn
Giết quái để Hồn Hoàn rơi ra đất, đứng gần hấp thu 5 giây, mỗi vòng cho một Hồn Kỹ riêng. Quái càng mạnh rơi vòng bậc cao hơn (Trắng → Đỏ). Hấp thu trùng loại để nâng cấp kỹ năng

⚔️42 Hồn Kỹ Đa Dạng
Chủ động (AoE, dịch chuyển, cầu lửa, sóng âm, bay…) + Bị động (chí mạng, hút máu, phản damage, hồi sinh…). Sức mạnh tăng theo bậc vòng + level.

Hệ Thống Hồn Cốt
6 vị trí Hồn Cốt với 4 mức chất lượng. Trang bị để tăng thẳng chỉ số thật cho nhân vật (giáp, sát thương, tốc độ, hồi mana). Mỗi cốt còn đem lại 1 kỹ năng chủ động độc quyền.


10 Cấp Bậc Hồn Sư & Hồn Lực
Leo rank để lấy prefix chat, thông báo toàn server khi thăng cấp. Thanh Hồn Lực (Mana) hiển thị trực tiếp trên Action Bar realtime.


️Giao Diện Đầy Đủ (GUI)
Mọi tính năng đều thao tác qua Menu hiện đại: quản lý vòng, kỹ năng, cốt, hồ sơ cá nhân và bảng xếp hạng.

Điều khiển
• Sneak + Chuột phải — dùng Hồn Kỹ đã bind ở hotbar slot đang cầm ( /hh bind).
• Sneak + F — kích hoạt Hồn Cốt đã bind ( /hh bindbone).

⌨️ Lệnh & Quyền
Lệnh Người Chơi:
• /hh hoặc /honhoan — Mở Menu Chính
• /hh rings — Xem danh sách Hồn Hoàn
• /hh skills — Xem danh sách Hồn Kỹ
• /hh bones — Xem danh sách Hồn Cốt
• /hh profile — Xem Hồ Sơ Người Chơi
• /hh top — Xem Bảng Xếp Hạng
• /hh bind — Gắn Kỹ Năng vào thanh công cụ
• /hh bindbone — Gắn Hồn Cốt vào thanh công cụ
• /hh show — Bật/tắt thanh trạng thái kỹ năng

Lệnh Quản Trị (Admin):
• /hh admin — Lệnh Admin (give/drop/reload/reset)
Quyền (Permissions):
• honhoan.use — Quyền dùng lệnh cơ bản và hấp thụ vòng (Mặc định: mọi người)
• honhoan.admin — Quyền dùng lệnh Admin (Mặc định: OP)