ZygnalBot v7.9.4 - README

🚀 What's New in v7.9.4

Extension Marketplace Integration

• New Feature: Extension Marketplace commands integrated into the main bot panel
• Location: !panel → Page 3 → Extension Loader category
• Enhanced Extension Management: Browse, search, and install extensions directly from Discord

📦 Extension Marketplace Documentation

The Extension Marketplace is a powerful system that allows you to browse, search, and install extensions directly from Discord without leaving your server.

🔧 Setup Requirements

• Administrator permissions required for all marketplace commands
• Internet connection for fetching extensions from the marketplace API
• Extensions folder will be created automatically for downloaded extensions

📋 Available Commands

Prefix Commands

!marketplace                    # Main marketplace menu with interactive buttons
!marketplace browse [page]      # Browse all available extensions (paginated)
!marketplace search <query>     # Search extensions by title, description, or details
!marketplace categories         # Browse extensions by status/category
!marketplace install <id>       # Install extension by ID with confirmation
!marketplace info <id>          # View detailed information about an extension
!marketplace refresh            # Force refresh the extension cache

Slash Commands

/marketplace                    # Main marketplace menu (same as prefix version)
/marketplace-browse [page]      # Browse all extensions
/marketplace-search <query>     # Search for extensions
/marketplace-install <id>       # Install extension by ID
/marketplace-info <id>          # Get detailed extension information
/marketplace-refresh            # Refresh extension cache

Aliases

• !mp - Shortcut for !marketplace
• !extensions - Alternative for !marketplace

🎯 Key Features

Interactive Browsing

• Paginated Display: View 5 extensions per page with navigation buttons
• Quick Install: Install buttons for each extension directly in the browser
• Detailed View: Select dropdown to view full extension details
• Status Indicators: Visual indicators for extension status (✅ Working, ⚠️ Beta, ❌ Broken)

Smart Search System

• Multi-field Search: Searches through title, description, and details
• Real-time Results: Instant filtering of extensions
• Search Modal: Clean popup interface for entering search queries

Category Browsing

• Status-based Categories: Browse by Working, Beta, Broken, or Unknown status
• Category Statistics: See how many extensions are in each category
• Selective Dropdown: Choose specific categories to explore

Extension Information

• Comprehensive Details: ID, version, file type, date, status, and custom URL info
• Installation Preview: See what you're installing before confirming
• Source Links: Direct links to extension source code when available

🔄 Installation Process

1. Browse or Search: Find the extension you want
2. View Details: Check extension information and compatibility
3. Install: Click install button and confirm
4. Download: Extension is automatically downloaded to Extensions/ folder
5. Load: Follow the provided instructions to load the extension

📁 File Management

Automatic Organization

• Extensions are saved to Extensions/ folder
• Filenames are automatically sanitized and formatted
• File type preservation (.py, .json, etc.)

Installation Feedback

• Success Messages: Confirmation with file location and next steps
• Error Handling: Clear error messages with troubleshooting tips
• Loading Instructions: Guidance on how to activate the extension

🔧 Technical Details

Caching System

• 5-minute Cache: Reduces API calls and improves performance
• Force Refresh: Manual cache clearing when needed
• Automatic Updates: Cache refreshes every 5 minutes automatically

API Integration

• Marketplace API: Connects to https://zygnalbot.de/get_extensions.php
• Download System: Supports both direct downloads and custom URLs
• Error Handling: Robust error handling for network issues

Security Features

• Administrator Only: All commands require administrator permissions
• File Validation: Filename sanitization and path validation
• Safe Downloads: Timeout protection and content validation

🎨 User Interface

Interactive Elements

• Button Navigation: Previous/Next page buttons
• Install Buttons: Quick install for each extension
• Selection Dropdowns: View details without cluttering the interface
• Modal Dialogs: Clean search and confirmation interfaces

Visual Design

• Color-coded Status: Different colors for different extension states
• Emoji Indicators: Visual status indicators throughout the interface
• Consistent Branding: ZygnalBot branding and footer information
• Responsive Layout: Works well on both desktop and mobile Discord clients

🛠️ Extension Compatibility

Supported Formats

• Python Extensions: .py files for Discord.py cogs
• JSON Configurations: .json files for bot configurations
• Other Formats: Support for various file types as needed

