ZygnalBot System Notes | Discord Bot Documentation

Main Command: !panel

The !panel command is your gateway to all ZygnalBot features. It provides a comprehensive interface to navigate through all available commands and functionalities.

Key Benefits:

Access all bot categories in one place
Easy-to-navigate interface

Simply type !panel in any channel where the bot has permission to respond, and you'll get access to the complete command dashboard.

Official Website Cogs/Extension Help Support/Donate

Before Updating ZygnalBot

If you are planning to update ZygnalBot, follow these steps to avoid issues:

Export Configuration: Use !exportconfig to generate a basic config file for your server.
Reimport Configuration After Update: If you update or modify anything in the script and redeploy the bot, use !importconfig to restore your settings properly.

Ticket System Issues After an Update

If the buttons in the tickets stop working after updating ZygnalBot, use !close to manually close the ticket.

Resetting the Ticket System After an Update

After updating, you must reconfigure the ticket system by running:

!ticketsetup <cmd>

Or !ticketsetup_json if you used that previously.

Once this is done, delete the old ticket setup button to prevent conflicts.

Other Configuration Details

For additional configuration options, check the RolePanel category, Rating System, and other relevant categories where you got commands from.

Make sure your server folder is empty (only necessary files/the files provided). The JSONs can be deleted just make sure you used !exportconfig

Use the !importconfig in that channel where you set up your ticket channel

Your AntiNuke settings will NOT be exported/imported through the !importconfig/exportconfig cmd

Installation Requirements

Make sure to install the requirements:

pip install -r requirements.txt

Also, your server (or local machine) should be running Python 3.10 or higher. - Bot made on Version 3.12.7

Supported Versions:

Python Version: 3.10-3.12.7
Lower than 3.10 not Supported
3.13 Not working Correctly

Ticket Setup with JSON

For ticket setup, you can also use !ticketsetup_json

Example JSON format:

{
  "content": null,
  "embeds": [
    {
      "title": "🤖┆Want ZygnalBot?",
      "description": "**Want to request ZygnalBot or update your version? No problem—just open a ticket!**\n\n*Our support team is here to help you with:*\n\n• 🚀 Bot Installation\n• ⚙️ Setup Assistance\n• 📝 Configuration Help\n• 🔄 Version Updates\n• ❓ General Support\n\n**Click the button below to get started with your ZygnalBot journey!**",
      "color": "purple",
      "image": {
        "url": "https://cdn.discordapp.com/attachments/1342072616684490808/1344627496246579221/standard_3.gif?ex=67c19971&is=67c047f1&hm=e0fc6c3854c0d39731d8375ad0418fed880dea78ad62cc7be76a9569a0c86004&"
      }
    }
  ],
  "button_color": "blurple",
  "button_label": "Request ZygnalBot",
  "button_emoji": "🎉",
  "attachments": []
}

Additional Notes

The command !panel will guide you through everything, or you can use the website to search for a command by simply typing what you're looking for.
If you encounter errors when sending commands to the bot in DMs, you can safely ignore them. Some parts of the bot don't work properly in DMs because certain features require permissions or IDs that don't exist there (like admin privileges or manage channels permissions).
Commands not specifically designed for DMs will return errors, but rest assured, the bot will not crash or cause any issues. Only use commands that are made for DMs to avoid errors.

Known Issues

If you see a "please verify you're not a robot" message, it's due to YouTube detecting automated traffic and blocking it with a CAPTCHA. This happens more often on platforms like Railway, where shared IPs may be flagged by YouTube.

The bot works fine locally or on a VPS with a clean, dedicated IP, so this issue is specific to certain hosting environments.

Music features aren't recommended for long-term use as the quality is not optimal. The bot is more of a temporary solution for music.

Server Requirements

Make sure your Discord server has an image. When using !panel, it grabs the server's image link. So if your server doesn't have a picture, you'll get an error.

Same goes for commands that use your bot's image.