Ticker Boy is a feature-rich, production-ready Discord bot designed specifically for advanced ticket management in Discord servers. Built with Discord.js v14, it provides a professional support system for communities, gaming servers, and businesses.

• Streamline Support: Users create tickets via interactive buttons/menus, staff claim/resolve them with transcripts.
• Admin Dashboard: Configure everything via /settings (language, panels, roles, logs, claims).
• Scalable: Supports thousands of servers with multi-DB options (JSON, MySQL, MongoDB).
• Customizable: Multi-language (EN/Persian), themes, embeds, and permissions.

Version 1.3.9 Highlights:

• Fixed Ticket Bugs: Improved stability in create/close/claim flows.
• Enhanced Buttons: Better interaction handling, no more "interaction failed" errors.
• Quality Improvements: Optimized DB queries, reduced memory usage, better error logging.
• New Features: Claim system toggle, parent category support (open/close), menu options, mod logs.
• Dashboard: Express-based web interface for stats/settings.
• Transcripts: HTML exports for closed tickets (via discord-html-transcripts).
• Multi-Language: EN-US & Persian with dynamic localization.
• Webhook Logging: Auto-reports joins/leaves/errors to support server.
• Anti-Crash: Full error handling with webhook alerts.

Perfect for support teams needing fast, organized ticket handling without manual channels.

Install with: npm install

Ticker Boy/
├── config.js                  # Bot config (DB, Discord, support)
├── index.js                   # Main entrypoint
├── package.json               # Dependencies & scripts
├── example.env                # Env template
├── LICENSE                    # BSD-3-Clause
├── start.bat                  # Auto-install & start
├── src/
│   ├── commands/              # All commands (Admin, Misc, Owner, Ticket)
│   │   ├── Admin/settings.js  # Main dashboard
│   │   ├── Misc/{help,invite,ping}.js
│   │   ├── Owner/{dbset,serverleave,serverlist}.js
│   │   └── Ticket/{add,claim,close,create,delete,open,rename,transcript}.js
│   ├── dashboard/             # Express web UI
│   │   ├── index.js
│   │   ├── public/            # Static files (CSS, HTML)
│   │   └── views/             # EJS templates
│   ├── events/                # Event handlers
│   │   ├── button/interactionCreate.js
│   │   ├── command/interactionCreate.js
│   │   ├── guild/{create,delete}.js
│   │   ├── menu/interactionCreate.js
│   │   ├── message/messageCreate.js
│   │   ├── modal/interactionCreate.js
│   │   ├── ready/ready.js
│   │   ├── status/ready.js
│   │   └── ticket/interactionCreate.js
│   ├── functions/             # Utilities
│   │   ├── chooseRandom.js
│   │   ├── database.js
│   │   ├── error.js
│   │   ├── errorMessage.js
│   │   ├── functions.js       # Multi-purpose utils
│   │   ├── help.js
│   │   ├── loadCommand.js
│   │   ├── post.js
│   │   ├── ticket.js          # Ticket core
│   │   └── ... (20+ more)
│   ├── handlers/              # Bootloaders
│   │   ├── 1-antivirus.js     # (Missing in your upload?)
│   │   ├── 2-database.js
│   │   ├── 3-events.js
│   │   ├── 4-dashboard.js
│   │   └── 5-commandHandler.js
│   ├── locales/               # Translations
│   │   ├── en.json
│   │   └── per.json
│   └── storage/               # Static data
│       ├── colors.json
│       ├── embed.json
│       ├── emotes.json
│       └── languages.json

• Node.js ≥16.9.0
• Discord Bot Token (Developer Portal)
• Optional: MySQL/MongoDB server

1. Clone Repo:

   git clone https://github.com/Persian-Caesar/Ticker-Boy.git
   cd Ticker-Boy

2. Install Dependencies:

   npm install

3. Setup Environment (copy example.env → .env):

   token=YOUR_BOT_TOKEN
   prefix=!
   database_type=json  # json/sql/mysql/mongodb
   # MongoDB:
   database_mongoURL=mongodb+srv://user:[email protected]/
   # MySQL:
   database_msql_host=localhost
   database_msql_user=root
   database_msql_password=pass
   database_msql_database=tickerboy
   # Support:
   support_id=1054814674979409940
   support_url=https://discord.gg/xh2S2h67UW
   webhook_url=YOUR_WEBHOOK_URL  # For logging

4. Customize config.js (optional):

   • Dashboard port/host
   • Status activities
   • Owners/VIP roles
   • Invite links

5. Run Bot:

   node index.js

   Or: start.bat (auto-install + run)

Invite Bot: Use links in config.js (no-perms, admin, default).

• source: Language, anti-crash, dashboard (port: 3000), DB type.
• discord: Token, prefix, status, invites, support (webhook, roles, owners).
• topgg: Vote page URL.

DB Types:

• json: File-based (easiest).
• sql: SQLite (local).
• mysql: Remote MySQL.
• mongodb: Cloud MongoDB.

Prefix: Configurable (default: empty for slash-only).

Guild data: guild_${guildId}

{
  language: "en",
  prefix: "!",
  ticket_type: "Reason - Menu - UserTag",
  ticket_claim: true,
  admin_roles: ["roleId1"],
  modlog: "channelId",
  categories: { open: "catId", close: "catId" },
  panel: {
    channel: "channelId",
    menu_options: [{ label: "Support", value: "Support", emoji: "🎫" }]
  },
  tickets: [
    {
      channelId: "id",
      channelName: "ticket-user",
      user: "userId",
      newUser: "addedUserId",
      closed: false,
      claimed: "claimerId"
    }
  ]
}

Global: totalCommandsUsed: number

• Enabled: config.source.dashboard.on = true
• URL: http://localhost:3000 (configurable port/host)
• Tech: Express + EJS templates
• Features: Stats, commands, premium (WIP), invite
• Views: /test, 404 handler
• Static: CSS/JS in /public

• Files: src/locales/{en,per}.json
• Default: English
• Per-Guild: /settings → Language
• Usage: client.languages[lang].commands.help.embed1.title

• Anti-Crash: process.on('unhandledRejection') → Webhook + Console.
• Commands: Permission/cooldown checks with styled errors.
• Webhooks: Bugs/status/reports to support threads.

1. Fork repo
2. Create branch: git checkout -b feature/ticket-fix
3. Commit: git commit -m "Fix: ticket claim bug"
4. Push: git push origin feature/ticket-fix
5. Open PR

Guidelines:

• ESLint + Prettier
• JSDoc comments
• Unit tests for functions
• Mention Persian Caesar in credits

• Discord: Persian Caesar
• Report Bugs: /settings → Report button (sends webhook).
• Issues: GitHub Issues
• Vote: Top.gg

BSD 3-Clause License

Copyright (c) 2021-2025, Sobhan-SRZA (mr.sinre) & Persian Caesar

• Developer: Sobhan-SRZA (mr.sinre)
• Team: Persian Caesar
• Libraries: Discord.js, QuickDB, Express, discord-html-transcripts
• Icons/Emotes: Custom Persian Caesar theme