Loading Methods

• Modern Async: async def setup(bot) for current Discord.py versions
• Legacy Sync: def setup(bot) for older Discord.py versions (ZygnalBot compatible)
• Flexible Setup: Extensions work with both loading methods

📊 Marketplace Statistics

The marketplace tracks and displays:

• Total number of available extensions
• Extensions per category/status
• Last update times
• Version information
• Download statistics

🔍 Troubleshooting

Common Issues

• Network Errors: Check internet connection and try !marketplace refresh
• Permission Errors: Ensure bot has write permissions for Extensions folder
• Loading Issues: Restart bot after installing extensions
• Cache Problems: Use !marketplace refresh to clear cache

Error Messages

• Clear, actionable error messages
• Troubleshooting steps included in error embeds
• Support information and community links

🎯 Panel Integration

The Extension Marketplace is now integrated into the main bot panel system:

Access Path: !panel → Page 3 → Extension Loader Category

This integration provides:

• Quick access to marketplace features
• Consistent UI with other bot functions
• Seamless workflow for server administrators

🔗 Links & Support

• Website: zygnalbot.com
• Discord: .gg/U8sssc6xbv
• Marketplace: Extension Portal
• Support: SupportMe

also to use ai commands u need to remove # in the mainbot file i put # there because i noticed that it conflicts with a lib for some odd reason

"""
# await self.add_cog(AiCommands(self))
# print("✓ Loaded AiCommands")
"""
to
"""
await self.add_cog(AiCommands(self))
print("✓ Loaded AiCommands")
"""

Made By TheHolyOneZ • ZygnalBot v7.9.4

Changelog

Fixed

• Fixed compatibility issue with synchronous and asynchronous setup functions in extensions
• Added support for both types of setup functions in the cogs_manager.py file
• Fixed "object can't be used in 'await' expression" error when loading extensions with synchronous setup functions

Changed

• Updated list_cogs command to display both loaded cogs and extensions
• Updated !load and unload
• Improved error handling and module name tracking in extension management commands
• Enhanced the display of loaded extensions in the bot's UI

Technical Details

• Added detection of coroutine functions using asyncio.iscoroutinefunction()
• Implemented proper tracking of module names before unloading extensions
• Added cross-system communication between the two extension management systems

Bot Verification System

Features

Bot Security

• Automatic detection and removal of non-whitelisted bots
• Persistent whitelist storage in JSON file (data/whitelisted_bots.json)
• Environment variable support for initial whitelist configuration (WHITELISTED_BOTS)
• Owner-only command to whitelist bots: !whitelist_bot <bot_id>
• Admin command to list all whitelisted bots: !whitelisted
• Per-guild log channel configuration with !botlogs command
• Rate limiting for whitelist attempts to prevent abuse

Bot Join Notifications

• notification system when new bots join a server
• Configurable through environment variables (MONITOR_BOT_JOINS, BOT_JOIN_LOG_CHANNEL)
• Prioritizes private/admin channels for security notifications
• Provides detailed bot information (name, ID, creation date)
• Clear instructions for whitelisting legitimate bots
• Avoids duplicate notifications for already whitelisted bots

Changes

Sass Responses System

• Made sass responses opt-in through environment variable (SassResponse=on/off)
• Default behavior changed to disabled (opt-in rather than opt-out)
• Improved response handling for mentions and direct messages
• Added variety to sass response formatting and colors

Security

• Added validation for bot IDs using Discord's snowflake algorithm
• Improved error handling for invalid environment variable configurations
• Added permission checks for administrative commands
• Enhanced logging for security events with timestamps and unique identifiers

Technical

• Consolidated bot security features into a single BotVerificationSystem class
• Improved channel selection algorithm for notifications
• Added fallback mechanisms when configured channels are unavailable
• Better error handling throughout the codebase

Configuration

Bot Verification

• Set BOT_OWNER_ID in your environment to specify who can whitelist bots
• Pre-configure whitelisted bots with WHITELISTED_BOTS=id1,id2,id3 in your environment
• Use !botlogs #channel-name in each server to set up logging

Bot Join Monitoring

