🎫 MSK Ticket Bot

A modern, self-hosted Discord ticket bot built on Discord.js v14 and SQLite — no external database, no telemetry, full feature set out of the box.

✨ Features

Feature	Description
🎫 Ticket Types	Up to 25 configurable types with individual emoji, color, category & questions
📋 Questionnaires	Modal forms (up to 5 questions) shown when opening a ticket
🙋 Claim System	Staff can claim/unclaim — button toggles, embed & topic update automatically
🔴 Priorities	Low / Medium / High / Urgent via `/priority` — shown in channel topic & embed
📝 Staff Notes	Private notes via `/note add` / `/note list`
🔀 Move Ticket	Move to a different type/category via `/move` or button (staff only)
🛡️ Type-specific Staff Roles	Each ticket type can define its own staff roles
🖼️ Panel Logo & Banner	Optional logo thumbnail and/or banner image in the panel embed
🎛️ Panel Interaction Type	Choose between a Button or a direct Select Menu in the panel
⭐ Rating System	1–5 star feedback after closing, automatically posted to a configured channel
⏰ Staff Reminder	Automatic ping inside the ticket if no staff responds within X hours
⏰ Auto-Close	Automatically close inactive tickets with a configurable warning period
🔗 Transcript Links	Transcripts stored online and accessible via a public link
📄 HTML Transcript	Full HTML transcript with all messages, embeds and attachments
🌐 Custom Domain	Premium users can serve transcripts under their own domain
📊 Statistics	Server-wide stats and detailed per-user stats via `/stats`
🚫 Blacklist	`/blacklist add/remove/list` to block users from opening tickets
🌍 Multilingual	German and English included, easily extensible
🗄️ SQLite	No external database required — file is created automatically

🔗 MSK Transcript Service

Instead of sending transcripts as file attachments via DM, the bot can upload them to www.msk-scripts.de and generate a public link — accessible in any browser, no download required.

Subscription Tiers

Feature	Basic (free)	Premium (€5/mo)	Premium+ (€10/mo)
Transcript as link	✅	✅	✅
Max. transcript size	10 MB	100 MB	250 MB
File attachments in transcript	❌	✅	✅
Max. attachment size per ticket	—	150 MB	500 MB
Custom domain	❌	✅	✅
Storage duration	30 days	60 days	90 days

Premium and Premium+ are unlocked via GitHub Sponsors.

Getting your API Key

Visit www.msk-scripts.de/verify
Sign in with your GitHub account
Connect your Discord account
Select your server → your API key is generated instantly

Then add it to your .env:

MSK_API_KEY="your_api_key_here"
MSK_API_URL="https://www.msk-scripts.de"

Custom Domain (Premium & Premium+)

Premium users can serve transcripts under their own domain (e.g. tickets.yourserver.com).

Visit www.msk-scripts.de/dashboard after verifying
Enter your domain and set a DNS A-Record pointing to the server IP shown
Click "Check DNS" once propagation is complete — SSL is set up automatically

📖 Full setup guide: docu.msk-scripts.de

📁 Project Structure

discord_ticketbot/
├── index.js                    # Entry point
├── package.json
├── .env.example                # Environment variable template
├── ticketbot.service           # systemd unit file for Linux servers
├── assets/                     # Static files (logo, banner images)
│   ├── logo.png                # Panel logo thumbnail (place your own here)
│   └── banner.png              # Panel banner image (place your own here)
├── config/
│   └── config.example.jsonc    # Configuration template (with comments)
├── docs/
│   ├── setup-en.md             # MSK Transcript Service setup guide (English)
│   └── setup-de.md             # MSK Transcript Service setup guide (German)
├── locales/
│   ├── de.json                 # German
│   └── en.json                 # English
├── data/
│   └── tickets.db              # SQLite database (auto-created)
└── src/
    ├── client.js               # Extended Discord Client
    ├── config.js               # Config loader & validation
    ├── database.js             # All DB operations (SQLite)
    ├── handlers/
    │   ├── commandHandler.js   # Loads & registers slash commands
    │   ├── eventHandler.js     # Loads Discord events
    │   └── componentHandler.js # Loads buttons, modals, menus
    ├── commands/               # Slash commands
    │   ├── setup.js            # /setup      – Send panel
    │   ├── close.js            # /close      – Close ticket
    │   ├── add.js              # /add        – Add user
    │   ├── remove.js           # /remove     – Remove user
    │   ├── claim.js            # /claim      – Claim ticket
    │   ├── unclaim.js          # /unclaim    – Unclaim ticket
    │   ├── move.js             # /move       – Move ticket
    │   ├── rename.js           # /rename     – Rename channel
    │   ├── transcript.js       # /transcript – Generate HTML transcript
    │   ├── priority.js         # /priority   – Set priority (topic + embed)
    │   ├── note.js             # /note       – Staff notes
    │   ├── blacklist.js        # /blacklist  – Block users
    │   └── stats.js            # /stats      – Statistics (server & user)
    ├── events/
    │   ├── ready.js            # Bot start, status, auto-close & staff reminder loop
    │   ├── messageCreate.js    # Track last activity
    │   └── interactionCreate.js # Route all interactions
    ├── components/
    │   ├── buttons/
    │   │   ├── openTicket.js       # tb_open
    │   │   ├── closeTicket.js      # tb_close
    │   │   ├── claimTicket.js      # tb_claim
    │   │   ├── unclaimTicket.js    # tb_unclaim
    │   │   ├── moveTicket.js       # tb_move
    │   │   ├── deleteTicket.js     # tb_delete
    │   │   ├── deleteConfirm.js    # tb_deleteConfirm
    │   │   ├── deleteCancel.js     # tb_deleteCancel
    │   │   └── rateTicket.js       # tb_rate:N
    │   ├── modals/
    │   │   ├── closeReason.js      # tb_modalClose
    │   │   └── ticketQuestions.js  # tb_modalQuestions:type
    │   └── menus/
    │       ├── panelSelect.js      # tb_panelSelect
    │       ├── ticketType.js       # tb_selectType
    │       └── moveSelect.js       # tb_moveSelect
    └── utils/
        ├── logger.js           # Coloured console logger
        ├── embeds.js           # All embed constructors
        ├── transcript.js       # HTML transcript generator
        ├── mskApi.js           # MSK Transcript Service API client
        └── ticketActions.js    # Core logic: openTicket, performClose, performMove

