Discord Role Manager keeps your members' Discord roles in sync with what they
actually have on your Pterodactyl panel. You write the rules, the addon assigns
the roles, automatically and on a schedule.
Reward paying customers, tag users by the node or plan they are on, give a role
to anyone running a certain egg. It all updates on its own as servers are
created, suspended or removed.
What it does
- You create rules that match a user's servers: node, egg, nest, server count, total resources, suspension state.
- Every rule that matches grants one or more Discord roles to that user.
- A background sync keeps everyone up to date on an interval you set, and you can also run it on demand.
- Members link their own Discord account from their panel account page with a Sign in with Discord button.
Rule match types
- node_id and node_in: user has a server on a specific node, or any of several nodes.
- node_name_regex: node name matches a pattern, for example every node starting with "Paid".
- egg_id, egg_in, nest_id, nest_in: user runs a specific egg or nest, or any of several.
- server_count_gte: user has at least N servers.
- total_memory_gte, total_disk_gte, total_cpu_gte: the sum of the user's server limits reaches a threshold.
- not_suspended: user has at least one active server.
Rules stack. Every matching rule adds its roles, and the addon only ever touches
roles that appear in a rule, so roles you hand out manually in Discord are left
alone. There is no limit on the number of rules.
Features
- Rule-based, fully automatic Discord role assignment.
- Multiple roles per rule, unlimited rules.
- Self-service account linking through Discord OAuth2.
- Configurable sync interval, plus a Run Sync Now button and a CLI command.
- Everything managed from one page in the admin panel.
- Bot token and OAuth secret are stored encrypted in the database.
Requirements
- Pterodactyl Panel 1.11.x and 1.12.x
- A free Discord bot with the Manage Roles permission and the Server Members
Intent enabled. You create it at https://discord.com/developers/applications
and the included INSTALL.txt has the full step by step.
- yarn and node, to rebuild the panel frontend during install, since the addon
adds a page to the account area.
Installation
One automatic installer. It backs up every file it touches before changing
anything, writes a one-command rollback script, runs the database migrations,
rebuilds the frontend and self-tests the result. A full INSTALL.txt with manual
steps and an uninstaller are included in the package.
Support
Telegram @FangerST. Include the addon version and the relevant lines from your
panel log when you message.
actually have on your Pterodactyl panel. You write the rules, the addon assigns
the roles, automatically and on a schedule.
Reward paying customers, tag users by the node or plan they are on, give a role
to anyone running a certain egg. It all updates on its own as servers are
created, suspended or removed.
What it does
- You create rules that match a user's servers: node, egg, nest, server count, total resources, suspension state.
- Every rule that matches grants one or more Discord roles to that user.
- A background sync keeps everyone up to date on an interval you set, and you can also run it on demand.
- Members link their own Discord account from their panel account page with a Sign in with Discord button.
Rule match types
- node_id and node_in: user has a server on a specific node, or any of several nodes.
- node_name_regex: node name matches a pattern, for example every node starting with "Paid".
- egg_id, egg_in, nest_id, nest_in: user runs a specific egg or nest, or any of several.
- server_count_gte: user has at least N servers.
- total_memory_gte, total_disk_gte, total_cpu_gte: the sum of the user's server limits reaches a threshold.
- not_suspended: user has at least one active server.
Rules stack. Every matching rule adds its roles, and the addon only ever touches
roles that appear in a rule, so roles you hand out manually in Discord are left
alone. There is no limit on the number of rules.
Features
- Rule-based, fully automatic Discord role assignment.
- Multiple roles per rule, unlimited rules.
- Self-service account linking through Discord OAuth2.
- Configurable sync interval, plus a Run Sync Now button and a CLI command.
- Everything managed from one page in the admin panel.
- Bot token and OAuth secret are stored encrypted in the database.
Requirements
- Pterodactyl Panel 1.11.x and 1.12.x
- A free Discord bot with the Manage Roles permission and the Server Members
Intent enabled. You create it at https://discord.com/developers/applications
and the included INSTALL.txt has the full step by step.
- yarn and node, to rebuild the panel frontend during install, since the addon
adds a page to the account area.
Installation
One automatic installer. It backs up every file it touches before changing
anything, writes a one-command rollback script, runs the database migrations,
rebuilds the frontend and self-tests the result. A full INSTALL.txt with manual
steps and an uninstaller are included in the package.
Support
Telegram @FangerST. Include the addon version and the relevant lines from your
panel log when you message.
