Achievements

An achievement is a trigger, a goal and a reward. Arclo is already counting most of what a member does, so the work is deciding what is worth celebrating rather than instrumenting anything.

Triggers

29 triggers across 6 groups. Anything Arclo observes can become progress toward something.

• Where it counts limits an achievement to some channels, or everywhere except some (up to 25). A category covers its channels, a thread counts toward its channel and voice time toward its voice channel; actions that happen in no channel, like reaching a level, ignore it.
• Who can earn it does the same with roles: everyone, only these roles, or everyone except.
• With past progress on, a counted trigger can start each member from data Arclo already holds (Levels' counters, message statistics, giveaway entries, a saved birthday, a boost), so an achievement you create today credits what members did before it existed. Tiers they already qualify for are granted quietly: rewards and points, no announcement. Counted triggers start from now unless you switch that on; levels, XP and days in the server count the past, and reaching a level always does.
• Given by hand is a trigger of its own, for achievements a human awards.

Tiers

An achievement is a ladder rather than a single badge. “Send messages” can be bronze at 100, silver at 1,000 and gold at 10,000. One achievement, several rungs, each with its own badge, name and reward. A Single achievement has one unlock; a Tiered achievement up to 8 rungs. Things that happen once, like passing verification or boosting, are single only.

Count

The number that unlocks the tier, in the trigger's own unit (messages, minutes, days). Up to 10,000,000.

Name

The rung's name (Bronze, Silver, Gold and Diamond by default), used in the announcement and on the member's card. The achievement's own name and Description sit above the tiers.

Points

What the rung is worth on the leaderboard: 10, 25, 50, 100 for the default ladder, up to 10,000.

Badge

Designed in the badge editor. The plate is hand-drawn artwork, recolored to match your badge in your browser and in the posted image alike. A tier wears the achievement's badge in its own color unless you customize it.

Rewards

Give a role for achieving and Remove a role for achieving (up to 5 each; removing the previous rung's role keeps one badge role at a time), and Give XP for achieving (up to 1,000,000), paid through Levels so it can level a member up. XP is skipped while Levels is off.

Each achievement's settings

Don't track past progress

Counts only from now on for this achievement, not past activity, unless Past progress in Settings decides for every achievement. Reaching a level always counts.

Set deadline

For seasonal events: the achievement ends on the date you choose. Tiers already earned are kept; only new progress stops.

Send 'Almost there'

Nudges a member as they get close to their next tier, at this achievement's own percentage (80% by default, 25% to 95%).

Secret achievement

Hidden from the list, the public pages and the card until somebody unlocks it.

Override announcement message

Gives this achievement its own unlock message instead of the server's.

#general

ArcloBOTToday at 12:00 PM

Congratulations @Kito, you just unlocked the achievement: Chatterbox!

See Kito's achievementsAchievements list

Announcements and pages

• Unlocks are announced where they happened by default, or in a channel you pick, by DM, or not at all. Triggers with no channel of their own (a boost, voice time, a saved birthday) go to the fallback destination, a DM unless you change it. The message is designed once for the server (any achievement can override it), carries the tier's unlock banner and buttons to the member's achievements and the list, and can delete itself after a while.
• Almost there nudges a member, by DM unless you change it, as they get close to their next tier. It is on by default and can be switched off for the server or per achievement.
• /achievements shows a member's card: badges, points and progress. The public pages (every achievement, a page per member, and a leaderboard) open without Discord or a login. Publish the pages on the Leaderboard tab switches them on and off, and they can take a custom address and hide member names.
• The card can change with a member's tier. With Follow the badge on (Banners tab, Achievement card), pick Default, Bronze, Silver, Gold or Diamond above the card and design each one. A member gets the card for their highest tier, in that tier's color; Default is for members with nothing unlocked yet, and for any tier you leave undesigned. With it off, everyone gets one card in one color.
• /achievements-leaderboard and the web board rank members by achievement points, or by tiers unlocked or most recent unlock. The board can also live as a pinned message that rebuilds itself.
• Weekly and monthly highlights post the members who earned the most achievement points over the period that just finished. As the leaderboard's board image, wearing your Leaderboard banner, in a message you design on the Leaderboard tab. Weekly posts early on Monday and monthly on the 1st (UTC).
• Members can design their own achievements card: every /achievements card carries a Change Background button that opens the card studio on the website, unless you switch that off. See Your cards.

Settings

• Achievement management: browse who holds what, grant a tier or revoke an achievement from a member, or reset one member. A grant runs through Arclo exactly as /achievement-grant does, so the tier's rewards are handed out. These edits save straight away, and Announce granted tiers decides whether a grant is announced.
• Past progress: decide for every achievement at once whether what members did before it started counts (Each achievement decides, Count past progress or From now on).
• When a member leaves: whether their progress is wiped or kept for a return.
• Logging and a server-wide reset.
• The Commands tab edits each command's replies, who may use it and its cooldown.

Commands

Things to know

• An achievement counts only from the moment it exists. With past progress on, the triggers that read history start members from what Arclo already holds, so creating one later is not starting from zero for those.
• Deleting an achievement does not remove roles it already granted. Its points do come off the leaderboard.
• A member who no longer qualifies keeps what they earned. Achievements record what happened, not what is currently true.

Limits