Skip to content

A powerful and fully customizable Discord bot designed for server administration. Featuring advanced moderation tools, a ticketing system, automated moderation, customizable welcome messages, and more. Built with flexibility in mind, AdminBot is free, open-source, and tailored for ease of use in managing your server.

License

Notifications You must be signed in to change notification settings

TheHolyOneZ/ZygnalBot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ZygnalBot – The Signal You’ve Been Waiting For.

We aim to destroy paywalls, bring knowledge to everyone, and deliver precision—all powered by Germany.


NOTE: ZygnalBot is for Self hosting!

👉 Click Here to Join TheZ's ZygnalBot!

  • Open a ticket
  • Get the bot/script in an instant
  • And when u got the bot star this repo

User Ratings Summary

Based on feedback from our users who use this bot, here’s how the project was rated:

Customization: ⭐ 5.0 / 5.0

Features: ⭐ 5.0 / 5.0

Reliability: ⭐ 4.83 / 5.0

Thank you to everyone who participated in providing feedback! Your input helps make this project better every day.

If u want the script feel free to join my ZygnalBot discord

Real owner id (me): 1284210833869639680 Now Called ZygnalBot

Feature Comparison (against the PAID versions of these bots)

Feature ZygnalBot MEE6 (Premium) Dyno (Premium) Carl-Bot (Premium)
Moderation Commands
- Ban/Kick/Warn
- Clear Messages
- Mute with Duration ✅ (Premium-only)
Advanced Logging ❌ (Limited) ✅ (Premium-only)
- Action Logging ✅ (Premium-only) ✅ (Premium-only)
- Ticket Transcript Logging
- Overall Logger (Webhook Logging)
Ticket System ✅ (Premium required for advanced features)
- Button-based Claim and Close
- Add/Remove Users in Tickets
- Admin Role Assignment
- Ticket Logs
Server Management Tools
- Lockdown/Unlock Channels
- Slowmode Configuration
- Announcement Command ✅ (Premium-only)
Dynamic Status Updates
- Rotating Status Messages
- Status Reflecting Server Stats
Custom Commands ✅/❌ ✅ (Premium-only) ✅ (Premium-only) ✅ (Premium-only)
Embed Message Customization ✅ (Premium-only) ✅ (Premium-only)
- Customizable Colors & Fields ✅ (Premium-only) ✅ (Premium-only)
Role Management with Panels ✅ (Premium required for advanced features)
- Reaction-based Role Assignment
Welcome System (Highly Configurable) ✅ (Premium-only)
- Placeholders for User/Server ✅ (Premium-only)
- Configurable Welcome Message ✅ (Premium-only)
Auto-Moderation ✅ (Premium-only for advanced settings)
- Caps/Spam/Banned Word Detection ✅ (Premium-only for fine-tuning)
- Configurable Thresholds ✅ (Premium-only for advanced settings)
Activity and Member Tracking ✅ (Premium-only) ✅ (Premium-only)
- Server/Member Stats ✅ (Premium-only) ✅ (Premium-only)
- User Information Commands ✅ (Premium-only) ✅ (Premium-only)
Free and Open Source
Pricing Free Paid (Premium required for many features) Paid (Premium required for many features) Paid (Premium required for many features)
Analyze Commands
Custom Invite Links ✅ (Premium-only) ✅ (Premium-only)
Full Server Backup ✅ (Premium-only) ✅ (Premium-only)
Full Config Backup ✅ (Premium-only) ✅ (Premium-only)
Owner Panel
Invite Tracker (super advanced)
Discord Setup
Full Implented Level System
Custom Prefix ✅(via .env)
Verification System

Notice:

  • Invite Tracker (super advanced) is a unique feature currently available only in ZygnalBot. This feature tracks which invite link was used by new members to join your server.

Please note:

  • The tracking works only from the moment it's enabled and cannot retroactively track invites for members who joined before it was activated.
  • The bot provides real-time tracking and will show invite usage for members who join after the feature is enabled. This feature is not available in MEE6, Dyno, or Carl-Bot at this time.
Feature ZygnalBot MEE6 (Premium) Dyno (Premium) Carl-Bot (Premium)
Basic Reminder Command
Custom Reminder Duration
Customizable Reminder Colors
Reminder with Channel Specification
Embedded Reminder Messages
Reminder Management (Editing)

Snipe Features

Feature ZygnalBot MEE6 (Premium) Dyno (Premium) Carl-Bot (Premium)
Snipe Features ✅ (Partial)
- Deleted Message Sniping
- Edited Message Sniping
- Adjustable Snipe Duration
- Snipe Information Command
- Cooldown Management for Sniping

