Discord Cogs for Small Servers

This repository contains a collection of Discord cogs tailored for smaller server communities, particularly those with less than 50 members These cogs focus on getting people (e.g. friends, family) to connect.

heads up: These cogs are currently built for my particular servers and style (e.g. response messages), but I welcome any PRs if you'd like to generalize/customize them for your server.

Features

Schedule movie nights more easily by conducting polls and managing movie suggestions.

• Add movies to consider with !movieclub movie add {film title}. This will automatically pull info from TMDB and Letterboxd and load it into the next poll.
• Decide on a date with !movieclub poll date start which will find available dates at the end of the month. It even accounts for (US) holidays.
• Choose a movie with !movieclub poll movie start which loads all suggest movies into a poll for a vote.
• Movie journal: Automatically create a forum channel with each film, allowing users to discuss the movie afterward. You can also make one manually by doing !movieclub movie thread {film title}

Next:

• Event Scheduler: Plan and coordinate discord events, RSVPs, and send reminders.

• Member Stats: Track and display user activity and engagement on the server.

Requirements

To use these cogs, you need the following:

• Python 3.8+
• Discord.py
• Red-DiscordBot

Automatically assign and remove roles based on specified holidays and events.

• Assigns and removes roles based on defined holidays (currently semi-ficitious holidays)
• Includes a way to dry run changes and force holidays, for one-offs
• Allows users to opt-out of seasonal roles

Installation

Follow these steps to set up your development environment:

Step 1: Clone the Repository

Clone this repository to your local machine:

git clone git@github.com:zaneriley/discord-cogs-for-small-servers.git

Create an .env file with:

DISCORD_BOT_TOKEN=01234567890
GUILD_ID=12345678901234567890 # Right-click your server icon and hit "copy server ID"

Contributing

Contributions are welcome! If you find any issues or have ideas for improvements, please create an issue or submit a pull request.

License

This project is licensed under the GNU General Public License v3.0. This ensures the freedom to use, modify, and distribute, but requires any derivative works or distributions to be open-source under the same license. See the LICENSE file in this repository for more details.

Acknowledgements

• Red-DiscordBot: An extensible, customizable Discord bot framework.
• discord.py: A powerful library for interacting with the Discord API.
• holidays: A Python library for generating and managing public holidays.

Disclaimer

This project is not affiliated with or endorsed by Discord or any associated entities.