Olá, eu me chamo Aruna. Sou um bot brasileiro para Discord com algumas funções muito interessantes.
Eu tenho várias funções para entretenimento (como comandos engraçados), funções sociais, extremamente customizável (você pode ativar/desativar diversos comandos meu, alterar meu prefixo para o que você quiser e muito mais!).
Se você quiser usar a Aruna no seu servidor, você pode adiciona-la clicando aqui.
Você pode obter suporte sobre a Aruna clicando aqui!
No momento, temos 2 repositórios na nossa organização; Estes são,
- Aruna: Código-fonte da Aruna ("backend"), isto inclui todo o bot em si.
- ArunaLanguages: Os idiomas da aruna, toda e qualquer tradução vem de lá.
Mesmo que você não saiba programar, você pode ajudar no desenvolvimento doando! https://patreon.com/LoboMetalurgico (outras formas de doação estarão disponíveis em breve).
Você também pode hospedar a Aruna você mesmo (afinal, é por isso que se chama selfhosting) caso você preferia ter total controle sobre os bots que você tem no seu servidor, mas lembre-se...
- Nós deixamos o código-fonte para que outras pessoas possam se inspirar e aprender com nossos projetos, o objetivo é que pessoas que são fãs da Aruna aprendam como ela funciona e, caso queiram, podem ajudar ela com correções e/ou novas funcionalidades.
- Eu não irei dar suporte caso você queria fazer self hosting apenas para querer "fama" falando que você criou um bot, mesmo que na verdade você apenas pegou o código-fonte dela e hospedou, lembre-se, a licença do projeto é AGPL v3, você é obrigado a deixar todas as suas alterações no projeto públicas!
- Eu não irei ficar explicando e te ajudando a como arrumar problemas na sua versão selfhosted, portanto você está por sua conta e risco. A única exceção é se você está planejando selfhostear para ajudar a desenvolve-la.
- Para evitar confusões e problemas, você não pode utilizar o nome ou a personagem "Aruna" ou nomes parecidos na sua versão selfhosted.
Nós recomendamos utilizar a versão pública da Aruna, mas se você realmente quiser hospedar ou ajudar a desenvolver a Aruna, siga os seguintes passos:
- Tenha o NODE 12.16.2 (ou superior) instalado na sua máquina e certifique-se que o node e o npm (incluso no nodejs) estão acessíveis pelo terminal. (Tente executar
node -v
enpm -v
no terminal, caso não funcionem, procure reinstalar o nodejs ou reiniciar a máquina). - Tenha o MongoDB instalado na sua máquina. (Ou se prefereir, pode usar o MongoDB Online).
- Tenha o
git-shell
ou ogit-cli
instalados. No Windows você pode utilizar oGit Bash
. - Caso você precise ou fazer modificações no código-fonte, é recomendado utilizar o Visual Studio Code.
- Execute o comando
git clone https://github.com/ArunaBot/Aruna.git
usando seu terminal git em uma pasta vazia do seu computador. - Acesse a pasta criada usando o processador de comandos do seu sistema operacional (CMD, POWERSHELL, Terminal, etc) e execute o comando
git submodule update --init
para baixar o pacote de idiomas da aruna. - Ainda com o processador de comandos, execute o comando
npm install
. - Ao terminar de fazer o download de tudo, verifique se foi criado a pasta
node_modules
. - Caso essa pasta exista e tenha sido criado o arquivo
package-lock.json
significa que tudo deu certo! - Agora, retire o
.
da pasta.Configs
. - Depois, abra o arquivo
general
e preencha o campotoken
com o token do seu bot, o campomongoose
com o link de acesso ao mongoose e por fim, altere o camposuperUsersId
para o id do seu usuário. - Com tudo pronto, podemos iniciá-la abrindo um terminal e digitando
npm start
. - Caso tenha dado tudo certo, a sua versão selfhosted irá iniciar e você poderá utilizar os comandos dela! 🎉
Para editar o código-fonte da Aruna, faça os tópicos de de 1 a 9 e depois, abra a pasta com o código em seu visual studio code e divirta-se aprendendo, modificando e melhorando a Aruna!
No seu Pull Request, você deverá seguir o meu estilo de código bonitinho que eu faço, é recomendado que você coloque comentários nas partes do seu código para que seja mais fácil na hora da leitura.
O seu código não pode ser algo "gambiarra", meu código pode ter gambiarras mas isto não significa que você também deve encher a Aruna com mais gambiarras.
Você precisa pensar "será que alguém iria utilizar isto?", se você criar um comando que só seja útil no seu servidor, provavelmente eu irei negar o seu Pull Request.
Funcionalidades (como comandos) relacionados a coisas NSFW não serão adicionadas na Aruna e seu Pull Request será negado.
A Aruna utiliza várias dependências no código-fonte, obrigado a todos os mantenedores das dependências! Sem vocês, a Aruna não iria existir (ou teria várias funcionalidades reduzidas ou até inexistentes!).
Nome | Mantenedor |
---|---|
Node | OpenJS Foundation |
discord.js | Comunnity |
Express | TJ Holowaychuk, Douglas Christopher Wilson |
Express Session | dougwilson, Fishrock123, etc |
Mongoose | vkarpov15, aheckmann, rauchg, etc |
Moment | ichernev, timrwood, icambron, etc |
Moment Duration Format | jsmreese |
Ytdl Core | fent, #3TimeForANinja, etc |
Node Opus | Rantanen, thijstriemstra, nfriedly, etc |
Jimp | hipstersmoothie, oliver-moran, strandedcity, etc |
SuperAgent | tj, kornelski, defunctzombie, etc |
MathJS | josdejong, rjbaucells, FSMaxB |
Chalk | sindresorhus, Qix-, etc |
O código-fonte da Aruna está licenciado sob a GNU Affero General Public License v3.0
"Discord", "DiscordApp" and any associated logos are registered trademarks of Discord Inc.