• Enable/disable with MONITOR_BOT_JOINS=True/False (enabled by default)
• Set a specific notification channel with BOT_JOIN_LOG_CHANNEL=channel_id

Sass Responses

• Enable/disable with SassResponse=on/off (disabled by default)

Added:

• Auto-Config-Loader
  • Lets u drag and drop your config file in a folder: "Normal_Config" = will load and execute the config file when the bot has started
• Experimental Server Config Panel
  • use /config or !config to open it
• sync_here command to sync all commands on the guild

Because the update was so small, I decided to drop a rule maker as well.

New Features

Rule Management System

Commands

• !rule_help - Shows the main help menu for the rule management system
• !rule_help setup - Starts the rule setup wizard
• !rule_help view - Views the current rules
• !rule_help manage - Manages existing rules
• !rule_help publish - Publishes rules to a channel
• !rule_help theme - Customizes rule appearance
• !rule_help import - Imports rules from another channel
• !rule_help export - Exports rules to a file

Features

• Section Management

  • Create, edit, and delete rule sections
  • Organize rules into logical categories

• Rule Management

  • Add, edit, and delete individual rules
  • Assign rules to specific sections

• Publishing Options

  • Publish rules as a single message or as multiple messages
  • Select any channel for rule publication

• Theme Customization

  • Change embed colors
  • Customize title format
  • Edit footer text
  • Toggle rule numbers
  • Change section and rule emojis

• Import/Export

  • Import rules from existing embeds in other channels
  • Export rules to JSON format for backup or transfer

User Interface

• Interactive buttons for navigation
• Dropdown menus for selection
• Modal forms for data entry
• Confirmation dialogs for destructive actions

Technical Details

• Rules are stored in JSON format in the data/rules directory
• Each server has its own rule configuration file
• Rules include metadata such as creation and update timestamps
• Theme settings are customizable per server

Bug Fixes

• Fixed issues with command registration
• Improved error handling in UI components
• Enhanced compatibility with Discord's interaction system

ZygnalBot Changelog V7.8.6

🔌 Extensions System Overhaul

Core Improvements

• Implemented full custom extensions system allowing on-the-fly loading of cogs
• Added Extensions folder support for modular code organization
• Created comprehensive extension management commands
• Added detailed documentation for extension development
• Fixed async handling in extension loading system

Extension Management Commands

• !load <filename> - Load a custom extension from the Extensions folder
• !unload <cogname> - Unload a currently active cog
• !reload <cogname> - Reload a cog to apply changes without restarting
• !listcogs - List all currently loaded cogs
• !coghelp - Show detailed help for extension management commands

Developer Features

• Support for hot-reloading code changes
• Proper error handling and debugging information
• Automatic Extensions directory creation
• Detailed feedback on extension loading status
• Support for complex extension dependencies

Documentation

• Added comprehensive HTML documentation for extension development
• Included example extensions with best practices
• Added troubleshooting guide for common extension issues
• Created step-by-step tutorial for creating custom cogs

🔄 Update System Enhancements

Version Tracking

• Updated version to 7.8.6
• Improved version comparison algorithm
• Enhanced update notification system
• Added detailed changelog access

Update Checker

• Optimized update checking performance
• Reduced API calls with improved caching
• Added force update check option
• Enhanced update notification embeds

:tools: System Improvements

Performance Optimizations

• Improved async task handling
• Enhanced error recovery systems
• Optimized memory usage for large servers
• Reduced command processing overhead

Stability Enhancements

• Fixed coroutine handling in multiple systems
• Improved exception handling throughout codebase
• Added additional error logging for diagnostics
• Enhanced recovery from API interruptions

📊 Analytics & Monitoring

Diagnostic Tools

• Added extension performance monitoring
• Enhanced error reporting for extensions
• Improved command usage tracking
• Added detailed extension load/unload logging

User Experience

• Added more detailed feedback for extension operations
• Improved error messages with troubleshooting tips
• Enhanced visual feedback for extension management
• Added confirmation dialogs for critical operations

🔒 Security Enhancements

Permission System

• Restricted extension management to bot owner
• Added permission verification for extension commands
• Enhanced security for extension loading process
• Added validation for loaded extension code

📝 Documentation Updates

User Guides

• Added comprehensive extension development guide
• Updated command documentation
• Added troubleshooting section for common issues
• Included example extensions for learning

