zekbot420

Learn more at: zekbot420.swagrelated.com

Your favorite Discord bot's open-source alternative.

• Ban / unban
• Kick
• Timeout / untimeout
• Clear messages
• Warn system (warn, unwarn, list warnings)
• Jail system
• Sticky roles system

• Leveling system
• Leaderboards
• Configurable XP system
• Role rewards

• Ping / uptime
• Avatar lookup
• Polls
• Help command
• Basic server/user info
• Translation (translate messages and text to almost any language)
• Emoji fetcher

• Logs support (stores moderation actions)
• Welcome setup + welcoming messages
• “Snipe” / “clearsnipe” style message recall

• Last.fm login and commands (optional; requires API key)
• Fortnite item shop and player stats (optional; requires fnbr.co and fortnite-api API keys, respectively)
• Rainbow Six Siege stats (optional; requires r6data.eu API key)

• Audio file playback in VC
• Info to see sample rate, bitrate, etc. of currently playing track
• Queue system
• Skip, stop, pause, resume controls
• SoundCloud & YouTube support

• Setup a "Join to Create" voice channel system
• Lock/unlock voice channels, kick users from channels, rename channels
• Usable by any server member

• Download and share videos from pretty much any video service. If yt-dlp supports it, we got it! (optional; requires yt-dlp and ffmpeg)

• Node.js (recommended: current LTS)
• npm (comes with Node.js)
• A Discord application + bot token
• Permissions to add a bot to a server (usually a role with Manage Server, or you can create a test server)

• yt-dlp (for video downloading features)
• Neon (or any postgres-compatible database)
• ffmpeg (required for audio playback in voice channel features, installs with npm install during install)
• Last.fm API key (for Last.fm integration features)

If you're interested in hosting your own version of zekbot420, visit the Getting Started wiki page. Everything you'll need to know is there from preresiquites to cloning the repo, installing packages and making the bot live is there.

If that's all good to go, read the Configuration page to learn how to set up modify zekbot420.

Simply head to your project root and, in your terminal, run:

node index.js

Or, if you prefer a package script (if present in package.json):

npm run start

Some features store data locally (for example: warnings/modlog/Last.fm configuration/audio files) and others on a PostgresSQL-database. For the local data, you’ll see data files under the data/ directory.

• index.js — bot entry point
• commands/ — message/prefix style commands (organized by category)
• slashCommands/ — slash command handlers/definitions
• welcoming.js / welcomesetup.js — welcoming flow
• storesnipe.js / snipe.js — message snipe support
• deploy-commands.js — registers slash commands with Discord
• data/ — local storage (warnings, modlog, downloads, audio)
• events/ — handlers for leveling XP (text, voice) & jail timing
• stickyrolesDbHandler.js — Postgres database handler for sticky roles
• stickyrolesHandler.js — primary sticky roles manager
• jailHandler.js — Postgres database and primary manager for the jail system
• leveling.js — Postgres database and primary manager for the leveling system

• Confirm the bot is invited with the right scopes/permissions:
  • bot
  • applications.commands (for slash commands)
• Re-run command deployment:

node deploy-commands.js

If your instance of zekbot420 is in mutliple servers, add a global at the end for it to deploy everywhere your bot is added.

node deploy-commands.js global

• Ensure the bot role is high enough in the server role hierarchy
• Ensure the bot has permission to manage messages/moderate members where needed

• Make sure the required Gateway Intents are enabled in the Discord Developer Portal for your bot (and configured in code if applicable)

If you have issues that aren't listed here or just have general questions, visit the bot's support page.

Contributions are welcome—bug fixes, new commands, improvements to docs, etc.

Suggested workflow:

1. Fork the repo
2. Create a feature branch
3. Make changes
4. Open a PR with a clear description and testing notes

This project is licensed under the MIT license.