Leveling Features

Leveling Feature ZygnalBot MEE6 (Premium) Dyno (Premium) Carl-Bot (Premium)
Basic Leveling System (Free) ✅ (Premium Only) ✅ (Premium Only)
!set_level_role <level> <role> (Auto-role for levels)
!leaderboard (Server XP rankings)
!my_level (Check personal XP & level)
!set_xp <user> <xp> (Manually set XP) (Bot Owner Only)
!reset_levels (Reset leveling data) (Bot Owner Only)
!set_leaderboard_channel <channel> (Live leaderboard updates)
!add_achievement <name> <level> <reward> (Custom achievements) (Unique Feature!)
!set_xp_multiplier <role> <multiplier> (XP boost for roles) (Unique Feature!)
!levelsetup (View current settings)
!levelsetup <channel> (Set leveling announcements)

Verification Feautures

Feature ZygnalBot (Free) MEE6 (Premium Only) Dyno (Premium Only) Carl-Bot (Premium Only)
Multi-Level Verification ✅ (Easy, Medium, Hard)
Custom Verification Timeout ✅ (Configurable per level)
Email Verification Check
Phone Verification Check
Multi-Factor Authentication Check
Minimum Account Age Check ✅ (Configurable per level)
Profile Picture Requirement ✅ (Configurable per level)
Automatic Role Assignment ✅ (After verification)
Logging System ✅ (Logs to set channel) ❌ (Limited) ❌ (Limited) ✅ (Basic Logs)
Verification Status Commands ✅ (!verify stats)
Customizable Verification Messages
Auto-Kick on Verification Failure
Manual Verification Override ✅ (Admin command)
Integration with Role Management
Bot DMs User on Failure ✅ (Explains rejection reason)
Supports Multiple Servers

Bot Verification System

Feature ZygnalBot (Free) MEE6 (Premium Only) Dyno (Premium Only) Carl-Bot (Premium Only)
Automatic Bot Detection
Bot Whitelist System
Dedicated Logging Channel
Auto-Kick Unauthorized Bots
Bot Join Notifications
Bot ID Tracking
Whitelisted Bots List
Owner-Only Bot Management
Easy Bot ID Copy
Toggle Logging System
Detailed Join Logs
Server-Specific Settings
Simple Setup Commands
Instant Bot Protection

RolePanel Feature Comparison

Feature ZygnalBot (Free) MEE6 Dyno Carl-Bot
Custom Panel Themes (Premium only)
Animated Buttons
Custom Emojis (Limited Free, Full in Premium)
Multiple Layouts (Premium only) (Limited Free, Full in Premium)
Dynamic Colors (Now supports hex & decimal) (Premium only)
Custom Icons (Premium only)
Role Requirements (Premium only) (Premium only) (Premium only)
Group Roles (Premium only) (Premium only) (Premium only)
Temporary Roles (Premium only) (Premium only) (Premium only)
Role Limits (Premium only) (Premium only)
Role Categories (Premium only) (Premium only)
Role Chains (Premium only)
Permission Checks (Improved error handling) (Premium only) (Premium only) (Premium only)
Role Hierarchy (Premium only) (Premium only) (Premium only)
Anti-Abuse System (Premium only)
Rate Limiting (Premium only)
Role Conflicts (Premium only)
Advanced Role Panel (JSON) (New: !rolepanel_json for Discohook format, multiple embeds, per-embed button control)
Automatic Role Creation (New: Roles auto-created if missing in JSON panels)
Exclusive Role Groups (New: Support for exclusive role groups in JSON panels)
Enhanced Embed Styling (New: Improved footer styling, visual feedback, & animations)
  Command: !rolepanel

Rating System Feature Comparison

Feature ZygnalBot MEE6 (Premium) Dyno (Premium) Carl-Bot (Premium)
Button-Based Rating System
Interactive Rating Panels
Real-Time Updates
Customizable Rating Panels
- Custom Titles & Descriptions
- Configurable Button/Embed Colors
- Multiple Rating Types (Stars/Numbers/Percent)
- Channel Targeting
- Interactive Setup Modal
Admin Commands
- !ratingsetup
- !seerating (View active panels, edit, delete)
- !ratingrefresh <panel_id> (Refresh stats)
Rating Types
- ⭐ Stars (1-5)
- 🔢 Numbers (1-10)
- 📊 Percentages (0%, 25%, 50%, 75%, 100%)
Panel Features
- One-Click Rating Submission
- Real-Time Statistics Viewing
- Visual Vote Distribution
- Admin Refresh Capability
- Beautiful Embed Displays
Technical Improvements
- Persistent Data Storage
- Error Handling
- Permission Management
- Cross-Channel Support

