Project Scripting Documentation

📦 Allowed Imports

✅ Standard Library

  • asyncio

  • os

  • sys

  • webbrowser

  • logging

  • dataclasses

  • typing

  • time

  • re

  • json

  • datetime

  • random

✅ Third-party Packages

  • discord (from discord.py)

  • discord.ext

  • aiohttp

✅ Project Imports

from utils.webhook import DiscordWebhook
from utils.config import config
from utils.logger import logger
from utils.common import fetch_guild
from utils.msg.utils import do_edit

🔗 Import from:

from utils.msg.utils import do_edit

Creates a pseudo-embed message using formatting, images, or ANSI-styled code blocks. Supports multiple modes for flexibility and automatic deletion.

Signature

async def do_edit(
    ctx: Ctx,
    content: str,
    mode: Literal["auto", "plain", "code", "image", "just_image"] = "auto",
    title: Optional[str] = None,
    fields: Optional[list[tuple[str, str]]] = None,
    footer: Optional[str] = None,
    delete_after: Optional[float] = 30.0,
    attachments: Optional[list[discord.File]] = None,
    code_lang: str = "ansi",
)

Parameters

  • ctx: Discord context object (commands.Context or similar)

  • content: Main message body

  • mode: One of "auto", "plain", "code", "image", or "just_image"

  • title: Optional title for embed-like layout

  • fields: Optional list of (name, value) pairs

  • footer: Optional footer string

  • delete_after: Time in seconds to auto-delete the message(s)

  • attachments: List of files to attach

  • code_lang: Code language (used only in code mode, default is ansi)

Modes

  • auto: Uses config.General["Embed Mode"] to determine style.

  • plain: Renders content in rich text.

  • code: Uses ANSI formatting and boxed layout.

  • image: Converts content and fields into an image.

  • just_image: Sends content as a pure image.

Returns

  • A list of additional messages sent (if the original had to be split)

Notes

  • Messages are chunked and sent individually if too long.

  • Supports temporary messages via delete_after.

🔍 fetch_guild Function

async def fetch_guild(id: int = None, name: str = None, client: discord.Client = None)

Fetches a Discord guild using a connected discord.Client.

Parameters:

  • id (int, optional) – Guild ID

  • name (str, optional) – Guild name

  • client – Connected discord.Client instance

Returns:

  • discord.Guild object

Raises:

  • Exception if neither ID nor name is provided, or no guild is found

🌐 DiscordWebhook Class

🔗 Import from:

from utils.webhook import DiscordWebhook

Asynchronous manager for sending and deleting Discord webhook messages, with built-in rate limiting and error handling.

📤 send

await webhook.send(url: str, message, retries: int = 3) -> bool

Sends a message to the webhook URL.

Accepted message formats:

  • str: treated as plain content

  • WebhookMessage: custom dataclass

  • discord.Embed: automatically wrapped

  • dict: used as-is

Parameters:

  • url: Discord webhook URL

  • message: message payload

  • retries: retry attempts on failure

Returns:

  • True on success (204 No Content)

  • False on failure or invalid URL

🗑️ delete

await webhook.delete(url: str) -> bool

Deletes a webhook.

Parameters:

  • url: Discord webhook URL

Returns:

  • True on successful deletion

  • False if the URL is invalid or deletion fails

⚙️ Configuration System

🔗 Import from:

from utils.config import config

Config Sections

All sections behave like dictionaries and are accessed as:

config.<Section>["Key"]

Available Sections:

Section
Example Usage

config.General

config.General["Token"]

config.Notifications

config.Notifications["Enable Toasts"]

config.Snipers

config.Snipers["Nitro"]["Enabled"]

config.Loggers

config.Loggers["DM"]["Enabled"]

config.Embeds

config.Embeds["Deletion Delay"]

config.RPC

config.RPC["AppID"]

🧾 Logger

🔗 Import from:

from utils.logger import logger

Handles logging of system events with optional in-app notifications.

Logging Levels:

logger.info(message, details=None, notify=False)
logger.warning(message, details=None, notify=False)
logger.error(message, details=None, notify=False)
logger.success(message, details=None, notify=False)

Parameters:

  • message: Main log string

  • details: Additional context (optional)

  • notify: If True, creates a notification

🔔 Notification API

logger.get_notifications(unread_only=False)

  • Returns list of notifications, newest first

  • Set unread_only=True to filter unread ones

logger.mark_notification_read(notification_id)

  • Marks a single notification as read

logger.mark_all_read()

  • Marks all notifications as read

logger.clear_notifications()

  • Deletes all stored notifications

PreviousKnown Issues

Last updated