- TypeScript 98.4%
- CSS 0.7%
- JavaScript 0.7%
- Dockerfile 0.1%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
Yuri Cunha
84520ac5cf
Keep every identifier, path, migration name, systemd unit, endpoint and value verbatim; fix the escaped backticks the Portuguese version carried, and normalize section dates to the ISO format already used by the final section. The traducao.yuricunha.com hostname stays untouched. Co-authored-by: Ella Mizuki <[email protected]> |
||
| .github/workflows | ||
| .woodpecker | ||
| apps | ||
| deploy/systemd | ||
| docs | ||
| packages | ||
| prompts | ||
| .dockerignore | ||
| .env.docker.example | ||
| .env.example | ||
| .env.local.example | ||
| .eslintrc.cjs | ||
| .gitattributes | ||
| .gitignore | ||
| .node-version | ||
| .npmrc | ||
| .nvmrc | ||
| .releaserc.cjs | ||
| docker-compose.dockerhub.external-db.yml | ||
| docker-compose.dockerhub.internal-db.yml | ||
| docker-compose.example.yml | ||
| docker-compose.ghcr.external-db.yml | ||
| docker-compose.ghcr.internal-db.yml | ||
| docker-entrypoint.sh | ||
| Dockerfile | ||
| eslint.config.cjs | ||
| icon.png | ||
| inject-env.sh | ||
| knip.json | ||
| LICENSE | ||
| nginx-security-headers.conf | ||
| nginx.conf | ||
| package.json | ||
| pnpm-lock.yaml | ||
| pnpm-workspace.yaml | ||
| README.md | ||
| supervisord.conf | ||
| tsconfig.json | ||
Yue Discord Bot
A multifunctional Discord bot with a complete web dashboard for managing communities, moderation, entertainment and automation.
About
Yue started as a Discord bot and grew into a full community management platform.
The bot handles everyday Discord interactions while the web dashboard gives server administrators a cleaner way to configure features, inspect activity and manage the community without relying only on commands.
The project is actively used in production and is built as a monorepo containing the Discord bot, API, web panel and shared packages.
Self-hosting note: the source is public, but I do not provide support for custom or third-party deployments.
Highlights
- 🛡️ Moderation & security — bans, mutes, warnings, mod logs, AutoMod, AntiRaid, channel locks and audit tools.
- 📊 XP & community — levels, leaderboards, profiles, badges, birthdays, autoroles and member management.
- 🎉 Giveaways & events — giveaways, polls, events, suggestions, tickets and reaction roles.
- 💰 Economy & fun — luazinhas, bank, shop, inventory, coinflip, anime, Pokédex, pets, trivia and waifu/husbando systems.
- 🎵 Music — playback, queue, playlists, DJ controls and Lavalink support.
- ⭐ Community tools — welcome messages, starboard, keyword triggers, custom commands, fan arts and free-game notifications.
- ❤️ Support system — optional LivePix integration for support plans and automatic Discord role delivery after confirmed payments.
- ✨ Optional smart features — Discord chat assistant, panel assistant and automated content moderation when the related providers are configured.
Web dashboard
The dashboard is one of Yue's main parts. After signing in with Discord, administrators can manage their servers through a modern interface instead of configuring everything through slash commands.
It currently includes areas for moderation, AutoMod, AntiRaid, audit logs, members, giveaways, XP, autoroles, tickets, suggestions, reaction roles, starboard, welcome messages, music, custom commands, keyword triggers, support plans and more.
Owner-only tools are also available for global administration and panel configuration.
Tech stack
| Part | Technology |
|---|---|
| Discord bot | Node.js, TypeScript, Discord.js |
| API | Fastify |
| Web panel | React, Vite |
| Database | PostgreSQL, Prisma |
| Cache / queues | Redis |
| Music | Lavalink |
| Package manager | pnpm |
| Deployment | Docker |
Docker
Yue is published as a multi-architecture image for linux/amd64 and linux/arm64.
Docker Hub:
docker pull isyuricunha/yue-discord-bot:latest
GitHub Container Registry:
docker pull ghcr.io/isyuricunha/yue-discord-bot:latest
The repository includes Compose examples for both internal and external PostgreSQL setups, using either Docker Hub or GHCR images.
A simple starting point is:
cp .env.docker.example .env
# Fill in the required Discord, database and authentication values.
docker compose -f docker-compose.dockerhub.internal-db.yml up -d
Optional integrations such as Lavalink, LivePix, Mistral and OpenAI can be enabled through environment variables when needed.
Discord gateway recovery
Yue keeps the bot process alive when Discord temporarily rejects a gateway login. If Discord reports that the session-start limit is exhausted, Yue waits until the reset timestamp provided by Discord plus one second, then retries automatically. No container restart is required.
Other transient gateway login failures use exponential backoff capped at five minutes. To inspect the current gateway state in a Docker deployment:
docker logs --timestamps --tail 100 yuebot
Local development
Requirements
- Node.js 24+
- pnpm 10+
- PostgreSQL
- Redis
- A Discord application
Then:
git clone https://github.com/isyuricunha/yue-discord-bot.git
cd yue-discord-bot
cp .env.example .env
pnpm install
pnpm db:generate
pnpm db:migrate
pnpm dev
The development command starts the workspace services together. You can also run them separately:
pnpm dev:bot
pnpm dev:api
pnpm dev:web
Default development URLs:
- Web panel:
http://localhost:5173 - API:
http://localhost:3000
Project structure
apps/
├── bot/ Discord bot
├── api/ HTTP API
└── web/ React dashboard
packages/
├── database/ Prisma and database package
├── livepix/ LivePix integration
└── shared/ Shared code and types
prompts/ Runtime prompt files
Everything lives in a single pnpm workspace so the bot, API, panel and shared packages can evolve together.
Useful commands
pnpm dev # Run the development workspace
pnpm build # Build all applications and packages
pnpm lint # Run lint checks
pnpm type-check # Run TypeScript checks
pnpm test # Run tests
pnpm db:generate # Generate the Prisma client
pnpm db:migrate # Run database migrations
License
Yue Discord Bot is licensed under the GNU Affero General Public License v3.0.
See LICENSE for the full license text.
Shared Nobre with Vai Brasil!
Supporters who do not link accounts keep everything independent. The optional Vai Brasil! integration lets the bot and the translation portal share the same Nobre entitlement, preserving existing payments, roles and benefits.
Benefits and roles reconcile through an isolated REST worker, with no second Discord gateway and no restart of the main Yue runtime. Deployment steps and activation settings are documented in docs/SHARED-NOBRE-VAI-BRASIL.md. Synchronization stays disabled until the integration is validated.