← Back to Projects
sharks-bot/README.md

PID: sharks-bot | STATUS: ACTIVE

sharks — Discord Moderation Bot

sharks is a production Discord moderation bot built with discord.js v14, deployed 24/7 on Oracle Cloud VPS via PM2. It offers welcome/leave embeds, color and gender dropdown role menus, interest role buttons, moderation tools (ban, kick, mute, clear), info commands, and voice channel join/leave — all organized with auto-loading command handlers and centralized i18n via JSON locale files.

## Problem Solved

Growing Discord communities need automated moderation, self-service role assignment, and onboarding flows without relying on multiple third-party bots.

## Architecture & Approach

Modular src/commands structure (admin, general, voice) with dynamic loader. JSON-based per-guild settings store, select menu and button interaction handlers, deferred replies for network resilience, and @discordjs/voice for voice connections. Deployed with PM2 on Oracle Cloud Always Free tier.

## Tech Stack

Node.jsdiscord.js v14@discordjs/voicePM2Oracle Cloud VPS
Welcome Messages
sharksBOT

Hadi hep birlikte @YeniUye karşılayalım!

Sunucuya hoş geldin, @YeniUye!

Role Menus
sharksBOT
Rol Seçim Menüsü

Aşağıdaki menüden rolünü seç.

Kırmızı
Mavi
Yeşil
Moderation
🔨Moderasyon Logu
Az önce

Mute · @User123

Moderator tarafından uygulandı

Kick · @Spammer

Moderator tarafından uygulandı

Ban · @ToxicUser

Moderator tarafından uygulandı

Easy Setup
# Hoş geldin kanalını ayarla
/setup welcome-channel
channel: #hosgeldin
✓ Hoş geldin kanalı ayarlandı!
# Ayrılma kanalını ayarla
/setup leave-channel
channel: #ayrilanlar
Voice Channel

Genel Ses

sharks bağlandı