Tutorials on how u can make ur own extension:
https://zygnalbot.info/CogHelp.html

ZygnalBot Changelog V7.8.5

🔧 New Cog Management System

Core Features

• Added comprehensive cog management commands for bot owners
• Implemented case-insensitive cog name matching
• Added detailed error handling and feedback
• Created interactive help system for cog management

Commands

• !reload [cog_name] - Reload all cogs or a specific cog without restarting
• !unload <cog_name> - Unload a specific cog from the bot
• !listcogs - View all currently loaded cogs
• !coghelp - Display detailed help for cog management commands

Technical Improvements

• Enhanced error handling with detailed traceback information
• Implemented safe cog reloading with instance preservation
• Added protection against unloading the CogManager itself
• Optimized cog listing with pagination for large bot setups

🔄 Enhanced Update System

Core Features

• Added robust version checking and comparison
• Implemented cooldown-aware update checking
• Added force update check option
• Created comprehensive help command for the update system

Commands

• !checkupdate [force] - Check for bot updates with optional force parameter
• !updatehelp - Display detailed information about the update system

Technical Improvements

• Implemented semantic version parsing and comparison
• Added persistent configuration storage
• Enhanced error handling for network issues
• Added detailed status reporting for update checks

💻 General Improvements

UI Enhancements

• Added color-coded embedded responses
• Implemented interactive buttons for update downloads
• Created consistent help formatting across commands
• Added detailed timestamps for update checks

System Stability

• Enhanced error handling throughout both systems
• Improved configuration persistence
• Added detailed logging for troubleshooting
• Implemented graceful fallbacks for network failures

User Experience

• Added comprehensive help documentation
• Improved command feedback and status reporting
• Enhanced permission handling and validation
• Added intuitive command aliases

ZygnalBot Changelog V7.7.7

🛡️ New Anti-Nuke System

Core Features

• Complete Anti-Nuke control panel with interactive UI
• Quick Setup option for instant protection
• Advanced settings configuration
• Customizable protection limits
• Real-time monitoring and response system

Protection Settings

• Ban Protection: Prevents mass bans
• Channel Protection: Stops unauthorized channel deletions/creations
• Role Protection: Prevents role manipulation
• Webhook Protection: Controls webhook creation/deletion
• Bot Protection: Monitors bot additions and permissions

Configurable Limits

• Ban Limit (1-10): Maximum bans per time window
• Kick Limit (1-10): Maximum kicks per time window
• Channel Limit (1-10): Channel modifications allowed
• Role Limit (1-10): Role changes permitted
• Webhook Limit (1-10): Webhook creation restrictions

UI Improvements

• Interactive button controls for easy navigation
• Visual feedback showing current protection status
• Confirmation dialogs for critical changes
• Easy-to-use limit configuration modals
• Color-coded status indicators
• Real-time settings display

Commands

• !antinuke or !an - Opens the main control panel
• Quick Setup: One-click protection deployment
• Advanced Settings: Fine-tune your security
• Reset Options: Restore default configurations
• Limit Management: Customize action thresholds

Technical Updates

• Per-guild configuration storage system
• Advanced threshold management
• Protection status tracking and logging
• Real-time limit enforcement
• Efficient event monitoring
• Automatic threat detection
• Smart action prevention system

Default Values

• Ban Protection: Enabled (Limit: 3)
• Kick Protection: Enabled (Limit: 5)
• Channel Protection: Enabled (Limit: 2)
• Role Protection: Enabled (Limit: 2)
• Webhook Protection: Enabled (Limit: 3)

Additional Features

• Smart threat detection
• Automatic action logging
• Guild-specific configurations
• Persistent settings storage
• Real-time protection updates
• Emergency lockdown capabilities

⚠️ Important Setup Note

• Place the bot role directly below the server owner role
• This positioning is crucial for the Anti-Nuke system to function properly
• Ensures the bot can override and prevent unauthorized administrative actions
• Required for effective protection against high-permission attacks

Advanced Translation System 🌐

A powerful translation system with both manual and automatic translation capabilities, supporting 15+ languages with real-time detection.

Features ⚡

Manual Translation

