RoleForge
Custom Role Prefix Management Bot and more!
Welcome to RoleForge
RoleForge is a comprehensive Discord bot that provides automatic role-based nickname prefix management, reaction role functionality, welcome role automation, AFK system, social interactions, games, and complete role administration tools for Discord servers. It's designed to be simple to set up and configure for all server owners and moderators.
Features
- Role Prefixes: Automatically add prefixes to user nicknames based on their roles with multi-prefix support
- Reaction Roles: Allow users to self-assign roles by reacting to messages
- Role Management: Direct role assignment, removal, and detailed role information for administrators
- Welcome Roles: Automatically assign roles to new members when they join the server
- AFK System: Built-in AFK status management with automatic notifications
- Social Interactions: Fun commands for community engagement (hug, pat, dance, and more)
- Games & Entertainment: Dice rolling, coin flips, and magic 8-ball for server fun
- Advanced Dashboard: Comprehensive server statistics and configuration overview
- Seamless Integration: Reaction roles and role prefixes work together - when users react to get a role, they automatically receive that role's prefix too
- Custom Emojis: Reaction roles support custom server emojis for reaction role icons, allowing personalized server branding
- Unicode Symbols: Role prefixes support Unicode symbols and special characters for creative nickname formatting
- Multi-Prefix Mode: Choose to show all role prefixes or just the highest priority one
- PostgreSQL Database: Reliable cloud database storage with automatic fallback to JSON files
- Interactive Help System: Paginated help commands with role-based visibility
Pricing & Plans
đ Free Tier - $0/month
- Up to 5 role prefixes per server
- Up to 3 reaction roles per server
- All role management commands
- All user commands and social interactions
- All fun commands and games
- Welcome roles and AFK system
- Perfect for small servers getting started
đ Premium Tier 1 - $0.99/month
- Unlimited role prefixes
- Unlimited reaction roles
- All role management commands
- All premium features included
- Coverage for 1 server
- Great for single server communities
đ Premium Tier 2 - $1.99/month
- Unlimited role prefixes
- Unlimited reaction roles
- All role management commands
- All premium features included
- Coverage for up to 3 servers
- Save 33% compared to 3 separate Tier 1 subscriptions ($2.97 â $1.99)
- Ideal for server networks and multi-community owners
Premium subscriptions can be purchased through the Support Me page.
Contact
For any enquiries or support, please contact @leafiona. on discord.
Bot Commands
Here's a complete list of all available RoleForge commands, organized by category:
đĨ User Commands (Everyone can use)
/afk
Toggle your AFK status on/off
No parameters
/afkstatus
Check current AFK members in the server
No parameters
/level
Check your level, XP progress, and rank with a beautiful visual card
Parameters: user (optional - check another user's level)
/leaderboard
View the server level leaderboard with rankings
Parameters: page (optional - default is page 1)
đ Social Interaction Commands
/hug
Give someone a warm hug
Parameters: user
/pat
Give someone gentle head pats
Parameters: user
/highfive
Give someone an enthusiastic high five
Parameters: user
/wave
Wave hello or goodbye to someone
Parameters: user
/compliment
Give someone a nice compliment
Parameters: user
/dance
Start a dance party or dance with someone
Parameters: user (optional)
/slap
Playfully slap another user
Parameters: user
/poke
Poke someone to get their attention
Parameters: user
/boop
Boop someone on the nose
Parameters: user
/tickle
Playfully tickle someone
Parameters: user
đ˛ Fun & Games Commands
/coinflip
Flip a coin (heads or tails)
No parameters
/dice
Roll dice using standard notation (e.g., 1d6, 2d20, 3d10)
Parameters: dice_notation (optional - default is 1d6)
/8ball
Ask the magic 8-ball a yes/no question
Parameters: question
đˇī¸ Role Prefix Commands (Administrator)
/setprefix
Set a prefix for a specific role
Free Tier: up to 5 per server | Premium Tier: Unlimited Prefixes per server
Parameters: role, prefix
/removeprefix
Remove prefix for a specific role
Parameters: role
/listprefixes
List all role prefixes for this server
No parameters
/togglemultiprefix
Toggle multi-prefix mode for this server
Shows all role prefixes vs. only the highest priority role's prefix
Parameters: enable (optional - toggles current state if not provided)
/updateall
Update all member nicknames based on current role prefixes
No parameters
⥠Reaction Role Commands (Administrator)
/setupreactionrole
Set up reaction roles on a message (supports cross-channel setup)
Free Tier: up to 3 reaction roles per server | Premium Tier: Unlimited reaction roles per server
Parameters: message_id, emoji, role, channel (optional - uses current channel if not specified)
/removereactionrole
Remove a reaction role mapping
Parameters: message_id, emoji
/listreactionroles
List all reaction role setups for this server
No parameters
đĨ Role Management Commands (Administrator)
/addrole
Add a role to a member
Automatically updates nickname if prefixes are configured
Parameters: member, role
/removerole
Remove a role from a member
Automatically updates nickname after role removal
Parameters: member, role
/listroles
List all roles in the server or roles for a specific member
Parameters: member (optional)
/roleinfo
Get detailed information about a specific role
Shows permissions, member count, creation date, and prefix status
Parameters: role
đ Level System Commands (Administrator)
/togglelevel
Enable or disable the level system for this server
Parameters: enable (optional - toggles if not provided)
/levelconfig
Configure XP rates, cooldowns, and daily/weekly caps
Parameters: xp_per_message, xp_cooldown, daily_cap, weekly_cap (all optional)
/giveexp
Give XP to a user (for rewards, events, or achievements)
Parameters: user, amount (max 1,000,000 per command)
/removeexp
Remove XP from a user (for penalties or corrections)
Parameters: user, amount
/setlevel
Set a user to a specific level directly
Parameters: user, level (1-1000)
/resetlevel
Reset a user's level data completely
Parameters: user, confirm (type "CONFIRM" to proceed)
/configureranks
Set up custom rank titles at level intervals (e.g., Novice, Apprentice, Expert)
Parameters: rank_interval (levels between ranks), rank_names (comma-separated)
/listranks
View the current rank configuration and progression
No parameters
/removeranks
Remove the rank system from this server
No parameters
đ Welcome Role Automation (Administrator)
/addwelcomerole
Add a role to be automatically assigned to new members
Parameters: role
/removewelcomerole
Remove a role from automatic assignment to new members
Parameters: role
/listwelcomeroles
List all welcome roles for this server
No parameters
âšī¸ General Commands
/help
Show help for all bot commands with interactive navigation
No parameters
/premium
Check this server's premium status and benefits
No parameters
/dashboard
View comprehensive server and bot statistics
No parameters
How It Works
- Automatic Updates: The bot automatically updates nicknames when roles change
- Priority System: Higher positioned roles take precedence for prefixes
- Multi-Prefix Mode: Choose to display all role prefixes or just the highest priority one
- Server-Based Premium: Premium benefits apply to all server members
- Reaction Roles: Users can self-assign roles by reacting to messages
- Welcome Automation: New members automatically receive configured welcome roles
- AFK Detection: Automatic AFK status management with mention notifications
- Level System: Members earn XP by chatting and progress through customizable rank tiers
- Visual Level Cards: Beautiful gradient-styled cards showing XP progress, levels, and ranks
- Custom Ranks: Create unique progression systems with custom rank titles
- XP Management: Admins can reward active members or handle moderation with direct XP control
- Role Hierarchy: Commands respect Discord's role hierarchy and permissions
- Smart Integration: Manual role changes trigger automatic nickname updates
- Cross-channel Setup: Use message IDs to set up reaction roles on messages in any channel
- Database Reliability: PostgreSQL database with JSON file fallback for maximum uptime
- Interactive Help: Context-aware help system with navigation and role-based visibility
- Real-time Dashboard: Live server statistics and configuration monitoring
Permission Requirements
- Manage Nicknames: Required for prefix-related commands
- Manage Roles: Required for reaction role, role management, and welcome role commands
- View Channel: Required to see channels and messages
- Send Messages: Required to respond to commands and send confirmations
- Add Reactions: Required for reaction role functionality
- Read Message History: Required for reaction role setup and AFK system
- Attach Files: Required for sending level card images
- AFK Role Setup: Server requires a role named exactly 'AFK' for AFK functionality
â¤ī¸ Support RoleForge
Help keep this bot alive and running 24/7! Every little bit of support makes a huge difference in maintaining the servers, development, and keeping RoleForge accessible for everyone.
Support on Ko-fi
Choose your support level and help keep RoleForge running strong!
â Support on Ko-fi
â Coffee Supporter
Help fuel late-night coding sessions! Even a small contribution helps cover server costs and shows your appreciation.
đ Champion Supporter
Premium supporters help ensure RoleForge stays online and continues growing with new features and capabilities.
Why Ko-fi and Manual Management?
Due to Discord's monetization features not being available in my country, I manage premium subscriptions manually through Ko-fi. This allows me to offer premium features to servers worldwide while providing personalized support for each subscriber.
Other Ways to Help
- Spread the Word: Tell other Discord servers about RoleForge
- Leave Feedback: Report bugs and suggest new features to @leafiona. on discord
- Premium Subscriptions: Consider upgrading your server to premium for advanced features
Thank you for being part of the RoleForge community! Your support helps keep this project alive and growing.
Terms of Service
1. Acceptance of Terms
By using RoleForge ("the Bot"), you agree to be bound by these Terms of Service ("Terms"). If you do not agree to these Terms, do not use the Bot.
2. Description of Service
RoleForge is a Discord bot that provides:
- Automatic role-based nickname prefix management
- Reaction role assignment functionality
- Welcome role automation for new members
- AFK status management system
- Social interaction and entertainment commands
- Comprehensive role management tools
- Server administration features for Discord communities
3. User Accounts and Access
3.1 Bot Invitation
- Server administrators must invite the Bot to their Discord server
- The Bot requires specific permissions to function properly
- Server administrators are responsible for managing the Bot within their servers
3.2 Premium Access
- Premium features are available through subscription
- Premium access is granted per-server, not per-user
- Payment must be arranged directly with the bot owner
4. Acceptable Use Policy
4.1 Prohibited Activities
You may not use the Bot to:
- Violate Discord's Terms of Service or Community Guidelines
- Harass, abuse, or harm other users
- Distribute spam, malware, or malicious content
- Impersonate others or provide false information
- Attempt to exploit, hack, or interfere with the Bot's functionality
- Use the Bot for illegal activities
5. Premium Services
5.1 Subscription Terms
- Premium subscriptions are billed monthly per server
- Payment arrangements are made directly with the bot owner
- Premium features include unlimited prefixes and reaction roles
6. Limitation of Liability
The Bot is provided "as is" without warranties of any kind. We do not guarantee continuous availability or error-free operation.
7. Contact Information
For questions about these Terms or the Bot, contact the bot owner through Discord or use the support channels in servers where the Bot is present.
By using RoleForge, you acknowledge that you have read, understood, and agree to be bound by these Terms of Service.
Privacy Policy
1. Introduction
This Privacy Policy explains how RoleForge collects, uses, and protects information when you use our Discord bot service. We are committed to protecting your privacy and being transparent about our data practices.
2. Information We Collect
2.1 Automatically Collected Information
Server Information:
- Discord server IDs and names
- Server member counts
- Channel IDs (for reaction role messages)
User Information:
- Discord user IDs (for premium subscribers and bot functionality)
- User roles and role changes
- User nicknames (for prefix management)
- AFK status information
Configuration Data:
- Role prefix settings and mappings
- Reaction role configurations
- Welcome role configurations
- Multi-prefix settings
- Message IDs for reaction role functionality
- Role management activity logs
2.2 Information We Do Not Collect
We do not collect:
- Message content (except message IDs for reaction roles)
- Personal conversations or private messages
- Voice data or communications
- Personal identifying information beyond Discord IDs
- Financial information (handled by payment processors)
- Social interaction command usage patterns beyond basic functionality
3. How We Use Your Information
We use collected information to:
- Provide bot functionality (nickname prefixes, reaction roles, role management)
- Manage welcome role automation
- Maintain AFK status system
- Process social interaction and entertainment commands
- Manage premium subscriptions and access
- Maintain service quality and reliability
- Respond to support requests
- Ensure proper role hierarchy and permissions are respected
4. Data Storage and Security
- Configuration data stored securely in PostgreSQL database systems
- Automatic fallback to JSON files for reliability
- Server hosted in secure cloud environment
- Data encrypted during transmission
- Regular security updates and monitoring
- Automatic data backups for reliability
5. Your Rights and Choices
You have the right to:
- Request information about data we have collected about you
- Request corrections to inaccurate information
- Request deletion of your data
- Opt out of data collection by removing the Bot from your server
- Disable specific features like AFK status or welcome roles
6. Contact Information
For privacy-related questions or requests, contact the bot owner through Discord or use available support channels.
This Privacy Policy is effective as of the date listed above and governs our collection and use of information from that date forward.