🚀 Installation

Requirements

Node.js v18 or newer
A Discord bot token — discord.com/developers/applications

1. Install dependencies

cd discord_ticketbot
npm install

2. Set up environment variables

cp .env.example .env

Fill in .env:

# Required
TOKEN="your_bot_token"
CLIENT_ID="your_application_id"
GUILD_ID="your_server_id"

# Optional — MSK Transcript Service (get your key at www.msk-scripts.de/verify)
MSK_API_KEY="your_msk_api_key"
MSK_API_URL="https://www.msk-scripts.de"

3. Set up the configuration

cp config/config.example.jsonc config/config.jsonc

Edit config/config.jsonc as needed — all fields are commented.

4. Start the bot

npm start

On first start the bot will automatically:

Create the SQLite database at data/tickets.db
Register all slash commands on your server

5. Set up the panel

Run /setup on your Discord server (Administrator permission required). The bot will send the ticket panel to the channel configured in openTicketChannelId.

🖥️ Autostart with systemd (Linux Server)

The included ticketbot.service file lets the bot start automatically after a server reboot.

1. Copy the bot files to the server

sudo cp -r discord_ticketbot /opt/discord_ticketbot
sudo useradd -r -s /bin/false discord
sudo chown -R discord:discord /opt/discord_ticketbot

2. Set up .env on the server

sudo nano /opt/discord_ticketbot/.env

3. Verify the Node.js path

which node
# e.g.: /usr/bin/node

If the path differs, adjust ExecStart in ticketbot.service accordingly.

4. Install the systemd unit

sudo cp /opt/discord_ticketbot/ticketbot.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now ticketbot.service

5. Check the status

sudo systemctl status ticketbot.service
sudo journalctl -u ticketbot.service -f

Useful commands

Command	Description
`sudo systemctl start ticketbot.service`	Start the bot
`sudo systemctl stop ticketbot.service`	Stop the bot
`sudo systemctl restart ticketbot.service`	Restart the bot
`sudo systemctl enable ticketbot.service`	Enable autostart
`sudo systemctl disable ticketbot.service`	Disable autostart
`sudo journalctl -u ticketbot.service -f`	Follow live logs

⚙️ Slash Commands

Command	Permission	Description
`/setup`	Administrator	Send the ticket panel
`/close [reason]`	Configurable	Close the current ticket
`/claim`	Staff	Claim a ticket — updates topic & embed, button toggles to Unclaim
`/unclaim`	Staff	Release a claimed ticket — updates topic & embed, button toggles back
`/move`	Staff	Move ticket to a different type/category
`/add <user>`	Staff	Add a user to the ticket
`/remove <user>`	Staff	Remove a user from the ticket
`/rename <name>`	Staff	Rename the ticket channel
`/transcript`	Staff	Generate an HTML transcript
`/priority <level>`	Staff	Set ticket priority (updates channel topic & embed)
`/note add <text>`	Staff	Add a staff note
`/note list`	Staff	List all notes for this ticket
`/stats`	Staff	Server-wide ticket statistics
`/stats @user`	Staff	Detailed statistics for a specific user
`/blacklist add`	Manage Guild	Block a user
`/blacklist remove`	Manage Guild	Unblock a user
`/blacklist list`	Manage Guild	Show the blacklist

🔘 Ticket Buttons

Every ticket channel contains a button row at the top:

Button	Visible when	Description
🔒 Close Ticket	Always (configurable)	Disables all buttons, generates transcript, closes & renames channel
🙋 Claim	`claimButton: true`, not yet claimed	Staff claims — topic & embed update, button becomes Unclaim
🙌 Unclaim	`claimButton: true`, already claimed	Staff releases — topic & embed update, button becomes Claim
🔀 Move	More than 1 ticket type configured	Staff opens type selection (staff only)
🗑️ Delete Ticket	After closing	Deletes the channel after confirmation

