Explore

Advertise

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Secret Santa

Secret Santa

4.6

0

Invite

Vote (1)

Host Secret Santas in your server! Write a letter for your Santa, make/buy something for your giftee. Supports anonymous communication.


Secret Santa

Secret Santa is the bot to host Secret Santas with on Discord.

Features

  • Easy to set up. People can join by command or reaction, and are assigned a role upon joining.
  • Supports latecomers. These can be assigned to each other or replace a Santa who has left.
  • Anonymous communication between a Santa and their giftee (the one receiving their gift).
  • Moderation. Get info about a specific participant, and ban them from the event if you must.
  • Privacy. All data is encrypted and deleted 30 days after the Secret Santa has ended.

The bot supports both classic commands and slash commands.

Quick Guide

  1. santa>create to create a Secret Santa.
  2. santa>message to create an invite message.
  3. Participants use >letter [text] to write about themselves/what they want. (Participants use commands in the bot's DM)
  4. santa>start to start the Secret Santa.
  5. Participants use >read to read their giftee's letter.
  6. Participants use >submit [text] to submit their gift.
  7. santa>end to end the Secret Santa.
  8. Participants use >receive to receive their gift.
  9. santa>destroy to destroy the Secret Santa, deleting all data. Happens automatically 30 days after ending it.

Guide

Create a Secret Santa

After you have added the bot to your server you can create a Secret Santa using the moderator commands. To use these commands you need either the Manage messages, Manage channels or Manage roles permission. You can change the prefix with santa>prefix [prefix].

Use santa>create to create a Secret Santa.

Now you have a few more options:

  • santa>role [name] - Set or create the role that will be assigned to people who join the Secret Santa.

  • santa>word [word] - Set the word the bot will use instead of 'Santa'. Useful if you want to host a Secret Valentine instead.

  • santa>toggle-latecomers - Turn on or off whether latecomers are allowed to join. On by default.

  • You can configure how the gifts will be revealed.

Revealing

By default everyone gets their gift sent to their DMs, but you can also have the gifts to be revealed in the server instead.

Reveal channel

Use santa>reveal-channel set in the channel where you want the gifts to be revealed.

When a reveal channel is set the bot will not automatically send the gifts to participant's DM, and participants won't be able to use >receive until their gift has been revealed in the channel.

If you don't want to use a reveal channel anymore you can use santa>reveal-channel remove to remove the reveal channel.

Reveal type

Use santa>reveal-type all/text/attachments to set what part of the gift should be revealed in the reveal channel.

By default this is all, meaning the complete gift. But perhaps you have a Secret Santa where everyone makes art for each other. You want to show off the art, but the personal message that comes with that should be kept private. In that case you want to use images to only reveal the images attached to the gift.

Or perhaps everyone was instructed to make a poem for each other, but the gift should be kept private. In that case you want to use text.

After the gift has been revealed in the reveal channel the giftee to whom it belongs can use >receive in DM to receive the complete gift.

Reveal name

Use santa>toggle-reveal-name to turn on/off whether the name of the Santa should be revealed.

This is on by default, but you might want to have the participants guess as to who their Santa is after their gift has been revealed. When this is turned off 'Santa' will be used instead of their name.

This also won't reveal their Santa's name when they use >receive in DM to receive the complete gift.

Have people join the Secret Santa

When you're ready with setting it up you can start inviting people to join. Use santa>invite [text] to create an invite with a message and a button that people can click to join. If no text is provided for the message a default text will be used. People can also use the slash-command /join to join the Secret Santa.

People who want to join should have 'Allow direct messages from server members.' turned on, or else the bot can't send them a DM. This is on by default.

Write a letter

People who have joined can write a letter using >letter [text]. This command, like with all commands for participants, is to be used in the bot's DM. The commands in DMs always use the prefix >, regardless of what prefix you set it to in your server. It's recommended you use the > command for writing the letter, as the slash-command doesn't allow you to write multiple lines, nor does it allow you to edit your message.

What they should write in that letter is up to you as a host of the Secret Santa. In general, you probably want them to write something about themselves and what they like so that their future Santa will know what to buy or make. If file attachments are added when using the command then links to these files will automatically be added to the letter. As long as the Secret Santa hasn't started yet they can reuse the command to change their letter.

If someone changed their mind about participating they can leave using >leave in the bot's DM. If they changed their mind again they can join the same way as they joined before. Whether someone can join again after the Secret Santa has started is based on what you set santa>toggle-latecomers. This is on by default. If someone leaves after the Secret Santa has started they are automatically banned from joining again.

Start the Secret Santa

You can use santa>stats (in your server) to see how many people still need to write a letter. Use santa>list letter to get a list of participants who have yet to write a letter. Use santa>list all to get a list of all participants. When you're ready you can use santa>start to start the Secret Santa. Everyone will be assigned a Santa. As a Santa the one you need to give a gift is your giftee, and you are the giftee of your Santa. Note that they are assigned in a chain. No one's Santa is also their giftee, and it doesn't matter if you have an odd or even number of participants.

If you only have a few participants the bot will automatically DM everyone their giftee's letter. If you have lots of participants you should inform them that they can read their giftee's letter using >read. A taggable role set with santa>role would come in handy for this. The reason for this is that rate limits will not allow the bot to DM many people in a short period.

With santa>list read you get a list of participants who still need to read their giftee's letter. Send them a personal reminder, or if they take too long use santa>ban [ID] (in your server) to ban them from the Secret Santa. Note that the Secret Santa bot does no server moderation. They are not banned from the server.

You can unban participants using santa>unban [ID].

Discord ID

The ID-parameter is the Discord ID of the user. To get this ID you first need to turn on Developer Mode. In Discord go to User Settings -> Appearance -> Developer Mode. After you've enabled this you can right-click on a user to get their Discord ID.

Anonymous communication

Participants can communicate with their giftee using the command >write-giftee [text]. Giftees can reply back using >write-santa [text]. This is useful in case the Santa has some questions for the giftee.

If this feature is abused (e.g. spam, foul language) it should be reported to you, the host of the Secret Santa. Using the ID of the person complaining you can use santa>info [ID] (in your server) to find out who their Santa and giftee is. You can then ban the culprit from the Secret Santa using the abuser's ID.

Latecomers

If you have a bunch of people who joined after the Secret Santa had started you can assign them to each other using santa>assign-latecomers. You can use this command multiple times, but only when you have 3 or more latecomers.

Abandoned

When someone leaves or is banned after the Secret Santa has started they leave their Santa without a giftee and their giftee without a Santa. The Santa is offered to switch to the abandoned giftee using >switch. However, it might be the case that they already bought/made something for the giftee who left them. In that case, they can use >stay to stay with their old giftee.

While the Santa is still deciding, or if the Santa has decided to stay with their old giftee, latecomers come in handy. A latecomer (who doesn't have a giftee yet) will automatically be assigned as the Santa of the abandoned giftee. In turn, that latecomer still won't have a Santa. If there is another latecomer it will be assigned to the other latecomer. This can be repeated for as many latecomers there are. If the Santa whose giftee abandoned them eventually decides to >switch they will be assigned to the last latecomer in the chain, which closes the gap.

If this sounds confusing to you, don't worry. It all happens automatically!

Submit a gift

When a Santa has bought or made the gift for their giftee they can submit it using >submit [text]. If they have something physically sent to their giftees address the submission could simply inform them about it. Just like with letters the links to file attachments will automatically be added. This is useful if you made a drawing for example.

Even after the Secret Santa has ended participants can still submit their gift. However, they can't edit their gift after their Secret Santa has ended.

You can use santa>list submit to get a list of participants who have yet to submit their gift.

End the Secret Santa

Using santa>stats you can see how many people have submitted a gift. When you're ready you can use santa>end to end the Secret Santa. If you have a reveal channel set, you can use santa>start-reveal to get a button that allows you to show the gifts. If not, and you only have a few participants, then the bot will automatically DM everyone their gift. If you have lots of participants you should inform them that they can read their giftee's letter using >receive. Again the role comes in handy.

Destroy the Secret Santa

The letters written for the Secret Santa can contain sensitive information likes names and addresses. After everyone has submitted and received their gift you can use santa>destroy to destroy the Secret Santa. This will delete all the relevant data from the database. A Secret Santa is automatically destroyed 30 days after it has ended.

Reset the Secret Santa

After you have started a Secret Santa you can always reset it. This brings it back to the state before you started the Secret Santa, allowing you to start it again. Members that already joined won't have to rejoin the Secret Santa, and members that want to join can now do so. Note that by doing this everyone will be assigned to a random Santa again.

Resetting is useful when:

  • You just started the Secret Santa too early by accident. There were still a few people that wanted to join. You reset the Secret Santa, have them join, and then start it again.
  • You just finished the Secret Santa, and would like to do another Secret Santa with the same people (or more).
  • The majority of the participants would like a different giftee for whatever reason.

FAQ

What happens when someone is in multiple Secret Santas?

By using >events the user can see a numbered list of Secret Santa events they are in. Using >select [number] they can select which Secret Santa their commands should be applied to. This way the user can participate in multiple Secret Santas just fine.

What is Secret Santa made with?

Secret Santa is made with Discord.js and Typescript.


Top Discord Servers Using This Bot


Karuta XO

⸝⸝ haru 春

Ratings & Reviews


4.6

5 reviews

Reviews can be left only by registered users. All reviews are moderated by top.gg admins. Please make sure to check our guidelines before posting.

5 stars

4

4 stars

0

3 stars

1

2 stars

0

1 star

0


nathan!
nathan!

10 months ago

its good but i wish we had the option to receive our gifts in a channel so its like opening a present with our friends

3

Secret Santa

Replying to nathan!

Thank you for your feedback. This feature has now been added!


House
House

10 months ago

Great bot! Worked perfect for a secret santa between me and my friends. Easy to use too!

2


montiree
montiree

9 months ago

good bot, 10/10 would recomend

1


antonio no!
antonio no!

9 months ago

best secret santa bot ive used. theres so many useful features that it helped run a whole 50-member secret santa event smoothly. really helpful dev too, answers all your questions in the support server

1


Urschanabi
Urschanabi

9 months ago

Enjoyed using the bot, thank you very much! Will use it in the future as well.

1


Details

Prefix

santa> in server and > in DM

Socials

Discord Support Server

Tags

    Social

    Utility

Creators

Sheepolution

Sheepolution