Role Management Features
Self-Assignable Ranks
Ranks allow members to self-assign roles, creating interactive role selection systems with buttons or dropdown menus.
Use Cases:
- Pronoun roles
- Game/interest roles
- Notification opt-in roles
- Color roles
- Regional roles
Reaction Roles
Assign roles automatically when members react to messages with specific emojis.- Create an announcement or welcome message
- Run
/reactionrole @Role - React to the message with your chosen emoji
- Confirm the setup
- Members automatically get the role when they react
Role Persistence
Ensure members keep specific roles even if they leave and rejoin your server.- src/commands/Premium/rolepersist.ts:98-99
- Roles are automatically reapplied on rejoin
- Add multiple persistent roles per member
- View member’s moderation history after persisting roles
Voice Channel Roles
Automatically assign roles to members when they join specific voice channels.- Role added immediately when member joins the voice channel
- Role removed immediately when member leaves the voice channel
- Works with both voice channels and stage channels
- Existing members in the channel get the role when configured
- Staff meeting rooms (auto-assign “In Meeting” role)
- Streaming channels (auto-assign “Live” role)
- Gaming lobbies (auto-assign game-specific roles)
- Study/focus rooms (auto-assign “Do Not Disturb” role)
Invite Roles
Automatically assign roles to members who join through specific invite links.Only server invites work - you cannot use invites from other servers.
- Partner roles for members from partner servers
- Event attendee roles
- Special access for promoted invites
- Tracking member sources
Server Identity Features
Custom Bot Identity
Personalize Fire’s appearance in your server with custom nickname, avatar, banner, and bio.- Nickname: Up to 32 characters
- Bio: Up to 190 characters (displayed in server profile)
- Avatar: Upload custom image (JPEG, PNG, or GIF, max 10MB)
- Banner: Upload custom banner (JPEG, PNG, or GIF, max 10MB)
URL Redirects (Premium Users)
Create custom short URLs that redirect to longer destinations.- src/commands/Premium/redirect-create.ts:52
- Code: 2-25 alphanumeric characters
- URL: Must use HTTPS protocol
- Cannot redirect to Discord invite links
Premium Limitations
Tag Limits
Tag Limits
- Free servers: 20 tags maximum
- Premium servers: Unlimited tags
- src/commands/Tags/create.ts:74-75
Role Hierarchy
Role Hierarchy
All role-related premium features require:
- Fire’s role to be above the managed role
- Your role to be above the managed role (unless server owner)
- Role must not be managed by Discord/bots
User vs Server Premium
User vs Server Premium
Getting Premium
Upgrade to Premium
Support Fire’s development and unlock advanced features for your server.
Troubleshooting
Reaction roles not working
Reaction roles not working
Check:
- Fire has
Manage Rolespermission - Fire’s role is above the reaction role
- The emoji is still on the message
- The message hasn’t been deleted
Ranks not appearing
Ranks not appearing
Verify:
- Roles are added to
utils.rankssetting - Roles still exist in the server
- Fire can view and manage the roles
Identity changes not saving
Identity changes not saving
Ensure:
- Images are under 10MB
- Images are JPEG, PNG, or GIF format
- URLs are accessible
- You have premium on the server
Next Steps
Custom Commands
Create tags and custom responses
Best Practices
Optimize your server management