🛠️ Configuration Reference

Panel Interaction Type

"panel": {
  "interactionType": "BUTTON"    // "BUTTON" (default) or "SELECT_MENU"
}

Mode	Behaviour
`"BUTTON"`	A green button is shown. Clicking it opens an ephemeral select menu — always fresh, no Discord caching issue.
`"SELECT_MENU"`	The select menu is shown directly in the panel. After every use it automatically resets, so users never need to restart Discord to open a second ticket of the same type.

Panel Logo & Banner

"panel": {
  "logo":   { "enabled": true, "file": "logo.png"   },
  "banner": { "enabled": true, "file": "banner.png" }
}

Supported formats: PNG, JPG, GIF, WEBP. Run /setup again after adding or changing images.

Channel State Overview

State	Channel Name	Channel Topic	Opening Embed
Ticket opened	`ticket-username`	`🟡 Medium`	Priority: 🟡 Medium
`/priority urgent`	`ticket-username`	`🔴 Urgent`	Priority: 🔴 Urgent
`/claim`	`ticket-username`	`🟡 Medium \| 🙋 Claimed by @Staff`	+ Claimed by field
`/unclaim`	`ticket-username`	`🟡 Medium`	field removed
Ticket closed	`closed-ticket-username`	unchanged	all buttons removed

Note on rate-limits: Discord limits channel topic changes to 2 per 10 minutes. A warning is shown in the ticket and the update appears automatically once the limit resets.

Ticket Types

{
  "codeName": "support",
  "name": "Support",
  "description": "...",
  "emoji": "💡",
  "color": "#ff0000",             // Hex color or "" to use mainColor
  "categoryId": "123456789",
  "ticketNameOption": "",         // USERNAME, USERID, TICKETCOUNT or ""
  "customDescription": "...",     // Variables: REASON1, REASON2, USERNAME, USERID
  "cantAccess": ["roleId"],
  "staffRoles": [],               // Type-specific staff roles
  "askQuestions": true,
  "questions": [
    { "label": "Question", "placeholder": "...", "style": "SHORT", "maxLength": 500 }
  ]
}

Staff Reminder

"staffReminder": {
  "enabled": true,
  "afterHours": 4,
  "pingRoles": true
}

The bot checks all open tickets every 15 minutes. Each ticket is only reminded once.

Rating System

"ratingSystem": {
  "enabled": true,
  "dmUser": true,
  "ratingsChannelId": "CHANNEL_ID_HERE"
}

Auto-Close

"autoClose": {
  "enabled": true,
  "inactiveHours": 48,
  "warnBeforeHours": 6,
  "excludeClaimed": true
}

Statistics

/stats shows server-wide numbers. /stats @user shows a detailed profile split into 👤 As a User and 🛡️ As Staff.

🗄️ Database Schema

The SQLite database is created automatically at data/tickets.db. Existing databases are automatically migrated if columns are missing.

Table	Contents
`tickets`	All tickets: status, type, priority, claim info, reminder, transcript
`blacklist`	Blocked users with reason and timestamp
`staff_notes`	Private staff notes per ticket
`ratings`	Ratings (1–5 ⭐) with optional comment

🌍 Adding a New Language

Copy locales/de.json, e.g. as locales/fr.json
Translate all strings
Set "lang": "fr" in config/config.jsonc

📖 Documentation

Full documentation is available at docu.msk-scripts.de.

📝 License

AGPL-3.0 — Source code must remain open and be published under the same license when distributed or hosted.

Name		Name	Last commit message	Last commit date
Latest commit History 45 Commits
.github		.github
assets		assets
config		config
docs		docs
locales		locales
src		src
.env.example		.env.example
.gitattributes		.gitattributes
.gitignore		.gitignore
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
LICENSE		LICENSE
README.md		README.md
README_GER.md		README_GER.md
index.js		index.js
package.json		package.json
ticketbot.service		ticketbot.service

Uh oh!

Folders and files

Latest commit

History

Repository files navigation

🎫 MSK Ticket Bot

✨ Features

🔗 MSK Transcript Service

Subscription Tiers

Getting your API Key

Custom Domain (Premium & Premium+)

📁 Project Structure

🚀 Installation

Requirements

1. Install dependencies

2. Set up environment variables

3. Set up the configuration

4. Start the bot

5. Set up the panel

🖥️ Autostart with systemd (Linux Server)

1. Copy the bot files to the server

2. Set up .env on the server

3. Verify the Node.js path

4. Install the systemd unit

5. Check the status

Useful commands

⚙️ Slash Commands

🔘 Ticket Buttons

🛠️ Configuration Reference

Panel Interaction Type

Panel Logo & Banner

Channel State Overview

Ticket Types

Staff Reminder

Rating System

Auto-Close

Statistics

🗄️ Database Schema

🌍 Adding a New Language

📖 Documentation

📝 License

About

Topics

Resources

License

Code of conduct

Uh oh!

Stars

Watchers

Forks

Releases 3

Sponsor this project

Uh oh!

Uh oh!

Contributors

Uh oh!

Languages