Skip to main content

πŸ—ΊοΈ Quests

Quests reward members with bonus XP for completing specific challenges. Members complete them in Discord, then claim the XP on FrenMee β€” this is separate from the XP they already earn in chat and games.

Overview​

When configured, the agent can:

  • Watch for members posting a message in a chosen channel β€” any message, exact text, or a regex match
  • Reward members who win or place in a Quiz or Foe One game
  • Run tweet-scaling campaigns that pay XP for liking, commenting on, and retweeting a post on X
  • Record completions in Discord and let members claim the bonus XP on FrenMee
  • Keep an auditable Quest Claims feed with CSV export

Configuration​

To configure quests:

  1. Open your project in the Fren One webapp.
  2. Select the Discord server you want to configure.
  3. In the sidebar under Agent Configuration, select Gamification, then the Quests tab.
  4. Select "Add Quest".

Common quest fields​

Every quest shares these fields. The Quest type cannot be changed after the quest is created.

OptionDescription
Quest typePost a message in a channel (default), Win or place in a game, or Scale a tweet. Immutable after creation.
TitleThe quest's name, e.g. "Say hi in #introductions". Required.
DescriptionShown to members on FrenMee. Optional.
Bonus XPGranted when a member claims on FrenMee. Default: 50.
StatusActive (default), Paused, or Ended.

Post a message​

The member completes the quest by posting a qualifying message in the watched channel.

OptionDescription
ChannelThe channel members must post in. Required.
Message mustBe any message (default), Match exact text, or Match a regex pattern.
Exact textShown for exact matching β€” the text the message must match. Required.
Regex patternShown for regex matching, e.g. (twitter|x)\.com/.+/status/\d+ for a tweet link. Required.

Win or place in a game​

The member completes the quest by finishing high enough in a game.

OptionDescription
GameQuiz (default) or Foe One.
Top placementHow high the member must place. Default: 1 (win only); 3 = top 3 finishers.

Scale a tweet​

Choosing Scale a tweet creates a separate campaign that is posted straight to Discord β€” not a quest row β€” and the Save button becomes "Create Campaign". Members earn XP for each action they complete on the tweet.

OptionDescription
Tweet URLThe X/Twitter link to the post, or just its ID. Required.
ChannelWhere the engagement message is posted. Required.
ActionsPer-action XP for Like (default 5), Comment (default 10), and Retweet (default 8). All enabled by default; at least one required.
Duration (hours)How long the campaign accepts claims. Default: 24.
Min. followersMinimum follower count to participate. Default: 0 = open to everyone.
Min. account age (days)Minimum X account age. Default: 0 = no restriction.
Mention @everyone when postingPings the whole server with the campaign message. Default: off.
Like verification

The Like action requires X verification to be configured β€” see 🐦 X / Twitter. Without it, likes are skipped and members earn XP only for comments and retweets.

Tweet Scaling Campaigns​

Below the quest list, a read-only section shows active campaigns β€” author, tweet text, actions and XP, eligibility rules, end date, status, and a link to the tweet. Removing a campaign deletes its Discord message but keeps the XP members already earned.

Quest Claims​

An audit feed merging quest completions and verified tweet-engagement actions: title, type (Message / Game / Engagement), member and Discord ID, placement, status, XP, and date. Select "Export CSV" to download the full feed.

FrenMee Page Customisation​

Upload a cover photo shown as the background of this community's page on FrenMee (JPEG, PNG, or WebP, max 10 MB). No photo falls back to a plain grey header. This section saves on its own, independent of the quest list.

How it works in Discord​

The agent records quest completions in Discord the moment they happen β€” a matching message is posted, or a game finishes with the member placing high enough. Completions are recorded once per member, but Discord only marks the quest as earned: the bonus XP is claimed later on FrenMee, where members also see each quest's title and description.

Tweet-scaling campaigns post an engagement message to the chosen channel, and members' likes, comments, and retweets are verified against X before XP is awarded. After creating one, the webapp confirms: "Tweet-scaling campaign created β€” it'll post to the channel momentarily."

Saving your changes​

Changes on this page apply immediately when you save each quest β€” there is no page-level Save bar. Deleting a quest asks for confirmation, and existing completions and earned XP are kept.

Best practices​

Quests that get completed
  • Start with a simple "Post a message" quest in your introductions channel β€” it doubles as onboarding.
  • Use a regex quest to reward sharing links you care about, like tweet URLs.
  • Keep Bonus XP meaningfully higher than a single message's XP so quests feel worth claiming.
  • Pause seasonal quests instead of deleting them β€” you can reactivate them later, and completions are preserved either way.
Troubleshooting

Members completed a quest but have no XP?

  • Quest XP isn't granted in Discord β€” members must claim it on FrenMee. Discord only records the completion.

Nobody is earning XP for likes on a campaign?

  • The Like action requires X verification to be configured; otherwise it's skipped. Check your 🐦 X / Twitter setup.

I need to change a quest's type?

  • The type is immutable after creation. End or delete the quest and create a new one β€” deleting keeps the completions and XP already earned.