This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Polls — Live Voting

GrumpyPolls creates interactive polls with up to 10 options. Users vote by clicking buttons — votes are updated live in the embed. When the poll ends, results are shown as bar charts with percentages.

---

Activation

In configs/config.yml:

addons:
  polls: true

On first start, configs/modules/polls.yml is created.

---

polls.yml

enabled: true
maxDurationHours: 24     # Max duration in hours (0 = unlimited)
allowMultiVote: false    # false = one vote per user (recommended)

---

Commands

/poll create <question> <option1> <option2> … [channel] [duration]

Start a new poll.

• Permission: Manage Messages
• Args:
  • question — Question (max 256 characters)
  • option1 · option2 — Required (minimum 2)
  • option3 … option10 — Optional
  • channel — Target channel (default: current channel)
  • duration — Duration in hours (0 = unlimited)

Examples:

/poll create question:"Favorite color?" option1:"Blue" option2:"Red" option3:"Green"
/poll create question:"Server event?" option1:"Minecraft Day" option2:"Among Us" duration:48

---

/poll end <message-id>

End a poll manually — shows the final result with a bar chart.

• Permission: Manage Messages
• Args: message-id — Discord message ID of the poll message

---

Poll Embed

During the poll:

📊 Favorite color?

1️⃣ Blue
2️⃣ Red
3️⃣ Green

[1️⃣] [2️⃣] [3️⃣]   [🔒 End Poll]

Vote with the buttons · 12 votes

After ending:

📊 Favorite color?

1️⃣ Blue
   ███████░░░  70% (7)
2️⃣ Red
   ██░░░░░░░░  20% (2)
3️⃣ Green
   █░░░░░░░░░  10% (1)

Poll ended · 10 votes

---

Voting Behavior

• One vote per user — the bot prevents duplicate voting
• Change your vote — simply click a different option (previous vote is automatically removed)
• Withdraw your vote — click the same option again → vote is removed
• Live update — the total count in the footer updates after every click
• End button (🔒) — only visible and usable for users with Manage Messages permission

---

Tips

• Event polls: Use duration: 0 for unlimited duration during longer events
• Quick vote: Short polls without a duration for spontaneous decisions in meetings
• Archive results: After ending, the embed with the bar chart remains permanently visible