Configuration

🛠️ Configuration Reference

Startup Log Visibility

"showLog": true   // Show INFO log messages on startup (commands, events, components)
                  // Set to false for a cleaner output in production

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":   { "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
`/lock lock`	`ticket-username`	unchanged	lock notice posted
Ticket closed	`closed-ticket-username`	unchanged	all buttons removed
Reopen	`ticket-username`	restored	reopen embed + ticket buttons restored

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",
  "priority": "medium",           // Predefined start priority: "low", "medium", "high" or "urgent" (defaults to "medium")
  "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 }
  ]
}

Bot Status

"status": {
  "enabled": true,
  "dynamic": false,              // true = live ticket count in status
  "dynamicText": "🎫 {open} open tickets", // placeholders: {open}, {total}, {closed}
  "dynamicInterval": 5,          // update interval in minutes
  "text": "Support Tickets",     // used when dynamic: false
  "type": "WATCHING",            // PLAYING, WATCHING, LISTENING, STREAMING, COMPETING
  "status": "online"
}

User Notifications

"userNotifications": {
  "enabled": true   // Show a 🔕 "Notify me" button in new tickets.
                    // User opts in → receives a DM when staff first replies.
                    // Rate-limited to 1 DM per 30 minutes per ticket.
}

Canned Responses (Snippets)

Snippets are defined in a separate file — not in config.jsonc:

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

{
  "snippets": [
    {
      "name": "welcome",
      "description": "Welcome message at the start of a ticket",
      "content": "Hey {user}! 👋 Thanks for opening a ticket. We'll be with you shortly.",
      "embed": {
        "title": "👋 Welcome",
        "color": "#5865F2"
      }
    },
    {
      "name": "docs",
      "description": "Link to the MSK-Scripts documentation",
      "content": "Hey {user}, check out our docs: https://docu.msk-scripts.de",
      "embed": null
    }
  ]
}

Available placeholders: {user} · {staff} · {type} · {priority}

Commands: /snippet send <name> · /snippet list

Snippets support autocomplete — start typing the name or description to filter.

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
}

Reopen

Closed tickets can be reopened via a ♻️ Reopen button on the closed-ticket message and the /reopen command.

"reopenOption": {
  "enabled": true,            // Master switch for the reopen feature (button + /reopen)
  "button": true,             // Show the ♻️ Reopen button on the closed-ticket message
  "whoCanReopen": "STAFFONLY" // "EVERYONE" or "STAFFONLY"
}

Field	Description
`enabled`	Master switch. When `false`, the button is hidden and `/reopen` replies that it is disabled.
`button`	Whether the `♻️ Reopen` button is shown on the closed-ticket message.
`whoCanReopen`	`"STAFFONLY"` (default) requires staff. `"EVERYONE"` allows anyone who can see the channel.

Reopening restores the creator's channel access, moves the channel back to its ticket type's category and drops the closed- name prefix.

Note: Closed channels are usually only visible to staff (the creator's view is removed on close), so "EVERYONE" mainly matters if you keep closed channels visible to users.

Transcript Design & Language

The generated HTML transcript can be rendered in two styles and two languages:

"transcriptDesign": "modern",  // "modern" (default) or "classic"
"transcriptLang": "en"         // "en" or "de" — falls back to English if omitted/unsupported

Value	Look
`"modern"`	Minimal, MSK-branded layout (default — also used if the key is absent).
`"classic"`	The original Discord-style dark layout.

transcriptLang localizes all transcript labels (header fields, section title, footer, copy-button tooltip) and the date format. "en" and "de" are built in; any other value falls back to English.

Both styles are fully self-contained / offline-safe (no external requests):

Avatars and custom emojis are embedded as Base64 (custom emojis fall back to :name: text if the image can't be fetched at generation time).
User mentions and the header fields Created by / Claimed by / Closed by are shown as display names instead of raw user IDs (unresolvable IDs fall back to the ID).
The header also shows Closed by and the close reason — the reason only when one was provided.
Fenced code blocks show their language as a small label (e.g. LUA) and have a copy button that copies the block to the clipboard. No syntax colouring (kept dependency-free).

Statistics

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

🛠️ Configuration Reference​

Startup Log Visibility​

Panel Interaction Type​

Panel Logo & Banner​

Channel State Overview​

Ticket Types​

Bot Status​

User Notifications​

Canned Responses (Snippets)​

Staff Reminder​

Rating System​

Auto-Close​

Reopen​

Transcript Design & Language​

Statistics​