Run quests with points and a leaderboard

Create quests with verified X repost, quote and reply tasks, pay points in a time window, rank members on a leaderboard with prizes, export the winners as CSV and show quests on Quest.xyz.

A quest is a short list of tasks that pays points once. "Repost our launch post on X, follow us and join the Discord: 100 points" is a quest. You create quests in your guild's admin panel, members complete them on your guild's Quests page, and a time-boxed leaderboard over those points decides who wins your prizes. A quest can also be shown on Quest.xyz, where people find and play quests from every listed guild with the same Guild account.

What a quest is

  • Tasks. Each task is a requirement, checked against the member's connected accounts: repost, quote or reply to a post on X, follow an account, be in your Discord server, visit a link, hold a token, make a transaction. By default a member must do all of them; you can also accept any one, or at least a number of them.
  • Points. Completing the quest pays a fixed number of points in one of your point systems. Each member is paid once per quest.
  • A window. An optional start and end. Points are paid only between them.
  • Its own place. Quests are listed on the guild's Quests page, not among its roles, so they don't crowd your role pages or change your role counts.

Underneath, a quest is a role on no page with a points reward, so access checks, rechecks and the points ledger work exactly as they do for roles. Completing a quest makes the member a member of your guild.

Create a quest

  1. In your guild, choose Manage guild and open Quests in the admin panel.
  2. Press New quest.
  3. Give it a title and a description that says what to do, and optionally an image.
  4. Add the tasks with the requirement picker. See Tasks below.
  5. Set the points: the amount, and the point system it pays on. Pick an existing system or create one, such as "XP".
  6. Optionally set a start and end. Leave the start empty to start now and the end empty to run without one.
  7. Switch on Show on Quest.xyz if the quest should be listed there as well. See Show on Quest.xyz.
  8. Save. The quest list shows each quest's status (scheduled, live, ended or archived) and how many members completed it.

You can change the title, description, image, points amount, dates and listing later. Edit a quest's tasks the way you edit a role's requirements. Changing the amount affects members who complete the quest from then on; points already paid stay as they are. Archiving a quest takes it off the Quests page and Quest.xyz, and members keep the points they earned.

Tasks

Any requirement type can be a task. The ones campaigns use most:

  • Repost a post on X: Guild asks X whether the member's connected account reposted it, and the task is done only if X says yes.
  • Quote a post on X: verified with X the same way.
  • Reply to a post on X: verified with X the same way. It has to be a direct reply to the post, not a reply to someone else's reply under it.
  • Like a post on X: self-reported. X does not let Guild confirm a like, so the member's click on the like link is what counts. Don't let a like task decide a prize.
  • Follow on X, Discord member, Visit link, token and NFT balances, and onchain activity work as they do in roles. See X requirements and Requirements.

For a post task, paste the post's URL, for example https://x.com/guildxyz/status/1234567890. Members need to connect their X account. Their task card has Repost on X, Quote on X or Reply on X, which opens X with the post ready; after posting they come back and check the task.

Points

A member presses Complete on the quest. Guild checks every task, and when they are done and the quest is live, pays the quest's points in one step. Pressing it again never pays twice. Checks of X tasks are limited to 10 per member every 10 minutes, so a member who checks too early may need to wait a few minutes before trying again.

A quest's points follow the same ledger as every points reward: each payment is an entry in the system's history and the member's balance is the sum. Quest points are kept by default when a member later stops meeting a task, and deducted if they leave the guild. See Points for how these settings work.

Windows

The window applies to points, not to the tasks. Completing a quest is possible at any time, and a member who does it outside the window still sees which tasks they have done, but is told the quest is not active and gets no points. Before the start the quest shows as scheduled, after the end as ended. Ending a quest early is a matter of moving its end date.

Leaderboards and prizes

A quest leaderboard ranks members by the points they earned on one point system during a fixed window, for example the 30 days of a launch campaign with prizes for the top 10.

  1. In the admin's Quests section, create a leaderboard.
  2. Pick the point system, give it a title, and set its start and end.
  3. Choose what counts:
    • Quests (the default): only points paid by this guild's quests on that system.
    • All points: every point on the system in the window, including role rewards and admin adjustments.
  4. Describe the prizes. This is text shown to members, such as "Top 10 share 1,000 USDC".
  5. Optionally show it on Quest.xyz.

Members see the standings on the leaderboard's page in your guild, with their own rank pinned. Ties go to whoever reached the score first. Points deducted after the end don't change the final standings.

Guild does not pay prizes. When the leaderboard ends, export its standings as CSV from the admin panel: each row has the rank, points, Guild user ID, primary identity, when the account was created and which account types it has connected. Use it to review the winners, then pay them yourself.

Show on Quest.xyz

Quest.xyz is the public door to Guild quests: the same quests, the same points and the same sign-in, gathered from every listed guild. A quest is shown there when all of these hold:

  • Show on Quest.xyz is on;
  • it is live: started and not ended;
  • it is not archived;
  • Guild staff have not delisted it;
  • your guild is verified or has at least 50 members.

Guild staff can delist a quest that breaks the rules or misleads people, and record why. A delisted quest keeps working in your guild; it only leaves Quest.xyz.

Fair play

Prizes attract farmers. Some habits that keep a leaderboard honest:

  • Prefer verified tasks (repost, quote, reply, follow) over self-reported likes for anything that decides a prize.
  • Add a task that is hard to fake at scale, such as an X account created before a date, a wallet with some history, or a World ID profile. See Keep out bots.
  • Use the Quests scope for a quest leaderboard, so points granted by hand or from other roles don't decide it.
  • Review the CSV before you pay: new accounts, accounts with a single connected identity and clusters of similar names are worth a second look.
  • Say in the description and the prizes text how winners are chosen and when they are paid.

With an AI agent

An agent connected to the Guild MCP server can list, create, edit and archive quests, create a leaderboard and read its standings, with the Read guilds and Manage guilds permissions. It cannot complete a quest for you. See Manage with an AI agent.

FAQ

Should I still make a role for each quest?

No. Use a quest for tasks that pay points, and a role for an ongoing status, such as a holder tier or a Discord role. A role can still require a points balance, so quest points can unlock roles.

Can a member complete the same quest twice?

No. Each member is paid once per quest. To reward something again and again, create a new quest for each round, or grant points with Adjust points (see Points and leaderboards).

Do members need a Quest.xyz account?

No. Quest.xyz signs in with Guild, so a member's quests and points are the same in both places.

Can a quest give a Discord role?

No. A quest pays points. Give the Discord role from a role that requires a points balance, so members unlock it by completing quests.

All Guild docs