• Select target language from dropdown menu
• Translate text with modal input
• Language detection capability
• Support for 1000 character limit
• Real-time translation results

Auto Translation

• Channel-specific auto translation
• Toggle on/off with visual feedback
• Permission-based access control
• Automatic language detection
• Real-time message translation

Supported Languages

• Arabic
• Chinese
• Dutch
• English
• French
• German
• Hindi
• Italian
• Japanese
• Korean
• Portuguese
• Russian
• Spanish
• Turkish
• Vietnamese

Commands

• !translate - Opens the translation interface

Permissions

• Manual translation: Available to all users
• Auto translation: Requires Manage Channels or Administrator permissions

Technical Features

• Google Translate API integration
• Real-time language detection
• Interactive UI with buttons and dropdowns
• Channel-specific settings
• Error handling and feedback
• Visual state indicators

Version 7.7.3 Release Notes

🎰 New JackCoins Currency System

Core Features

• Introduced JackCoins as the server's virtual currency system
• Added starting balance of 1000 JackCoins for new users
• Implemented credit limit system (-5000 JackCoins)
• Full balance tracking and persistence across restarts

New Commands

1. !jackadd <userid> <amount> - add some coins to someone else | Hardcoded user_id only!
2. !jacktransfer <user> <amount> - transfer some of ur coins to someone else
3. !jackbalance - Check your current JackCoins balance

Blackjack Game Features

• Single player and multiplayer modes
• Interactive button controls (Hit, Stand, Double Down)
• Minimum bet: 50 JackCoins
• Maximum bet: 10000 JackCoins
• Double down option for increased stakes

Technical Updates

• Added currency persistence in configuration system
• Implemented transaction safety measures
• Added balance checks for all currency operations

Balance & Economy

• Starting Balance: 1000 JackCoins
• Credit Limit: -5000 JackCoins
• Blackjack Payouts: 2:1 on wins
• Push (Tie) Results: Bet returned to player

🔧 Known Issues

• None reported

📝 Notes

• Currency commands are channel-independent
• Multiple games can run in different channels

ZygnalBot Changelog V7.7.1 | BETA

New Features

🎰 Blackjack Game System

• Added complete Blackjack game with interactive buttons
• Support for both single-player and multiplayer modes
• Features:
  • Dynamic card system with emoji suits (:spades:, :hearts:, :diamonds:, :clubs:)
  • Interactive game controls (Hit, Stand, Double Down)
  • Multiplayer support with join/start buttons
  • Betting system
  • Real-time game state updates
  • Clear visual display using Discord embeds

Commands

• !blackjack [bet] [multiplayer]
  • bet: Amount to bet (default: 100)
  • multiplayer: true/false (default: false)

Game Features

• Join system for multiplayer games
• Turn-based gameplay
• Dealer AI following standard rules
• Automatic win/loss calculation
• Bet doubling option
• Hand value calculation with Ace handling

⚙️ Command Prefix System

• Added new command to change bot prefix
• Restricted to administrators with manage channels permission
• Security features to prevent abuse

Commands

• !setprefix <new_prefix>
  • Requires Administrator AND Manage Channels permissions
  • Maximum prefix length: 5 characters
  • Shows confirmation and example usage
  • Includes error handling

Technical Improvements

• Removed dependency on external card API
• Implemented local deck generation system
• Improved error handling
• Enhanced game state management
• Added permission checks for admin commands

How to Use

Blackjack

1. Start a game: !blackjack 100 or !blackjack 500 true for multiplayer
2. Use interactive buttons to play:
   • 👊 Hit: Draw another card
   • :octagonal_sign: Stand: Keep current hand
   • 💰 Double Down: Double bet and draw one card

Prefix Management

1. Change prefix: !setprefix ?
2. Required permissions:
   • Administrator
   • Manage Channels

Fixed Errors/bugs

• Runtime errors
• Nonetype errors
• Button bug
• await bot_cog was never awaited errors | cog was never awaited errors

I've made the console design cleaner and disabled all discord.py info-related logging in the console, except for errors of course:
logging.getLogger('discord').setLevel(logging.ERROR)
logging.getLogger('discord.client').setLevel(logging.ERROR)
logging.getLogger('discord.gateway').setLevel(logging.ERROR)

Updated Design:

Also added a new Poll system