Levels & Rewards — progression tuning

What it is
A full-featured leveling engine that awards XP for chat and voice activity, lets you tune XP rules (per-message XP, voice multipliers, weekend boosts), add level-based role rewards, preview member progression, and capture leaderboards. Use this panel as the single source of truth for leveling rules and live behavior. (Screenshots show the engine controls, reward ladder, manual adjustments and leaderboard capture.)

Where to look
Features → Retention → Levels & Rewards.

Key UI elements

• XP Rules & Toggles — enable the system, set XP per message, voice multiplier, weekend boost, boost-channel keywords and season windows.

• Reward Ladder — add level milestones and attach roles/perks (levels automatically drive unlocks).

• Manual Adjustments — set/override a member’s XP or level; queue XP updates or resets for batch application.

• Leaderboard / Capture Board — capture a fresh leaderboard snapshot and preview global or guild scopes.

• Live controls — Save Engine / Capture Board / Preview Member buttons to push changes or preview a member.

Important slash commands / admin actions

• /rank view @user — show a user’s current XP/level/next milestone.

• /rank leaderboard — show the top 10 members.

• /rank addreward level:15 role:@SomeRole — attach a role to a level milestone.

• /rank setxp user:@user amount:1200 — set a member’s XP.

• /rank enable / /rank disable — turn XP system on/off.
  (Commands and subcommands are documented in the dashboard metadata.)

How to use it (best practice)

1. Configure core XP rules (XP per message and voice multiplier) and toggle weekend boosts if needed.

2. Add tiered rewards via the Reward Ladder; create the role in Discord first or let the dashboard create/manage it.

3. Save the engine and Capture Board to populate leaderboard data for previews.

4. Use Preview Member to confirm milestones and the next unlock.

5. Use manual adjustments sparingly (for corrections or onboarding boosts).

Tips & troubleshooting

• If leaderboards show no data, run Capture Board after you’ve saved the engine — capture populates the leaderboard snapshot.

• Use season windows to run time-limited progressions or special events.

• If XP changes don’t appear live, confirm the engine was saved and that the bot has the necessary permission to manage roles and write leaderboard telemetry.

Polls & Feedback — quick community input

What it is
Create, stage, and control multi-option polls and anonymous votes. The dashboard mirrors /poll commands so you can compose a poll (up to four choices), set duration, pick anonymous mode, and stage the poll before pushing it to Discord.

Where to look
Features → Retention → Polls & Feedback.

Key UI elements

• Compose Poll — question, up to four choices, destination channel and duration (1h, 6h, 1d, etc.).

• Live controls — staged buttons for /poll end, /poll results, /poll delete, /poll pin, /poll settings and anonymous toggle.

• Control a live poll — enter a Poll Message ID to target live poll controls (end/pin/delete).

• Staged activity — the staged create flow keeps the poll local until you push it.

Important slash commands

• /poll create question:"Which night?" choice1:"Fri" choice2:"Sat" duration:1d — launch a poll.

• /poll end message_id:12345 — stop a poll early.

• /poll results message_id:12345 — show current results.

• /poll anonymous mode:on|off — toggle anonymous voting.

How to use it

1. Ensure at least two choices are filled. Set the channel and duration.

2. Use Anonymous On if you need voting without revealing voters.

3. Stage the create and then push it live; use message ID to control a running poll.

Tips

• Use polls for map votes, balance checks, raid readiness, or short community decisions.

• For long or sensitive surveys, consider privacy settings and anonymous mode.

Giveaways — automate prizes & winners

What it is
A giveaway manager for fast drops, weekly giveaways, or sponsor events. Stage a drop with prize, number of winners, duration, host tag and required role; you can start, pause, resume, end and reroll giveaways from the dashboard. Giveaways keep state so restarts are safe. (The dashboard includes staged controls and a live timeline view.)

Where to look
Features → Retention → Giveaways.

Key UI elements

• Launch Builder — prize, winners, channel, required role, reminder cadence and host tag.

• Stage controls — Stage Start, Stage Pause, Stage Resume, Stage End, Stage Reroll, Stage Cancel, Stage Settings. Controls mirror /giveaway commands so actions stay staged until pushed.

• Live & Staged Activity — monitor live giveaways and queued staged actions.

Important slash commands

