Skip to main content

🔑 Secret Codes

Secret codes are reward phrases you hand out however you like — in announcements, at events, hidden in messages — and members redeem in Discord with /redeem. Each code pays out XP, a role, or coins, and can be limited to a single use.

Overview​

When configured, the agent can:

  • Reward the members who redeem a code with XP, a role, or coins
  • Enforce single-use codes — first member to redeem wins
  • Delete the message that contained a code once it's been redeemed
  • Log redemptions to a channel of your choice

Configuration​

To configure secret codes:

  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 Secret Codes tab.

Redemption settings​

OptionDescription
Delete messages that contain a code after redemptionCleans up the channel by removing the message that posted the code once a member has redeemed it. Default: on.
Log channelOptional channel to log code redemptions.

Creating codes​

Select "New Code" to open the code editor. Each code in the list shows the code itself, Single-use and Inactive pills where they apply, and its reward type, value, and use count.

OptionDescription
CodeThe phrase members type to redeem the reward, e.g. LAUNCH2024. Required; cannot be changed after creation.
Reward TypeXP (default), Role, or Coins.
Reward ValueThe size of the reward. Default: 100.
Single useOnly the first member to redeem gets the reward. Default: off.
ActiveWhether the code can currently be redeemed. Default: on.

How it works in Discord​

Members redeem a code with /redeem and receive the reward immediately — XP added to their balance, the role granted, or coins credited. Single-use codes are enforced: once redeemed, later attempts fail. When a Log channel is set, each redemption is logged there, and redemptions can also appear in the mod log.

With the deletion setting on, the agent removes the message that contained the code after it's redeemed, so a code posted in chat doesn't linger once it's spent.

For role rewards, the agent's role must sit above the granted role in your server's role hierarchy.

Saving your changes​

This page uses a batched save — edits stay local until you select Save in the bar that appears at the bottom of the page. Deleted codes stay visible with an Undo option until you save. Leaving the page with unsaved changes shows a warning first.

Best practices​

Making codes an event
  • Use single-use codes as prizes — drop one in chat during an event and let the fastest member claim it.
  • Deactivate codes instead of deleting them when a campaign ends; you can reactivate the same code later.
  • Set a Log channel so you can see who redeemed what, especially for high-value rewards.
  • Pick memorable, typo-proof codes like LAUNCH2024 — members type them by hand.
Troubleshooting

/redeem isn't accepting a code?

  • Check the code's Active toggle — inactive codes can't be redeemed.
  • Single-use codes only work once; if someone beat them to it, the code is spent.

A role reward wasn't granted?

  • The agent's role must be above the reward role in the server's role hierarchy.

I made a typo in a code?

  • The code itself is immutable after creation. Deactivate or delete the bad code and create a new one.

On this page