Code Monkey home page Code Monkey logo

groupup's Introduction

Group Up - An Event Scheduling Discord Bot | V1.0.3 - 2022/05/26

SonarCloud
Maintainability Rating Security Rating Quality Gate Status Bugs Duplicated Lines (%) Lines of Code

Group Up is a Discord bot built for scheduling events in your Guild. The bot utilizes user-friendly Buttons, Slash Commands, and Forms to create events. Currently, Group Up has built in support for Destiny 2 and Among Us, but any event can be created for any game using the Create Custom Activity button.

This bot was originally designed to replace the less reliable event scheduling provided by the Destiny 2 bot, Charlemagne, utilizing new Discord features many months before Charlemagne did.

Using Group Up

I am hosting this bot for public use and you may find its invite link below. If you would like to host this bot yourself, details of how to do so are found at the end of this README, but I do not recommend this unless you are experienced with running Discord bots.

After inviting the bot, if you want to create a dedicated event channel, simply run /setup in the desired channel and follow the on-screen prompts. If you don't want a dedicated channel, just run /create-event anywhere.

Note: The MANAGE_GUILD, MANAGE_CHANNELS, and MANAGE_ROLES permissions are only necessary for the /setup command. Once you create all of the event channel that you need, you may remove these permissions from the bot without causing any issues.

Bot Invite Link

Support Server Invite Link


Available Commands

  • /help
    • Provides a message to help users get Group Up set up in their guild.
  • /info
    • Outputs some information and links relating to the bot including the Privacy Policy and Terms of Service.
  • /report [issue, feature request]
    • People aren't perfect, but this bot is trying to be.
    • If you encounter a command that errors out or returns something unexpected, please use this command to alert the developers of the problem.
    • Additionally, if you have a feature request, this is one of the ways to request one
  • /create-event
    • Starts the event creation process.
  • /setup [options] ONLY Available to Guild Members with the ADMINISTRATOR permission
    • Designates the current channel as a Event Channel. After the command successfully runs, Group Up will be in control of the channel for running events.
  • /delete-lfg-channel ONLY Available to Guild Members with the ADMINISTRATOR permission
    • Removes the Event Channel designation from the current channel
  • /event [options] ONLY Available to Guild Members with a Group Up Manager role in a managed Event Channel
    • Allows Group Up Managers to Join/Leave/Alternate members to events

Problems? Feature requests?

If you run into any errors or problems with the bot, or think you have a good idea to add to the bot, please submit a new GitHub issue detailing it. If you don't have a GitHub account, a report command (detailed above) is provided for use in Discord.


Self Hosting Group Up

Group Up is built on Deno v1.33.1 using Discordeno v17.0.1. If you choose to run this yourself, you will need to rename config.example.ts to config.ts and edit some values. You will need to create a new Discord Application and copy the newly generated token into the "token" field. If you want to utilize some of the bots dev features, you will need to fill in the keys "logChannel" and "reportChannel" with text channel IDs and "devServer" with a guild ID.

You will also need to install and setup a MySQL database with a user for the bot to use to add/modify the database. This user must have the "DB Manager" admin rights and "REFERENCES" Global Privileges. Once the DB is installed and a user is setup, run the provided db\initialize.ts to create the schema and tables. After this, run db\populateDefaults.ts to insert some needed values into the tables.

Once everything is set up, starting the bot can simply be done with deno run --allow-write=./logs --allow-net .\mod.ts.


Privacy Policy and Terms of Service

Group Up has a Privacy Policy and Terms of Service to detail expectations of what user data is stored and how users should use Group Up. The following Privacy Policy and Terms of Service only apply to the officially hosted version of Group Up (Group Up#1305, Discord ID: 847256159123013722).

Privacy Policy TL;DR: Group Up stores data relating to events, event channels, and text from the /report command. For more detailed information, please check out the full PRIVACY POLICY.

Terms of Service TL;DR: Don't abuse or attempt to hack/damage Group Up. If you do, you may be banned from use. For more detailed information, please check out the full TERMS OF SERVICE.

groupup's People

Contributors

burn-e99 avatar

Stargazers

 avatar  avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.