Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/zumitoteam/zumito-bot
Discord Bot
https://github.com/zumitoteam/zumito-bot
bot discord discord-bot discord-js nodejs typescript
Last synced: 3 months ago
JSON representation
Discord Bot
- Host: GitHub
- URL: https://github.com/zumitoteam/zumito-bot
- Owner: ZumitoTeam
- License: gpl-3.0
- Created: 2021-08-22T12:57:31.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-09-06T16:51:09.000Z (5 months ago)
- Last Synced: 2024-09-06T20:03:15.463Z (5 months ago)
- Topics: bot, discord, discord-bot, discord-js, nodejs, typescript
- Language: TypeScript
- Homepage:
- Size: 825 KB
- Stars: 4
- Watchers: 1
- Forks: 1
- Open Issues: 17
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Zumito 🧃
[](https://www.codefactor.io/repository/github/ZumitoTeam/zumito-bot)
Multipurpose discord bot
- [Zumito 🧃](#zumito---)
- [Tech stack](#tech-stack)
- [Development](#development)
* [Project requeriments](#project-requeriments)
* [Getting started](#getting-started)
+ [Setup project](#setup-project)
+ [Start bot](#start-bot)
* [Contributing](#contributing)
+ [Submiting bug or error](#submiting-bug-or-error)
+ [Submiting ideas](#submiting-ideas)
+ [Translating](#translating)
+ [Coding](#coding)
* [Workflow](#workflow)
+ [New Command](#new-command)
+ [Arrival](#arrival)
+ [Definition](#definition)
+ [Task selection](#task-selection)
+ [Development](#development-1)
# Tech stack
- [Node.js](https://nodejs.org/en/) - JavaScript runtime
- [TypeScript](https://www.typescriptlang.org/) - JavaScript superset
- [Discord.js](https://discord.js.org/#/) - Discord API wrapper
- [MongoDB](https://www.mongodb.com/) - Database
- [Mongoose](https://mongoosejs.com/) - MongoDB object modeling
- [Zumito Framework](https://github.com/fernandomema/zumito-framework) - Zumito's self-made framework
- [FFMPEG](https://ffmpeg.org/) - Audio processing for music commands
# Development
## Project requeriments
* Node.js (16.X or higher) and NPM
* Discord bot token, clientID and client secret
* MongoDB database
## Getting started
### Setup project
To start editing the bot you need to download the project
```bash
git clone https://github.com/fernandomema/Zumito.git
cd Zumito
```
Next steep is to download project dependencies
```bash
npm install
```
And finally copy .env.example to .env and edit your tokens and DB info.
```bash
cp .env.example .env
```
### Start bot
To start bot you just need to run that command on project root
```bash
npm start
```
## Contributing
We have a lot of work and need for a lot of help. For this reason any help is welcome and we have organized some of the main options in which you can contribute with your grain of sand.
Please note that if you have any other ideas on how to contribute we are all ears, we are not limited to the following list.
### Submiting bug or error
If you found an error using the bot feel free to [open issue](https://github.com/fernandomema/Zumito/issues/new/choose) and tell us what happen.
Is important you provide as much details as you can, cause we need to be able to reproduce the error in order to find a solution.
### Submiting ideas
Ideas are always welcome, inspiration is something that cannot be bought. So if you have any idea for the bot feel free to tell us what you think [opening a new issue](https://github.com/fernandomema/Zumito/issues/new/choose)
### Translating
Knowledge of a language is a great way to open doors to the whole world, so if you know a language you can always bring Zumito to a lot of new people.
Just create a pull request with the new language file and we will review it.
- The language files are located in ``src/modules/[module name]/translations/[language code].json``
- The language code must be in [ISO 639-1](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) format
- The language file must be a valid JSON file
- The main language is english, so you can use it as a reference
- To add a new language you just need to create a new file with the correct language code, bot will automatically detect it
### Coding
If you can code you can do almost everithing you want, just sumbit a pull request and we will review as fast as we can.
If you want to contribute coding but you don't know what, you can check the [projects tab](https://github.com/fernandomema/Zumito/projects). There is a lot of things to implement or fix. Feel free to open te task issue, assign to you and/or [ask for more details](https://github.com/fernandomema/Zumito/discussions/new) on that task.
# Workflow
There is a little summary of how we work.
## New command
### Arrival
First, a command comes from an issue or a project task. If the description does not come with an example output (embeds, designs, etc), the task will be moved to "`pendind definition`" status on our project board.
### Definition
Durint this stage, we will recolect the needed info for start developing the command (embeds design/structure, required assets, etc) and define the posible inputs and outputs of that command. and then the task will be moved to "`backlog status`"
### Task selection
Each time we complete the tasks unde the "`current iteration`" status, we select the following tasks that we will work on. It is similar to an agile sprint, but since we work as a hobby there is no ETA for each sprint/iteration.
### Development
Each time we start working on a command, We assign ourselves to the issue and a bot will automatically create a branch for that issue. We work on it until development is done. Then we will create an `pull request` using the `new_command.md` template, filling the use case test with all posible inputs and outputs to verify all of them are working properly. Finally before merge it into main branch at least one member of the repo will review and approve the request to ensure the pull request will not break the bot.