Mood Tracker

Feature ZygnalBot (Free) MEE6 (Premium) Dyno (Premium) Carl-Bot (Premium)
Mood Tracking ✅ Yes ❌ No ❌ No ❌ No
Role-Based Mood Prompts ✅ Yes ❌ No ❌ No ❌ No
Anonymous Mood Logging ✅ Yes ❌ No ❌ No ❌ No
Mood Analytics & Reports ✅ Yes ❌ No ❌ No ❌ No
Mood Streak System ✅ Yes ❌ No ❌ No ❌ No
Custom Mood Prompts ✅ Yes ❌ No ❌ No ❌ No
Automated Mood Checks ✅ Yes ❌ No ❌ No ❌ No
JSON Data Storage ✅ Yes ❌ No ❌ No ❌ No
Configurable Notification Frequency ✅ Yes ❌ No ❌ No ❌ No
Test Mode for Debugging ✅ Yes ❌ No ❌ No ❌ No
Opt-in/Opt-out System ✅ Yes ❌ No ❌ No ❌ No
   !mood

Idea System Feature Comparison

Feature ZygnalBot (Free) MEE6 (Premium) Dyno (Premium) Carl-Bot (Premium)
Idea Submission System ✅ Yes ❌ No ❌ No ❌ No
Custom Title Prefix ✅ Yes ❌ No ❌ No ❌ No
Anonymous Submissions ✅ Yes ❌ No ❌ No ❌ No
Auto Thread Creation ✅ Yes ❌ No ❌ No ❌ No
Voting System ✅ Yes ❌ No ❌ No ❌ No
Category System ✅ Yes ❌ No ❌ No ❌ No
Customizable Appearance ✅ Yes ❌ No ❌ No ❌ No
Separate Channel Setup ✅ Yes ❌ No ❌ No ❌ No
Anti-Spam Protection ✅ Yes ❌ No ❌ No ❌ No
Character Limits ✅ Yes ❌ No ❌ No ❌ No
Cooldown System ✅ Yes ❌ No ❌ No ❌ No
Easy GUI Setup ✅ Yes ❌ No ❌ No ❌ No

Music System

Feature ZygnalBot (Free) MEE6 (Premium) Dyno (Premium) Carl-Bot (Premium)
Music System ✅ Yes ❌ No ❌ No ❌ No

Backup/config

Feature ZygnalBot MEE6 Dyno Carl-Bot
Moderation Commands
Full Server Backup ✅ (Premium-only) ✅ (Premium-only)
Full Config Backup ✅ (Premium-only) ✅ (Premium-only)
Channel Backup & Restore
Role Backup & Restore
Message History Backup
File & Media Backup
Permission Backup ✅ (Premium-only) ✅ (Premium-only)

AI/ChatGPT Functions

AI Features ZygnalBot MEE6 (Premium) Dyno (Premium) Carl-Bot (Premium)
AI Chat System
**Image Generation Not Tested**
Content Analysis
Multiple AI Models
Customizable Personalities
Response Style Control
Context Memory
Interactive Settings Panel
GPT-4 Support
GPT-3.5 Support
AI Credit Management
Model Selection & Pricing
Channel-Specific AI Settings
Conversation History Tracking
Real-Time AI Status Tracking
Rate Limiting System
Guild-Specific Configurations
Embedded Feedback System
Administrator Controls
Visual AI Status Indicators
Error Handling & Notifications
  *Note: Using AI features requires an OpenAI API key with sufficient credits ($0.002-$0.03 per message depending on model)*

AFK system (advanced)

AFK Feature ZygnalBot MEE6 Dyno Carl-Bot
Set AFK Status
Custom AFK Message
AFK Status Auto-Removal
Mentions Notify AFK Status
Timestamp of AFK Start
AFK Notification on Mention
Nickname Change with AFK Tag ✅ (Premium)
AFK Status in Multiple Guilds
AFK List Storage & Management
Cooldown for AFK Command

Custom Embeds Feature Comparison

Custom Embeds Feature ZygnalBot (Free) MEE6 (Premium) Dyno (Free) Carl-Bot (Free)
JSON-Based Embed Creation
Discohook Format Support
Direct JSON Input
File Attachments in Embeds
Custom Embed Colors ✅ (Premium)
Custom Button Colors
Multiple Color Combinations
Embed Error Handling
Embed Success Reactions
Help Command for JSON Embeds

Webhook Dashboard Feature Comparison

