Discord Quest Integration
Discord Quest Botβ
The Discord Quest Bot is designed to seamlessly sync user interactions between Makers Hub (MH) and Discord. It brings the questing experience directly to your Discord server, allowing users to manage quests, redeem rewards, and moreβall without leaving Discord. This bot mirrors the Makers Hub platform, making it easy for server members to engage with your quest ecosystem.
π’ Getting Started: Authorizing the Botβ
To use the Discord Quest Bot, you must first authorize it on your server.
This step is required to activate the botβs features and allow it to interact with your server. Make sure to complete this step before continuing with the deployment process!
We also recommend reading the full documentation before setting everything up.
π Featuresβ
Your server members can use slash commands to access PlayMakers' features:
π― Quest Managementβ
- β Complete quests and track progress.
- β The bot verifies quest completion and notifies users.
π§ Quest Filteringβ
- π Filter available quests by category (e.g., TikTok, X, YouTube...).
β³ Ongoing Questsβ
- π See staged quests that youβve started but not completed yet.
π Reward Systemβ
- π Redeem rewards directly through Discord.
- π Browse all available rewards.
π Leaderboardβ
- π View the top 5 users ranked by total earned points.
π€ User Profileβ
- π View your profile, including earned rewards and active quests.
π Authenticationβ
- π Users must create a Makers Hub account and authenticate to use bot features.
πΉ Available Commandsβ
- π
/help
β Get detailed help on how to use the bot. - π
/authorization
- Create PlayMakers Account. - π°
/points
β Check your current points balance. - π€
/profile
β View your profile details and history. - π―
/quests
β See and track your active quests. - π§
/quests category:<type>
β Filter quests by platform (TikTok, X, YouTube...). - π
/rewards
β Browse rewards and redeem them. - π’
/referral
β Get your referral code or add a friend's code. - π
/leaderboard
β See the top 5 users by total points. - β³
/ongoing-quests
β View your current staged (in-progress) quests.
π Deploying the Discord Quest Botβ
To set up the bot on your server, follow these steps:
β οΈ Make sure to authorize the bot to your discord server before continuing.
This is required to enable the botβs features and allow it to interact with your server.
-
Go to the Studio Dashboard
Visit the Studio Dashboard to begin the setup process. -
Deploy Your Makers Hub
Click "Deploy Makers Hub" and choose your custom subdomain to complete the deployment. -
Deploy the Discord Bot
At the top right of the dashboard, click "Deploy Discord Bot". -
Enter Your Server Details
Paste your Discord server's Guild ID into the field provided.
π How to find your Guild IDβ
- Go to Discord Settings β Appearance β Enable Developer Mode
- Right-click your serverβs name in the left sidebar
- Click "Copy ID"
- Paste this ID in the dashboard
-
Set a Channel Name
Choose a name for the channel where the bot will post quests and updates.
The bot will automatically create this channelβno need to create it yourself! -
Upload a Logo
Upload a square image (e.g., 512x512 px) to customize the botβs appearance on your server.
This logo will appear in some of the botβs messages and responses.
The channel created by the bot will automatically be read-only for regular users β they wonβt be able to write messages there. This is intentional and ensures that quests stay clear and organized.
β
What we recommend:
Create a separate discussion channel where members can talk, use slash commands, and interact with each other.
For example:
- If you name your main quest channel
πβquests-page
, the bot will create it automatically and post all new quests there. - You can then create another channel like
πβquests-chat
where users are free to chat, ask questions, and discuss quests.
This keeps your server clean and makes it easier for users to follow quest updates without distraction.
Final Checkβ
Once the bot is deployed, users can start interacting with it by authenticating their Makers Hub accounts. Theyβll be able to view quests, track progress, and redeem rewardsβall from the comfort of your Discord server. Make sure to authorize the bot to your server first and then add all the needed data!
For any questions or support, feel free to contact the PlayMakers team.