Discord Fantastic V6 RPG Levelin - Endless LVL

# DiscordFantastic V4 Update

DiscordFantastic V4 adds automatic **LuckPerms to Discord Role Sync**.

This update connects your in-game ranks with your Discord roles, making server management easier and more automated.

---

## New in V4

### LuckPerms Role Sync

Players can now automatically receive Discord roles based on their LuckPerms groups.

Example:

```text
LuckPerms group: vip
Discord role: VIP

or:

LuckPerms group: admin
Discord role: Admin

If the group and role names match, DiscordFantastic can sync them automatically.

How it works

When a player joins the server or uses the sync command, DiscordFantastic checks the player's LuckPerms groups and searches for matching Discord roles.

If a matching role is found, the bot gives that role to the linked Discord user.

Example Config

RoleSync:
  Enabled: true
  AutoNameMatch: true
  SyncOnJoin: true
  SlashCommand: true
  CommandName: "syncroles"
  DiscordRolePrefix: ""
  LuckPermsGroupPrefix: ""
  IgnoreCase: true
  RemoveOldPrefixedRoles: false
  IgnoredGroups: "default"

Prefix Example

Some servers use LuckPerms group prefixes like:

b.pionier

But the Discord role is only called:

Pionier

In that case, use:

LuckPermsGroupPrefix: "b."

Then DiscordFantastic will match:

b.pionier -> Pionier

Discord Requirements

The Discord bot needs:

Manage Roles

The bot role must also be placed above the roles it should assign.

If the bot role is below the target role, Discord will block the sync.

Use Cases

This is useful for:

• VIP roles
• Supporter roles
• Pioneer or founder roles
• Team roles
• Tester roles
• Server rank channels
• Discord-only areas based on in-game ranks

Notes

The automatic sync works best when the Discord role name matches the LuckPerms group name.

Example:

LuckPerms group: vip
Discord role: VIP

With IgnoreCase: true, uppercase and lowercase differences do not matter.

Existing Features

DiscordFantastic also includes:

• Hytale chat to Discord
• Discord chat to Hytale
• Join and leave messages
• Server start and stop messages
• Death messages
• Webhook support
• Player avatar thumbnails
• EndlessLeveling level and prestige display
• /players command
• Bot activity/status system

Security Reminder

Never share your Discord bot token or webhook URL publicly.

If you accidentally shared them, reset your bot token and create a new webhook.