• /giveaway start duration:1h winners:1 prize:"Nitro Classic" — start a giveaway.

• /giveaway end message_id:12345 — end and roll winners immediately.

• /giveaway reroll message_id:12345 — pick new winners.

• /giveaway pause message_id:12345 and /giveaway resume message_id:12345 — control timers.

• /giveaway settings — show global config. The giveaway command persists state in data/giveaways.json.

How to use it

1. Build your giveaway profile (prize, winners, duration, channel).

2. Stage the start or schedule it; staff can pause/resume as needed.

3. After the event, use stage controls to end or reroll winners.

Tips

• Use a required role to gate entries for members who meet certain criteria.

• Host tags and reminder cadence let you keep staff and participants informed (set host tag to mention staff when a giveaway posts).

• If you rely on restarts, giveaways persist to disk so state is recoverable.

Verification — validation & gatekeeping

What it is
Create a verification gate: a locked lobby channel and button panel that assigns Not Verified on entry and promotes to Verified after CAPTCHA completion. The verification flow supports CAPTCHA preview, lock lobby behavior, account-age gates, manual review queues, DM receipts, and analytics. The dashboard can push the verification panel and also roll back via disable/delete.

Where to look
Features → Retention → Verification.

Key UI elements

• Setup — title, channel name, verified role option (auto-create Verified role), description, button label/color and toggles (Lock lobby, DM receipts, Log bypasses).

• Controls — Copy /verification setup, Push Panel (publish to server), Disable Gate, Delete Current Verification.

• CAPTCHA preview & Gate analytics — sample CAPTCHA preview and graphs for verified vs flagged vs bypassed.

• Manual review queue — enable a queue and staff can run /verification review for flagged members.

Important slash commands

• /verification setup title:"Verify to Enter" description:"Complete the steps..." button-label:"Verify" channel-name:"verification" — create verification channel/panel/roles.

• /verification disable — roll back gate and unlock channels.

• Dashboard note: setup auto-manages Verified and Not Verified roles and supports rollback.

How to use it

1. Fill the setup form and preview the CAPTCHA and analytics.

2. Push the panel when ready — the panel will lock down lobby visibility and auto-manage roles.

3. Use manual review queue for suspicious or failing verifications and enable DM receipts for users.

Tips & troubleshooting

• Use account-age gate to limit new account joins (helps with raids).

• Test CAPTCHA preview and manual queue flow before enabling in production.

• If you need to rollback quickly, use /verification disable or the dashboard Disable Gate control.

Workflows & best practices for Retention

• Stage everything first — compose polls, giveaways, leaderboards or verification panels in staging, preview with staff, and then push. This reduces accidental public posts. (All Retention modules mirror their slash commands and stage changes.)

• Test in a staff channel — whether it’s a giveaway, poll, or welcome capture, test templates and attachments first.

• Use leaderboards and reward tiers cautiously — set clear role naming and use manual adjustments for corrections.

• Monitor analytics — verification and leaderboard analytics help tune thresholds (captcha failures, bypass rates, XP spikes).

Quick troubleshooting checklist

• Leaderboards empty — run Capture Board after saving engine rules; ensure the bot can read activity data.

• Poll won’t end or results not showing — verify you are using the correct poll message ID and use /poll results or /poll end to control it.

• Giveaway timers not behaving — check staged vs live state, and use /giveaway pause and /giveaway resume to control timers.

• Verification not creating roles — make sure the bot has Manage Roles and Manage Channels permissions and use /verification setup or the dashboard Push Panel to recreate the gate.

Command cheat-sheet (Retention)

• Levels & Rewards:

  • /rank view @user — inspect XP/level.

  • /rank addreward level:15 role:@Role — attach a reward.

  • /rank setxp user:@user amount:1200 — set XP.

• Polls:

  • /poll create question:"?" choice1:"A" choice2:"B" duration:1d

  • /poll end message_id:123 / /poll results message_id:123 / /poll anonymous mode:on.

• Giveaways:

  • /giveaway start duration:1h winners:1 prize:"Prize"

  • /giveaway end message_id:123 / /giveaway reroll message_id:123.

• Verification:

  • /verification setup title:"Verify to Enter" description:"..." button-label:"Verify" channel-name:"verification"

  • /verification disable to rollback.