open-ticket/README.md

The most advanced self-hosted ticket bot for Discord
_{Related Projects:}

Open Ticket is the most advanced and customizable Discord ticket bot available right now. It features more than 350+ configurable settings to control almost every aspect of your ticket system. From HTML transcripts and Advanced Plugins to Claiming & Pinning, Modal Questions & Limits, Detailed Statistics, and much more. The bot is fully translated into 38+ languages and has been battle-tested in large Discord servers. Need help or want to get involved? Feel free to join our Discord server.

⭐️ Support Open Ticket’s growth by starring this repo! ⭐️

^{❤️ Love Open Ticket? Sponsorships help fuel our HTML transcript servers and future features! ❤️}

---

-> Navigate to (⏱️ Quick Setup)
-> Navigate to (📚 Documentation)
-> Navigate to (📞 Support Server)
-> Navigate to (🧩 Plugins/Addons)
-> Navigate to (🦇 Pterodactyl Eggs)

📌 Features

Core Features

• Ticket Management - Close, reopen, delete, claim or pin tickets with ease.
• Powerful Commands - Manage your support system with 30+ commands for staff & users.
• Modal Questions - Ask users custom questions before a ticket is created.
• Priorities - Assign priority levels to tickets to highlight urgent requests.
• Participants - Add or remove participants & transfer ownership from one user to another.
• Adjustments - Rename tickets, change ticket types or transfer ownership.
• Blacklist & Limits - Prevent users from creating tickets and set per-user or global ticket limits.
• Highly Customisable - Configure 350+ settings covering appearance and behaviour.

Ticket Automation & Workflows

• Unlimited Possibilities - Create unlimited tickets, panels & question flows.
• Autoclose Tickets - Automatically close tickets after predefined conditions.
• Autodelete Tickets - Automatically delete closed tickets to keep channels clean.
• Category Routing - Move tickets between categories based on claim or close state.

Transcripts & Insights

• HTML Transcripts - Generate beautiful, easy-to-read HTML transcripts for every ticket.
• Detailed Statistics - Track 50+ statistics for tickets, users and server activity.
• Ticket Logs - Track all ticket events such as creation, closures, and staff actions.

User Experience

• Fully Translated - Available in 38+ languages, translated and maintained by the community.
• Modern Interactions - Full support for buttons, dropdowns, slash/text commands & modals.
• Panels - Create messages with buttons or a dropdown for users to open tickets.
• Sub-Panels - One panel not enough? Use multiple panels to offer more choices.

Plugins & Ecosystem

• Plugin System - Use custom plugins to add new features or modify existing behavior of the bot.
• Community Plugins - Use and share plugins built by the community.
• Advanced API - Build advanced plugins with access to ticket events and internal systems.
• Integrations - Connect Open Ticket with external services to automate workflows across platforms.
• Bonus Features - Somehow, we included Reaction Roles and URL Button support as well.

Deployment

• Quick Setup - Easy 5-minute configuration using the Interactive Setup CLI.
• Scalable & Reliable - Battle-tested in servers with 100k+ members.
• Private & Secure - Used by thousands of servers with respect for security & privacy.
• Pterodactyl Support - 100% compatible with Pterodactyl panels. (Download official eggs)
• Docker Support - Deploy Open Ticket in minutes with Docker containers.

Extend functionality even more with our pre-made community plugins!

• Reviews - Create and manage a support review system for tickets.
• Tags - Define keywords that automatically trigger predefined responses.
• Reminders - Create and manage custom reminders for users or staff.
• AI Integrations - Connect to AI providers such as ChatGPT, Claude, or Gemini.
• Channel Display - Create voice channels that display real-time ticket system statistics.
• Forms - Build advanced forms for collecting structured information from users.
• Custom Embeds - Create and send custom embeds via commands.
• Customization Tools - Additional configuration options for advanced behavior and styling.
• Web Dashboard - Configure and manage the bot through a remote web dashboard.
• Feedback - Collect user feedback after ticket deletion using forms.
• SQLite Database - Use an SQLite backend for improved performance and lightweight storage.
• And more - Additional community plugins are available and actively expanding.

⏱️ Quick Start

