This is a ticket bot that aims to provide a free and open source solution for managing tickets on Discord. The bot is designed to be lightweight, without any watermarks or unnecessary bloat. It allows users to create, track, and manage tickets seamlessly.
- Tested on latest Node.js v18
- Install Node.js if not already installed (v18 recommended): Node.js Installation Guide
- Clone the repository:
git clone https://github.com/ralphkb/sentinel-tickets.gitor download the latest release: https://github.com/ralphkb/sentinel-tickets/releases - Change to the project directory, for example:
cd ticket-bot-projector the directory where you uploaded the release files. - Run
npm installto install the dependencies - Rename .env.example to .env and config.yml.example to config.yml
- Open .env file and fill it with your bot's token, guild ID and client ID
- Open config.yml to configure the settings and messages to your liking, make sure to properly configure the ticket categories
- Start the bot:
npm start
- Make a backup of your current bot directory in case of issues so you have the option to revert back.
- Make sure not to delete your
datadirectory otherwise you might run into issues with tickets that you did not delete yet. - Download the new release/files and replace the current files with the ones you downloaded.
- If you already followed the installation process, you can use the latest
config.yml.exampleyou downloaded to manually add any new config options to yourconfig.yml. - If any dependencies got updated, you will have to delete your
node_modulesdirectory and runnpm installagain after you've already uploaded the new files. - Start the updated bot using
npm start
- Up to 25 Categories: Organize support requests in different categories.
- Intuitive Ticket Panel: Create and manage tickets with ease using buttons or a select menu.
- Option to create many ticket panels and send them to any channel.
- Modal Questions: Gather necessary information before opening a ticket.
- Configuration to customize many of the messages and embed options.
- Option to configure support roles per ticket category.
- Option to require one or more roles to create a ticket per ticket category.
- Option to ping support roles on ticket creation per ticket category.
- The ability to have configure fallback categories if one becomes full.
- Edit permissions of the ticket creator, support roles, added roles and added users per ticket category.
- Per Day Working Hours feature with an option to specify the timezone and block ticket creation outside the working hours.
- Option to configure the amount of max opened tickets at one time.
- Ticket claiming feature that can be turned on/off.
- Automatic saving of transcripts upon ticket deletion and force deletion.
- Option to manually save a transcript with images downloaded, use with caution as it increases the transcript size.
- Options to DM users upon ticket close, ticket reopen or the usage of the alert command.
- Option to DM users on ticket deletion with their transcript and an embed with useful information.
- Configurable rating/feedback system with logs of the responses.
- Option to select Transcript type, can be HTML or TXT however HTML is recommended.
- Ticket logs for multiple ticket events, such as ticket create, close, delete, force delete, reopen, claim, unclaim etc.
- Option to select a channel for each log event to be sent to.
- Precise and organized logs of errors and all ticket events in a logs.txt file.
- Option to edit the activity of the bot.
- Blacklist system with the ability to add users or roles with an optional reason and view them in a list.
- DM preference system, allowing users to toggle their preference regarding receiving DMs from the bot such as alert, close, reopen & delete.
- Multiple Commands: Efficiently manage tickets with various commands.
- Send the ticket panels in any channel using the panel id
- Add Users or Roles to a ticket
- Remove Users or Roles from a ticket
- Rename Ticket Channel
- Alert Ticket Creator
- Close Ticket to archive them until deleting them
- Delete Tickets
- Re-Open Tickets
- Save Transcripts
- Claim/Unclaim Tickets
- Move tickets to another category
- Pin tickets in a category
- Add a custom slowmode to a ticket
- Transfer ticket ownership to another user
- Add a priority to a ticket
- Close Request so users can request that staff close their ticket
- Context Menu Commands: Right click commands that are easy to use.
- Get User Info
- Blacklist Add
- Blacklist Remove
- Ticket Alert
- Ticket Pin
- Ticket Transcript
- Useful statistics such as:
- Total Tickets
- Total Open Tickets
- Total Claimed Tickets
- Total Messages
- Total Ticket Creators
- Average Tickets Created Per User
- Total Reviews
- Average Rating
If you find value in this project, you can support the continued development by joining my Patreon! https://www.patreon.com/Ralphkb
You may also consider leaving a star, all support is welcome and really appreciated, thank you! ❤️
You can find the documentation website of the bot here: https://sentinel-tickets-docs.pages.dev/
- For bug reports, open an issue here.
This is a free project that I enjoy working on in my free time, I cannot guarantee support however I will try my best to fix bugs, sort issues and add new features! I am still learning and improving, thank you for your understanding. 😄
Join my Discord Server for community support. Patreon members receive unique roles and perks on the discord.
This project is licensed under the MIT License.