Webhook Dashboard Feature ZygnalBot (Free) MEE6 (Premium) Dyno (Free) Carl-Bot (Free)
Create Webhooks ✅ (Premium)
Delete Webhooks
List Active Webhooks
Edit Webhook Name
Edit Webhook Avatar
Edit Webhook Channel
Send Test Message
Webhook Error Handling
Embed-Based Management UI
Ephemeral Interaction Support
Webhook Success Notifications

Ads System/Advertisment Functions

Feature ZygnalBot (Free) MEE6 (Premium) Dyno (Free) Carl-Bot (Free)
Complete Advertisement Management
Button-Based Interaction System
Ad Analytics (Views, Clicks, Bumps)
Customizable Advertisement Templates
Advertisement Search Functionality
Channel-Specific Ad Management
Automated Expired Ad Cleanup
Bump System (6-Hour Cooldown)
Backup and Restore for Ads
Blacklist System for Moderation
Advanced Audit System (Ad Tracking)
Discord Invite Links
Role-Based Verification System
Customizable Verification Messages
Dynamic Role Management
Placeholder Support in Messages
Setup Wizard for Easy Configuration
Verification Logging
Role Hierarchy Management
Custom Success Messages
Admin Controls for Verification
Help Command with Setup Guide

Analytics

Feature ZygnalBot MEE6 Dyno Carl-Bot
Advanced Analytics Dashboard (New: Predictive Trend Analysis, Role Progression, Heatmaps, Community Monitoring)
Activity Heatmap (24-hour visualization, Peak/Quiet hours, Real-time tracking)
Role Progress Tracking (Hierarchy display, Distribution stats, Member tracking)
Predictive Trends (Growth forecasts, Trend analysis, Content predictions, Health scoring)
Analytics Commands (New: !analytics server/user/export/import)
Enhanced Data Collection (Real-time processing, Optimized DB, Advanced caching)
Member Growth Analytics (Growth rate, Seasonal trends, Trend strength indicators)
Message Activity Tracking (Message frequency, Reaction rates, Voice tracking, Engagement metrics)
Content Analysis (Content distribution, Engagement trends, Topic detection)
Community Health Monitoring (Health scoring, Risk detection, Improvement suggestions)
Optimized Async Performance (Enhanced response times, Better handling of large servers)

Study & Development Tools

Feature ZygnalBot MEE6 Dyno Carl-Bot
Study Tools
Grade Calculator
GPA Calculator
Study Timer
Pomodoro Timer
User-Specific Timers
Coding Tools
Color Picker
Base Converter
String Encoder/Decoder
Hash Calculator
Live Color Preview
Math & Physics
Unit Converter
Physics Calculator
Geometry Calculator
Statistics Tools
Time Tools
Timezone Converter
Date Calculator
Meeting Scheduler
Project Planner

Fun/Utils and more

Feature ZygnalBot MEE6 Dyno Carl-Bot
URL Shortener System
QR Code Generator/Reader
Password Generator
Morse Code Converter
Barcode Generator & Scanner
ASCII Art Generator
IP Lookup System (!iplookup)
URL Checker (!urlchecker)
File Size Converter (!convert)
File Type Identifier (!identify)
Download Time Calculator (!downloadcalc)
Interactive Periodic Table
Advanced RNG System

|ZygnalBot: ✅ 100% Free & Open Source|

|Others: ❌ Freemium (Some Features Require Payment)|


Infos About the Code

  • Language: Python
  • Python Version: 3.12.7
  • Discord.py Version: 2.4.0
  • Line Count: 20962
  • License: Dual License (Proprietary Core + MIT Extended Features)
  • Size in kB: 890kB - 914kB

Last Updated: 2025-02-28


Detailed Feature Breakdown

1. Moderation Commands

ZygnalBot provides a full suite of moderation tools to keep your server safe:

  • !ban <user> [reason]: Permanently ban a user.

  • !kick <user> [reason]: Remove a user from the server.

  • !mute <user> <duration> [reason]: Temporarily mute a user with a specified duration.

  • !unmute <user>: Unmute

  • !warn <user> [reason]: Issue warnings to members.

  • !clear <amount>: Bulk delete messages in a channel.

  • !purge <user| bots | links> <amount/nuke>: "Purge messages from a user, bots, or links

  • !nuke: Completely cleans a channel.

  • !vcmute <user>: Mutes a user in a voice call.

  • !vcunmute <user>: Unmutes a user in a voice call.

  • !mutesetup <role>: who ever gets muted gets this role you configured with that command

2. Advanced Logging

Keep track of server activities with detailed logs:

  • Moderation actions such as bans, kicks, mutes, and warnings are logged.
  • Ticket logs, including transcripts, are automatically saved in a dedicated #ticket-logs channel.