1. Download the latest version of Open Ticket.
2. Make sure you have installed Node.js on your system (check using node -v, minimum v20).
3. Install any required dependencies using npm install.
4. Configure the bot in one of the following ways:
   • Method 1 (Easy): Start the Quick Setup CLI using npm run setup.
   • Method 2 (Hard): Manual JSON configuration in ./config/...
5. If using the Quick Setup CLI, click on > ⏱️ Quick Setup and follow the instructions.
6. Start the bot using npm start or node index.js
   • If any config errors occur, the bot will give you a report of how to solve them.
   • Follow the instructions and restart the bot.
7. Enjoy using Open Ticket!
8. Install plugins from the Official Plugin Repository

🚦 Next Steps

-> Navigate to (📚 Documentation)
-> Navigate to (📞 Support Server)
-> Navigate to (🧩 Plugins/Addons)
-> Navigate to (🦇 Pterodactyl Eggs)

🖥️ Recommended Hosting

• A VPS (Virtual Private Server) - Extra customisation & more stability. Recommended for most servers.
• Any Pterodactyl-Based Panel - Easy installation & configuration.

📸 Preview

🛠️ Contributors

🖥️ Team & Contributors

A list of amazing people who have contributed or provided supported for Open Ticket and Open Discord.

💻🧩💬 DJj123dj	🧩💬 Guillee3	💬 smetsliam	💬 Frank Vissers	💬 Sanke	🧩 SKaranjaN

💬 Translators

With the amazing support of our translators, we've been able to translate Open Ticket in more than 38 languages!

Categories:

• 🟢 Available
• 🤖 Partially Made Using AI
• 🟠 Incomplete
• 🔴 Unavailable/Outdated

🔍	Languages (38)	Maintainer (Github/Discord)
🟢	🇬🇧 English	djj123dj
🟢	🇳🇱 Dutch	djj123dj
🟢	🇩🇪 German	benzorich
🟢	🇫🇷 French	guillee.3
🟢	🇪🇸 Spanish	redactado & josuens
🟢	🇵🇹 Portuguese	quiradon
🟢	🇮🇹 Italian	fraden1mvp. & imperatorix_17
🟢	🇸🇪 Swedish	NoOneNook
🟢	🇳🇴 Norwegian	NoOneNook
🟢	🇹🇭 Thai	modshd
🟢	🇮🇳 Hindi	challenger_nova
🟢	🇭🇺 Hungarian	kornel0706
🟢	🇮🇩 Indonesian	erxg
🟢	🇱🇹 Lithuanian	tsgindrius
🟢	🇺🇦 Ukrainian	anderskiy
🟢	🇨🇿 Czech	spyeye_
🟢	🇷🇴 Romanian	sankedev
🟢	🇩🇰 Danish	the_gamer
🟢	🇹🇷 Turkish	palestinian
🟢	🇦🇪 Arabic	palestinian
🟢	🇵🇱 Polish	danoglez
🟢	🇮🇷 Persian	dysashop & zhavis
🟢	🇧🇩 Bengali	HanumeshGupta
🟢	❓ Catalan	guillee3
🟢	🇨🇳 Traditional Chinese	me.october
🟢	🇰🇭 Khmer (Cambodia)	yuuslokrobjakkroval
🤖	🇪🇪 Estonian	iamnotmega
🤖	🇫🇮 Finnish	iamnotmega
🤖	🇯🇵 Japanese	HanumeshGupta
🤖	🇬🇷 Greek	HanumeshGupta
🤖	🇸🇮 Slovenian	HanumeshGupta
🤖	🇰🇷 Korean	HanumeshGupta
🤖	🇮🇳 Tamil	HanumeshGupta
🤖	🇨🇳 Simplified Chinese	HanumeshGupta
🤖	❓ Kurdish	HanumeshGupta
🤖	🇷🇺 Russian	NoOneNook
🤖	🇱🇻 Latvian	NoOneNook
🤖	🇻🇳 Vietnamese	ngocdiep2006

⭐️ Star History

If you enjoy using Open ticket, consider starring this repository.
This will help us grow and reach even more people!

🧩 Plugins

Download all plugins from our Official Plugin Repository!

⭐ Featured Plugins (Top 5 Most Used)

ot-sqlite-database, ot-reviews, ot-feedback, ot-tags, ot-restrictions

Categories:

