The Legacy Voyage

Installation

Install HyDiscordRanksX + dependencies, then configure role→group mappings.

Back to HyDiscordRanksX Wiki
Table of Contents
Jump to a section
Wiki Home
📌 Overview
What it is, features, and goals
 › 🧰 Installation
Install steps + recommended setup
 › ⌨️ Commands
Command list + examples
 › 🔐 Permissions
Permission nodes and rank setup
 › ⚙️ Configurations
Config options and details
 › 🎓 Tutorials
Common setups and how-to guides
 › 👤 Author & Support
Contact, bugs, feedback, links
 ›
Install Guide
Get role syncing running in minutes.
Filters across installation sections. Use copy buttons for paths and keys.
Tip: search "cooldown", "tpa", "warp", "mute", "custom." Copy buttons use your clipboard
✅ Prerequisites
HyDiscordRanksX requires both HyDiscordX and LuckPerms.
Requirement Description Notes
HyDiscordX Account linking is required. Links stored in: mods/HyDiscordX/links.json Copy
LuckPerms Group/rank management backend. Ensure LuckPerms is installed and working before adding HyDiscordRanksX.
📦 Install Steps
  1. Place the HyDiscordRanksX mod/plugin into your server’s mods folder (same place you install other mods).
  2. Start the server once to auto-generate the config file.
  3. Open: mods/hydiscordranks/config.json Copy
  4. Fill in your Discord BotToken and GuildId, then add role→group mappings.
  5. Reload in-game: /hydiscordranksx reload Copy
  6. Optional: force a sync immediately: /hydiscordranksx forcesync Copy
🧠 Tips
  • Enable Discord Developer Mode to copy role IDs easily.
  • LuckPerms group names must match exactly (case-sensitive depending on your setup).