This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Suggestions — Suggestion System

GrumpySuggestions allows members to submit feedback and ideas. Suggestions are posted as embeds in the configured channel — with automatic 👍/👎 reactions. Staff can change the status and notify the author via DM.

---

Activation

In configs/config.yml:

addons:
  suggestions: true

channels:
  suggestions: "CHANNEL_ID"   # Where suggestions are posted

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

---

suggestions.yml

enabled: true
channelId: ""               # Empty = falls back to channels.suggestions in config.yml
cooldownMinutes: 60         # Minutes between suggestions per user (0 = no cooldown)
minLength: 10               # Minimum length in characters
maxLength: 500              # Maximum length in characters
voteUpEmoji: "👍"
voteDownEmoji: "👎"
dmOnStatusChange: true      # Notify the user via DM when status changes
staffRoles: []              # Role IDs allowed to use /suggestion status
                            # Empty = Manage Guild only

Channel fallback: If channelId is empty, channels.suggestions from config.yml is used.

---

Commands

/suggestion submit <text>

Submit a suggestion.

• Permission: Everyone (with cooldown)
• Text: 10–500 characters (configurable)
• Cooldown: Default 60 minutes
• Result: Embed in the suggestions channel with 👍/👎 reactions + suggestion ID (#N)

---

/suggestion status <id> <status> [note]

Change the status of a suggestion. Updates the embed appearance.

• Permission: Manage Guild or configured staff roles
• Args:
  • id — Suggestion number (#N)
  • status — Choose from 5 states
  • note — Admin note (optional, max 300 characters)

Status	Emoji	Color	Meaning
pending	⏳	Yellow	Still open
approved	✅	Green	Accepted
denied	❌	Red	Rejected
in-progress	🔄	Blue	In progress
implemented	💡	Purple	Implemented

If dmOnStatusChange: true, the author is automatically notified via DM (including the note if provided).

---

/suggestion list [status]

Show the last 15 suggestions, optionally filtered by status.

• Permission: Everyone

---

Suggestion Embed

┌─────────────────────────────────────────┐
│ ⏳ Suggestion #42                       │
│                                         │
│ New channel for Minecraft screenshots   │
│                                         │
│ Status: Pending · By @Jonas · #42       │
└─────────────────────────────────────────┘
👍  👎

After a status change by staff, the embed's color and emoji update. An admin note appears as an additional field.

---

Tips

• Share the workload: Set staffRoles to support roles so not everyone needs admin permissions.
• No cooldown: Use cooldownMinutes: 0 for events or feedback phases.
• Dedicated channel: Create a #suggestions channel and add it to channels.suggestions for a clean overview.