egg-shen-bot

Egg Shen Bot é um bot auto-hospedável e rico em recursos para Discord, focado em descoberta de entretenimento e atividades comunitárias. Ele pesquisa em sete tipos de mídia — filmes, séries, episódios, videogames, jogos de tabuleiro e livros — retornando embeds detalhados com sinopses e avaliações agregadas de várias fontes, além de links para a página de cada serviço sobre a mídia. As fontes de avaliação/links nomeadas incluem IMDb, Letterboxd, Trakt, Rotten Tomatoes e JustWatch, com disponibilidade de streaming tratada por meio da integração com TMDB e Watchmode. Além da pesquisa, o bot oferece um sistema de chaves de torneio que suporta fases de grupos de 4 a 12 grupos, wildcards e rodadas eliminatórias de eliminação simples. As ferramentas de festa de exibição incluem temporizadores, histórico de exibições e estatísticas do servidor, além de um comando de anúncio. Os recursos sociais incluem enquetes interativas, pesquisa de trilha sonora, um comando "poção mágica" e geração opcional de imagens por IA. Um recurso opcional de Solicitações de Eventos permite que membros da comunidade enviem solicitações de festa de exibição por meio de um formulário web usando Discord OAuth; moderadores aprovam ou negam, e eventos aprovados são criados como Eventos Agendados do Discord. O gerenciamento do servidor abrange permissões configuráveis, ativação/desativação de serviços de avaliação, preferências regionais e emojis personalizados por meio de um comando de configuração, além de comandos de moderação para reinicialização e estatísticas. O projeto documenta limitação de taxa integrada como proteção de custos, notificações/lembretes e estatísticas de uso. A implantação é auto-hospedada: cada instância é independente, usando seu próprio aplicativo Discord, seu próprio servidor e seus próprios arquivos de dados locais para configurações, temporizadores e torneios, sem backend compartilhado ou conta central. Os requisitos são Node.js 20 ou superior, um token de bot do Discord e uma chave de API do TMDB, com chaves opcionais para Watchmode, OMDb, Trakt, RAWG, Google Books e OpenAI. A configuração envolve clonar o repositório, instalar dependências, configurar um arquivo .env, implantar comandos de barra e iniciar o bot. O código é organizado para extensão em src/commands, src/services, src/utils, public (formulário web de solicitação de eventos) e docs (documentação VitePress), e é lançado sob a Licença MIT.