MythEclipse
cc6975825f
- Added BOOSTER_ELIGIBILITY_ROLE_ID and LOG_LEVEL to .env.example and README.md - Updated GitHub Actions workflow to include new environment variables - Enhanced configuration loading to support booster eligibility role - Implemented role checking logic in bot handlers and guild member updates - Introduced logging using Winston for better traceability of actions - Created tests for guild member update handling to ensure correct role removal - Refactored DiscordRoleRepository to simplify role position resolution
Booster Role Bot
Discord bot untuk memberi role custom kosmetik ke user yang sedang boost server. Role dibuat oleh bot, tidak boleh mengambil role yang sudah ada, dan otomatis dihapus saat user tidak lagi eligible.
Tech stack
- Bun + TypeScript
- discord.js
- PostgreSQL via Drizzle ORM
- Bun test runner
Prasyarat
- Bun terinstall
- Bot Discord dengan token dari Developer Portal
- Test guild/server Discord
- Bot punya permission
Manage Roles - Posisi role bot harus lebih tinggi dari role custom yang akan dibuat
Setup
bun install
cp .env.example .env
Isi .env:
DISCORD_TOKEN=token_bot_discord
DISCORD_CLIENT_ID=client_id_aplikasi_discord
DISCORD_GUILD_ID=id_server_discord
DATABASE_URL=postgresql://booster_role:booster_role@localhost:5432/booster_role
BOOSTER_ROLE_ANCHOR_ROLE_ID=id_role_pembatas_opsional
BOOSTER_ELIGIBILITY_ROLE_ID=1206431347925852162
LOG_LEVEL=info
BOOSTER_ROLE_ANCHOR_ROLE_ID dipakai sebagai batas posisi role. Role booster custom harus berada di bawah role ini agar tetap kosmetik dan tidak menyentuh role staff/admin.
Database
Generate dan jalankan migration setelah schema siap:
bun run db:generate
bun run db:migrate
Pastikan DATABASE_URL mengarah ke database PostgreSQL external sebelum menjalankan migration.
Menjalankan bot
bun run dev
Saat startup, bot otomatis register slash command ke guild dari DISCORD_GUILD_ID, lalu menangani interaction command. Pastikan bot di-invite dengan scope applications.commands.
Testing
bun test
bun test src/domain/roleGuards.test.ts
bun run typecheck
bun run lint
Keamanan role
Bot ini dirancang supaya aman dari abuse:
- User tidak bisa claim role Discord yang sudah ada.
- Claim selalu membuat role baru yang dikelola bot.
- Rename, recolor, dan delete hanya berlaku untuk role yang tercatat di database sebagai milik user tersebut.
- Role custom dibuat dengan permission kosong.
- Icon/logo role opsional hanya bisa dipasang ke role bot-managed milik user tersebut.
- Attachment icon harus berupa image dan dibatasi ukuran agar tidak disalahgunakan.
- Permission berbahaya seperti
Administrator,ManageRoles,ManageChannels,BanMembers,KickMembers,MentionEveryone,ManageGuild, danManageWebhooksditolak. - Jika user tidak punya role booster eligibility dari
BOOSTER_ELIGIBILITY_ROLE_ID, claim ditolak.
Slash command target
Command utama yang disiapkan:
/booster-role claim name color icon- claim role custom baru, dengan icon opsional./booster-role rename name- rename role milik sendiri./booster-role recolor color- ubah warna role milik sendiri./booster-role icon image- pasang atau ganti logo/icon role milik sendiri./booster-role delete- hapus role milik sendiri./booster-role admin-delete user- admin dengan permissionAdministratorbisa hapus role custom user lain. User target bisa claim lagi jika masih eligible.
Catatan eligibility boost
Untuk sekarang, user eligible jika punya role dari BOOSTER_ELIGIBILITY_ROLE_ID. Jika role ini hilang dari user, role bot-managed miliknya akan dihapus lewat event guildMemberUpdate.