• 📄 Example - These plugins serve as an example or starting template.
• 📢 Command - These plugins add new commands to the bot.
• ⚙️ Utility - These plugins help with utility systems. You might not notice them as a ticket user/admin directly.
• 🎨 Customisation - These plugins add even more customisation to the bot.
• 💼 Management - These plugins add features that help you manage your server or ticket system.
• 🤖 Client - These plugins add features affecting the Discord Client or bot itself.
• Please Create a new category when your plugin doesn't fit in one of the available categories.

📦 Official (made by DJdj Development)

Name	Category	Description
example-plugin	📄 Example	This is just an example plugin for people that want to create their own plugin.
example-command	📄 Example	Sample custom command using the Open Discord system.
ot-jump-to-top	📢 Command	Add a simple command to jump to the top of the ticket.
ot-kill-switch	📢 Command	Temporarily disable the ticket system using a kill switch.
ot-hosting-status	📢 Command	A simple command to send hosting status updates to a channel.
ot-shutdown	📢 Command	A simple command to turn off the bot from a slash command (server & bot owner only).
ot-sqlite-database	⚙️ Utility	With this plugin, the database will be an SQLite file. It's a must-have for large servers!
ot-no-slash-clear	⚙️ Utility	Disable the automatic removal of slash commands that aren't used by Open Ticket.
ot-migrate-v3	⚙️ Utility	Use this plugin to migrate all tickets from Open Ticket v3 to v4.
ot-ticket-message-extras	🎨 Customisation	A plugin which adds a few little features to the ticket message.
ot-rename-keep-prefix	🎨 Customisation	Simple plugin to keep the channel prefix when using the /rename command.
ot-customise-buttons	🎨 Customisation	Customise almost all built-in buttons. This includes the claim, reopen, close & delete buttons.
ot-ephemeral-messages	🎨 Customisation	Customise for every messages if it needs to be ephemeral or not.
ot-footers	🎨 Customisation	A simple plugin to add footers in all Open Ticket embeds.
ot-alt-detector	💼 Management	Use the discord-alt-detector npm package by DJdj Development in your ticket bot.
ot-embeds	💼 Management	Create custom premade embeds in the config or use the command to create one from scratch.
ot-move-actions	💼 Management	Automatically unclaim/unpin a ticket when it's moved using /move.
ot-reviews	💼 Management	Review system for Open Ticket! It is very customisable and has lots of features.
ot-tags	💼 Management	Use tags to quickly reply with a pre-existing text.
ot-restrictions	💼 Management	Restrict which roles can open a specific ticket option.
ot-better-status	🤖 Client	An advanced status plugin to rotate between states. It also allows for the use of variables.
ot-channel-display	🤖 Client	A plugin to show different variables in a voice channel in your server.
ot-vanity	🤖 Client	A plugin to detect the vanity status of members in the server and give them exclusive privilleges.

✅ Verified (made by community)

Name	Author	Category	Description
ot-config-reload	guillee.3	⚙️ Utility	This plugin adds a new command that allows reloading the Open Ticket config files without the need for a restart.
ot-feedback	an_developer	💼 Management	A plugin to gather feedback of your support service.
ot-assign-role	rapid.fast	💼 Management	This plugin assigns a predefined role to a user upon creating a ticket.
ot-moderation	NotMukundOP	💼 Management	A simple moderation plugin for Open Discord with ban, kick & warnings.
ot-template-system	DanoGlez	💼 Management	Predefined template system for sending quick messages.
ot-volume-warning	guillee.3	💼 Management	Alerts ticket creators when too many tickets are open, indicating possible response delays.
ot-reminders	guillee.3	💼 Management	Set reminders that will be sent to a channel every specified time.
ot-ticket-forms	guillee.3	💼 Management	An advanced forms plugin for Open Ticket.
ot-followups	guillee.3	💼 Management	Send additional follow-up messages to a ticket.
ot-twitch-notifier	guillee.3	💼 Management	Get notified when your favorite Twitch streamers go live.
ot-translate-cmds	guillee.3	🤖 Client	Translate all built-in command names, descriptions & options.

---

README.md
Changelog - Documentation - Website - Support Server - License

© 2021 - 2026 - DJdj Development - Terms - Privacy Policy - Support Us