3. Ticket System

ZygnalBot offers a robust ticketing system for user support:

  • Button-based interaction for claiming and closing tickets.
  • Add or remove users dynamically to collaborate on resolving issues.
  • Automatic logging and transcription of ticket discussions.
  • !ticketsetup <title> <message> <color> Creates a ticket panel where members can create a ticket and also opens a windwo before creating the ticket where they can describe the issue
  • !ticketadmin <role> Sets the role that will autoamtically be added to the ticket

4. Server Management Tools

Enhance server management with powerful tools:

  • !lockdown [channel] [duration]: Restrict sending messages in a channel, now with optional duration.
  • !unlock [channel]: Reopen a previously locked channel.
  • !slowmode <seconds>: Set a cooldown between messages.
  • !announce <color/hex code> <channel> <message>: Create a server announcement. If links are included, the bot will create a separate overview of the links.
  • !massrole <role>: Adds a specific role to all users on the server at once.

5. Dynamic Status Updates

Keep your server engaged with rotating status updates:

  • Customizable status messages reflecting server stats like member count and activity.

6. Role Management

Streamline role assignment with:

  • Reaction-based role panels for self-assignment.
  • Commands like !addrole <user> <role> and !removerole <user> <role> for admins.

7. Welcome System

Customize user onboarding:

  • Placeholders like {user}, {server}, and {count} allow personalized welcome messages.
  • Commands to configure the color, channel, and content of welcome messages.

8. Auto-Moderation

Ensure a safe environment with automated moderation:

  • Detection of caps, spam, and banned words with configurable thresholds.
  • Flexible settings to suit different server needs.
  • Enhanced !automod spam_threshold with custom timeout durations for spamming.

Automod Commands:

  • caps_threshold: Configure the tolerance for caps in messages.
  • spam_threshold: Set the number of repeated messages to trigger spam detection.
  • spam_interval: Define the time window for spam detection.
  • banned_words: Add or remove words for automated filtering.
  • link_whitelist: Manage a list of allowed links.

Usage:

  • !automod <configuration> <value>

Example:

  • !automod caps_threshold 5
  • !automod spam_threshold 4 10 (4 messages allowed within 5 seconds; 10-second timeout)
  • !automod banned_words BADWORD
  • !automod link_whitelist https://www.example.com

9. Information and Analytics

Gain insights into server and user activity:

  • !serverinfo: Display server stats like member count and creation date.
  • !userinfo [user]: Retrieve detailed information about a user.
  • !roles: List all server roles and their member counts.
  • !stats: Show bot statistics including uptime and server count.
  • !servericon: Displays the server icon in full size.
  • !avatar <user>: Displays a user's avatar in full size.
  • !ping: Shows the bot's response time.

10. Polls and Embeds

Create engaging content:

  • !poll: Creates a reaction-based poll.
  • !embed: Creates a custom embed message.
  • !say <message>: Makes the bot send a message.

11. Full Server Backup and Restore

Ensure the safety of your server's configuration and content:

  • !backup: Creates a full backup of the server, including channels, roles, server settings, attachments, and messages/emojis.
  • !restore <backup_file>: Restores the server to a previously backed-up state.

12. Full Config import and export

Included Settings • Welcome System • Ticket System • AutoMod • Role Management • Server Management

  • !export: Exports the entire bot configuration as a JSON file.
  • !import <json_file>: Imports a configuration from a JSON file.

13. MiniGames

  • !numbergame <number> <channel>: Lets admins create a number game.
  • <number>: If nubmergame started players can enter numbers in the channel it started to guess it.
  • !tictactoe: lets u start a tictactoe game.

Easy to use will give a announcement in the channel where game was started and a win announcement when someone wins.

14. Owner Panel

  • !owner: Opens a panel for owner-only commands.
  • !executecmd <guild_id> <channel_id> <command>: Execute commands in other servers
  • !leaveserver <guild_id>: Make bot leave a specific server
  • !botinfo: View detailed bot statistics Also if u do !owner it will give you a panel with interactive buttons like Statics and server lists

15. Custom Invites

  • !invite <duration> <max uses>: Create an invite link for a channel with customizable duration and max uses
  • !invite_view: Show all invite links and information about them

Usage Example: !invite 32 21

output:

image

16. OverAll Logger

  • Logs all actions in the server. (in form of messages and files being sent)
    • It will log everything that is being sent in the server and send it to a webhook. (customize webhook in .env)

17. Analysis

  • !analyse: Shows status of analyze

cmds: !analyse <daily|weekly|monthly>

Gives you a analyze of the server daily like members joined monthly/daily if invites created inactive active and more.

