Skip to content

ZygnalBot V7.9.4 | Join Discord

Latest
Latest
Compare
Choose a tag to compare
@TheHolyOneZ TheHolyOneZ released this 09 Jun 22:55
· 1 commit to main since this release
zygnalbotv7-9-4
3c01c44
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

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

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

Assets 2
Loading