Secret Santa


Secret Santa is the bot for hosting Secret Santas on Discord.

Use /setup to get started.

Features

• ✅ Easy to set up. Using /setup you are guided through all the possible configurations.
• 🙂 Easy to use. Participants can do everything by using buttons. No need to explain any commands.
• ✉️ Anonymous communication between a Santa and their giftee (the one receiving their gift).
• 🔍 Moderation. Have participants rewrite their provided information, or kick them from the event.
• 👪 Draw pools. Create separate groups to have a draw among the people in each group.
• 🤝 Draw manipulation. Force/prevent two people pulling the other's name in the draw.
• ♻️ Adaptive. Allows you to swap Santas, or to insert a participant inbetween a Santa-giftee pair.
• 🕒 Supports latecomers. These can be assigned to each other or replace a Santa who has left.
• 📊 Insights. View the Santa-giftee pairs, or generate an entire spreadsheet with all the information.
• ⚙️ Highly configurable. From how gifts are submitted to how they are shown, you decide.
• 📝 Logging. Get notified when someone joins the event, or has submitted their gift.
• 🔐 Privacy. All data is encrypted and deleted 30 days after the Secret Santa has ended.


Admin commands

Running the event

• /create Create an event.
• /setup Start setting up an event. Automatically creates an event if it doesn't exist yet.
• /start Start the event.
• /reset Reset the event, allowing you to redo the draw.
• /end End the event
• /destroy Destroy the event, and with that all data from the database.

Pools

• /pool create/delete/edit/etc Manage pools with these commands.

Participant info

• /list Get a list of all your participants, or one of many filtered list, like who has yet to submit a gift.
• /info Get information on a specific participant, like who their Santa is.
• /peek Get a layout of your participants, showing who has who as their Santa.
• /spreadsheet Generate a spreadsheet with information on all participants.

Participant actions

• /ban Ban the participant from the event (not from the server).
• /dm DM a participant using the bot.
• /latecomers insert Insert a latecomer in-between a Santa-giftee pair.
• /latecomers assign Assign a group of latecomers to each other
• /manipulate force/deny Force/deny a Santa-giftee pair to occur in the draw.
• /swap Swap the giftees (and optionally Santas) of two participants.

Configurations

• /word Set the word to use for Santa. For example: Host a Secret Valentine instead!
• /role Set the role that is automatically given to server members who join.
• /welcome Set the message shown to new participants
• /letter-required Require participants to write something about themselves for their Santa to work with.
• /submit-type Set how gifts are submitted. Online, by address, both, or neither?
• /latecomers allow Whether latecomers are allowed to join.
• /reveal channel Set the channel where the gifts will be revealed, or have them appear in DMs instead.
• /reveal what What to reveal in a reveal channel. Only the text, the attachments, or both?
• /reveal names Whether to reveal the names right as the gift is received.
• /logs select Select the events to be logged in a set channel.
• /logs ping Set which event logs should ping a set role.