18 View_historic

  • !view_historic Lets u see who joined with waht invite code

    look at the latest changelogs!

19. Setup Discord Server

  • !setup: Creates a Discord Server from scratch (eg. Roles,channels, permissions, etc.)

    • Creates a full discord with channels, locked channels, roles with specific permissions and hirachy

         "📜 Information": ["📌 rules", "📢 announcements"],
         "💬 General": ["💬 general-chat", "😂 memes"],
         "🔒 Admin Only": ["🔧 admin-chat", "📜 admin-logs"],
         "🤖 Bot Commands": ["⌨️ bot-commands", "📝 bot-logs"],
         "🎤 Voice Channels": ["🎤 General VC", "🎶 Music VC"],
         "🎮 Gaming": ["🎮 gaming-chat", "🕹️ game-logs"],
      
    • Roles

      • Owner, Bot (owner-level), member, admin, mod, bot (locked-down)

Full Leveling System

  • !set_level_role | Assign a role to a specific level.|
  • !leaderboard | Display the server's leveling leaderboard.|
  • !my_level | Check your current level and XP.|
  • !set_xp <user> <xp> | Set a user's XP manually (Bot Owner only).|
  • !reset_levels | Reset all leveling data for the server (Bot Owner only).|
  • !set_leaderboard_channel <channel> | Set the channel for live-updating |leaderboard.|
  • !add_achievement <name> <required_level> <reward> | Add a new achievement (Bot Owner only).|
  • !set_xp_multiplier <role> <multiplier> | Set an XP multiplier for a role (Bot Owner only).|
  • !levelsetup | Shows All infos/settings of the leveleling system|
  • !levelsetup <channel> | "Sets the channel where the leveling messages are sent|

Remind Functions

  • !editreminder | Edit ur reminders with a panel
  • !reminder Opens reminder panel where u can easily create a reminder

Verification System

  • 🛡️ Security Setup

    • !verify | Opens the verification menu
  • 🔐 Security Setup

    • !verify <easy/medium/hard> <timeout duration | optional>
  • 📊 Statistics Viewer

    • !verify stats
  • 📝 Logging Configuration

    • !verifychannel #channel

      There is also a command called !verificationrole <role>    | That is basically a role that is given to the user when they are verified so if u configure it it would give them the verifed role plus the role u configured with !verificationrole <role>
      

Bot Verification System Commands

Admin Commands

  • !botlogs #channel - Sets the logging channel for unauthorized bot joins
  • !botlogs - Disables the bot join logging
  • !whitelisted - Displays a list of all whitelisted bots with names and IDs

Owner Commands

  • !whitelist_bot <bot_id> - Adds a bot to the whitelist

Rating System

| Admin Commands

  • !ratingsetup
  • !seerating (View active panels, edit, delete)
  • !ratingrefresh <panel_id> (Refresh stats)

| Rating Types

  • ⭐ Stars (1-5)
  • 🔢 Numbers (1-10)
  • 📊 Percentages (0%, 25%, 50%, 75%, 100%)

