Skip to main content

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​

caution

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.


  1. Go to the Studio Dashboard
    Visit the Studio Dashboard to begin the setup process.

  2. Deploy Your Makers Hub
    Click "Deploy Makers Hub" and choose your custom subdomain to complete the deployment.

    DeployMakersHub

  3. Deploy the Discord Bot
    At the top right of the dashboard, click "Deploy Discord Bot".

  4. 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

GuildId

  1. 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!

  2. 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.

note

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.