Build with VELOCITY

Introduction

VELOCITY is an all-in-one Discord bot for the ZyperMC Minecraft network. It bundles tickets, tournaments, moderation, economy, music and a live plugin system — all controllable from this dashboard. The bot persists data as JSON; this dashboard mirrors those exact schemas.

Quick Start

Add the bot, then open the dashboard:

1. Click Add to Discord and authorize VELOCITY.
2. Open the dashboard and pick your server.
3. Create a ticket panel under Panels.
4. Install plugins from the Marketplace.

Run the bot locally:

pip install -r requirements.txt
# fill in config.json (token, owner_id, guild_id)
python main.py

Commands

72 commands across 11 categories. Permissions:

Ticket System

Tickets are created from panels. Each panel renders as buttons or a dropdown, and each option routes to a category with its own support roles, welcome message, default priority and optional modal form.

A panel option looks like:

{
  "label": "Report a Player",
  "emoji": "🚨",
  "category_id": 1411032023514218672,
  "support_roles": [1466096340340834496],
  "button_style": "danger",
  "default_priority": "high",
  "form": [
    { "label": "Offender IGN", "style": "short", "required": true },
    { "label": "What happened?", "style": "long", "required": true }
  ]
}

When a ticket closes, VELOCITY archives the conversation to https://transcript.zypermc.fun/transcript/{id} — searchable, shareable and downloadable.

Plugin Development

A plugin is a folder under plugins/ with a plugin.json manifest and a plugin.py entry point.

{
  "name": "welcome_images",
  "display_name": "Welcome Image Cards",
  "version": "2.1.0",
  "description": "Generates welcome cards for new members.",
  "author": "ZyperMC Labs",
  "dependencies": [],
  "permissions": ["commands"],
  "entry": "plugin.py",
  "config": { "accent": "#7B2FBE" }
}

Implement either a class with on_load/on_unload or module-level setup/teardown:

async def setup(api):
    # register a ticket hook
    api.register_ticket_hook("ticket_create", on_ticket)
    # add a command, view, task or cog
    api.add_prefix_command(my_command)

async def on_ticket(ticket, bot, actor):
    print(f"Ticket #{ticket['number']} opened")

async def teardown(api):
    await api.unwind()  # cleans up everything

Hooks: ticket_create, ticket_claim, ticket_close, ticket_reopen, ticket_delete. Config persists to data/plugin_{name}.json. Manage everything live from the Marketplace.

API Reference

The dashboard exposes a REST API. Mutating routes require a valid session and manage-permission on the guild; all routes are rate-limited.

curl https://bot.zypermc.fun/api/commands | jq '.total'
curl https://bot.zypermc.fun/api/guilds/123/tickets?status=open

Status & Support

Need help? Join the support server or check the live service status endpoint.