Skip to main content

Voting System Administration

The Danbot Voting System allows your community to compete for visibility and rewards on the network-wide Trending Projects leaderboard.

Administrative Commands

These commands are restricted to group administrators and are used to manage the voting lifecycle.

CommandDescription
/startvotingOpens a new voting period and pins the Vote Card.
/stopvotingCloses voting, unpins, and deletes the Vote Card.
/votereminderPosts a reminder to the group (replaces any previous reminder).
/votestatsShows current standings, rank, and project award history.

The Vote Card

When you run /startvoting, Danbot sends a pinned message that acts as the voting interface.

The card displays:

  • Project name and current network rank.
  • Total weighted votes from unique members this week.
  • Today's specific vote count.
  • Time remaining until the weekly reset.
  • "Leader" status if your project is currently ranked #1.

Interaction:

  • Vote Now: Members tap this to cast their daily weighted vote.
  • My Voting Power: A companion message sent below the pin allows users to check their multiplier privately.

Weekly Reset & Rewards

The leaderboard resets every Sunday night at 23:59 UTC.

Awards:

  • Awards are processed automatically at the time of reset.
  • Top-ranked projects receive Ad Credits deposited directly into their group account.
  • These credits can be used to launch sponsored campaigns across the Danbot network.

Permission Security

Danbot ensures only authorized admins can manage voting:

  • adminOnly: true: Commands are flagged in the bot registry to require admin status.
  • isAdmin() Check: The bot performs an asynchronous permission check (await ctx.isAdmin()) before execution.
  • Help Filtering: These commands are automatically filtered out of the /help list for non-admin users.

Next: Learn about Ad Campaigns or the technical Leaderboard Mechanics.