Complete Command List (Does not Have all the commands read above for everything or install the bot and use !panel

Moderation Commands

  • !ban <user> [reason]
  • !kick <user> [reason]
  • !mute <user> <duration> [reason]
  • !warn <user> [reason]
  • !clear <amount>
  • !purge <user| bots | links> <amount/nuke>
  • !nuke
  • !vcmute <user>
  • !vcunmute <user>
  • !nickname <user_id> <nickname>

Server Management Commands

  • !lockdown [channel] [duration]
  • !unlock [channel]
  • !slowmode <seconds>
  • !announce <message>
  • !massrole <role>
  • !addrole <user> <role>
  • !removerole <user> <role>
  • welcome: Lets you configure the welcome message, color, and channel.

Ticket System Commands

  • !ticketsetup <title> <message> <color>
  • !ticketadmin <role>
  • !add <user>
  • !remove <user>
  • !close

Information Commands

  • !serverinfo
  • !userinfo [user]
  • !roles
  • !stats
  • !servericon
  • !avatar <user>
  • !ping

Automod Configuration

  • caps_threshold
  • spam_threshold
  • spam_interval
  • banned_words
  • link_whitelist

Polls and Embeds

  • !poll
  • !embed
  • !say <message>

Backup and Restore

  • !backup
  • !restore <backup_file>

Config import and export

  • !importconfig <config_file>
  • !exportconfig

MiniGames

  • !numbergame <number> <channel>: Lets admins create a number game.
  • <number>: If nubmergame started players can enter numbers in the channel it started to guess it.
  • !tictactoe: lets u start a tictactoe game.

Custom Invites

  • !invvte <duration> <max uses>: Create an invite link for a channel with customizable duration and max uses
  • !invite_view: Show all invite links and information about them

Analyze

  • !analyse
  • !analyse <daily|weekly|monthly> <channel>

View_historic

  • !view_historic

Level system commands

  • !set_level_role <level> <role>
  • !leaderboard
  • !my_level
  • !set_xp <user> <xp>
  • !reset_levels
  • !set_leaderboard_channel <channel>
  • !add_achievement <name> <required_level> <reward>
  • !set_xp_multiplier <role> <multiplier>
  • !levelsetup
  • !levelsetup <channel>

reminder

  • !editreminder
  • !reminder

With all these features, ZygnalBot ensures a comprehensive management experience. Plus, it includes over 1600+ banned words in its default automod configuration, ensuring safety and compliance. And you know what’s crazy? It’s entirely free and open source.

  • View Inside a Ticket

image

  • !panel

image

  • !analyse

image

GUIDE

How to Set Up Bot Permissions in Discord

1. Create Roles for Your Bot

To ensure your bot functions as needed, you need to create at least two roles:

  • Bot Role (Top Hierarchy): This role will have all the necessary permissions for the bot to interact with the server. This role should be at the top of the role hierarchy.
  • Secondary Role (Lowest Hierarchy): This role will be optional for the bot and is mainly for organizational purposes. It won't grant any permissions but can be placed anywhere in the member list (e.g., above owner, below admin, or below members) depending on your preference.

2. Setting Up the Bot Role

  • Step 1: Go to Server Settings > Roles.
  • Step 2: Click on the + (Create a New Role) button to add a new role.
  • Step 3: Name this role something like "Bot" or "Bot Permissions".
  • Step 4: Assign all permissions that the bot needs to function (e.g., Manage Messages, Send Messages, Manage Roles, Administrator).
  • Step 5: Place this role at the top of the hierarchy. This ensures that the bot can manage other roles and messages. To do this:
    • Under the Roles tab in Server Settings, click and drag this new "Bot" role to the top of the list of roles.

3. Setting Up the Secondary Role

  • Step 1: Create a Secondary Role for the bot. This role may not have any permissions but is necessary for organizing the bot within the server.

  • Step 2: Name this role something like "Bot Secondary" or just "Bot Role" (whatever works for your setup).

  • Step 3: Assign this role at the bottom of the hierarchy.

    • Under Server Settings > Roles, drag this role to the very bottom of the role list.

    Note: The secondary role is mainly for organizing the bot's position in the member list on the side of Discord. It doesn't need to have permissions but can be used to place the bot above, below, or among specific roles (such as above the owner, below admins, or below members), depending on where you want it to show up.

4. Assigning Roles to the Bot

  • Step 1: Go to your Discord server and click on the Members list.
  • Step 2: Find your bot in the list of server members.
  • Step 3: Right-click on the bot’s name, then click on Roles > Assign both the Bot Role (top of hierarchy) and Secondary Role (lowest in hierarchy).

5. Sorting by Hierarchy

  • After assigning the roles, you need to ensure that the roles are sorted by hierarchy.
  • In the Role Settings, under the Roles section, the topmost role will have the highest priority, and the lowest role will have the lowest priority. Ensure your bot’s main role is at the top.

6. Adjusting Permissions (if necessary)

  • If your bot is not able to access certain channels or perform actions, it might be because the bot's role is not properly prioritized.
  • Make sure no other roles with higher priority restrict access to the necessary permissions for the bot.

Final Steps:

  • Test the bot: Once the roles are set up, test the bot by asking it to perform tasks (such as sending messages or managing roles) to ensure that it has the required permissions.
  • Sort Roles: Ensure that roles are sorted in the correct order in Server Settings > Roles tab (Bot Role at the top and Secondary Role at the bottom).

Quick Recap of Hierarchy and Permissions:

  • Bot Role (Top): Has all permissions needed for bot operation.
  • Secondary Role (Bottom): Can be used for organizational purposes (it does not have any permissions), and determines the bot’s position in the member list.
  • Role Hierarchy: Make sure to sort by hierarchy in Server Settings > Roles to keep the correct order. Place the bot's secondary role at the preferred position in the member list (above owner, below admin, or below members).

Why Two Roles for the Bot?

Using two roles for your bot helps to separate its permissions from its visibility and organization within the server.

The main bot role (at the top of the hierarchy) grants all the necessary permissions the bot needs to interact with channels, manage messages, and perform its tasks.

The secondary role (at the bottom of the hierarchy) is purely for organizational purposes. It doesn’t have any permissions but determines the bot's position in the member list on the side of Discord, allowing you to control whether the bot appears above, below, or among specific roles like the owner or admins.

one last thing if u got multipel server adn want the same code/bot for it there is also a owner panel where u can hardcode ur discord id in it to execute cmd remotly annoucne leave servers u dont want the bot to be etc.

What is a .env File and Why Do You Need It for ZygnalBot?

A .env file (short for environment file) is a simple text file that stores environment variables. These variables are key-value pairs used to configure software applications without directly hardcoding sensitive or environment-specific data into your code.


Why Use a .env File for ZygnalBot?

ZygnalBot uses a .env file to securely store essential configuration details and credentials required for its operation. This approach provides several key benefits:

1. Secure Storage of Sensitive Data

  • Important credentials like Discord bot tokens and webhook URLs should not be directly included in the source code. Storing them in a .env file keeps them private and prevents accidental exposure on public platforms like GitHub.

2. Environment-Specific Configuration

  • You can maintain different configurations for development, testing, and production environments by having separate .env files.

3. Simplified Bot Setup

  • Instead of modifying the code directly, you can simply edit the .env file with your custom values.

How to Create and Use a .env File

1. Create a .env File

  • In the same directory as the bot script, create a new file named .env.

2. Add Configuration Variables

  • Write your environment variables in the following format:
    BOT_TOKEN=your_discord_bot_token
    LOGGING_WEBHOOK_URL=your_webhook_url
    BOT_OWNER_ID=your_discord_user_id
    

3. Load Variables in Your Bot

  • ZygnalBot already uses the dotenv library to read these variables. The line load_dotenv() in your code automatically reads the .env file.

Sample .env File for ZygnalBot

BOT_TOKEN=YOUR_DISCORD_BOT_TOKEN
LOGGING_WEBHOOK_URL=YOUR_WEBHOOK_URL
BOT_OWNER_ID=YOUR_DISCORD_USER_ID

Important Note: Never share your .env file publicly, as it contains sensitive information.


Why Not Hardcode the Token Directly?

Hardcoding sensitive credentials directly in your code is a security risk:

  • If someone gains access to your source code (like via GitHub), they can steal your bot token and misuse it.
  • Using a .env file keeps your sensitive data out of the codebase and easily manageable in different environments.

This approach is considered a best practice in software development for maintaining secure and maintainable applications.


How to Deploy Your Project on Railway (Free Version)

1. Go to the Railway Website

2. Sign Up or Log In

  • If you don’t have an account, create one by clicking the "Sign Up" button and following the instructions.
  • If you already have an account, click "Log In" and enter your credentials.

3. Create or Open an Existing Environment (Project)

  • After logging in, you’ll be taken to the Railway dashboard.
  • If you don't already have an environment, click the "New Project" button and create one.
  • If you already have an environment, just select the existing one where you want to deploy the project.

4. Connect Your GitHub Repository

  • In your Railway environment, click the "Connect a Repository" button (or similar) to link your GitHub account to your Railway project.
  • Choose GitHub as the source to deploy from.
  • Log in to GitHub if prompted and authorize Railway to access your repositories.

5. Create a New Private GitHub Repository

  • Open GitHub and create a new repository:
    • Go to GitHub and click on the "New Repository" button.
    • Name the repository something relevant to your project (e.g., my-project).
    • Make sure the repository is set to private to keep your code and configuration secure.
    • Optionally, initialize with a README, but do not add a .gitignore or license (you'll upload your files manually).
  • Once the repository is created, drag and drop all your project files (the ones you received from me) into this repository on GitHub.
    • Be sure to include your .env file with any sensitive configurations.
    • Commit and push the changes.

6. Link the GitHub Repository to Railway

  • After uploading your files to the GitHub repository, return to your Railway environment.
  • In the "Environment" section, click the option to "Link a GitHub Repository" or "Deploy from GitHub".
  • Select the private GitHub repository you just created and click "Deploy".
  • Railway will automatically start the deployment process, but we need to configure some additional settings.

7. Configure Deployment Settings

  • Once the deployment starts, go to the Settings section of your Railway project.
  • Scroll down until you see the Deploy section.
  • In the Start Command field, enter the command to run your main script. For example, if your main file is called Main_bot_3.py, enter:
    • python Main_bot_3.py

If you still have issues contact me on my discord server

About

A powerful and fully customizable Discord bot designed for server administration. Featuring advanced moderation tools, a ticketing system, automated moderation, customizable welcome messages, and more. Built with flexibility in mind, AdminBot is free, open-source, and tailored for ease of use in managing your server.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published