-> Invite the bot

Tickette is a Discord bot that creates customizable ticket systems using threads. When users click on a ticket button, a modal opens where they can fill in information you've configured. This information is then used to generate the ticket thread name and determine who gets access.

Key Features:

• No Database Required - All templates are stored as JSON files in your Discord server for maximum security
• Thread-Based Tickets - Easy management with Discord's native thread features (archive, add users, delete)
• Customizable Fields - Create modal forms with various input types
• Dynamic Thread Names - Use templates with variables that get replaced by user input

A template is a blueprint for creating tickets. Each template contains:

• Thread Name Template - Pattern for naming the ticket thread (e.g., {{type}} | {{nickname}})
• Role(s) - Role(s) automatically added to the ticket thread
• Optional Fields - Custom form fields shown in the modal

Fields are the input elements shown in the modal when a user opens a ticket. They allow you to collect information that can be used in the thread name.

Each field has the following properties:

If you create a field with:

• id: problem_type
• name: "What type of issue?"
• type: short
• required: true
• placeholder: "e.g., Technical, Billing, General"

And set the thread name template to: {{problem_type}} - {{nickname}}

When a user fills in "Technical Support" and their nickname is "John", the thread will be named: "Technical Support - John"

You can use these pre-defined variables in your thread name template without creating fields:

• Template Storage: Templates are saved as JSON files pinned in the channel where you run the command
• Message ID: Many commands require the message_id of the template's JSON file. Enable Developer Mode in Discord, right-click the message, and select "Copy Message ID"
• Message Link: You can also use a Discord message link instead of just the ID
• Channel Context: If using only the message ID (not a link), run the command in the same channel as the template

Creates a new ticket template with an embedded message and button.

You can add up to 4 custom fields when creating a template:

• field_1_id, field_1_name, field_1_description, field_1_type, field_1_required
• field_2_id, field_2_name, etc.
• (up to field_4_...)

/new
  title: "Report a Bug"
  thread_name: "🐛 {{bug_type}} | {{nickname}}"
  role: @Support Team
  description: "Click the button below to report a bug"
  channel: #bug-reports
  field_1_id: bug_type
  field_1_name: "Type of bug"
  field_1_type: short
  field_1_required: true

Updates the thread name template for an existing ticket configuration.

/rename
  message_id: 1234567890
  thread_name: "[{{date}}] {{type}} - {{display}}"

Add or remove roles from a template.

/role
  message_id: 1234567890
  action: add
  role: @Moderators

Adds a new field to the template modal.

/fields add
  message_id: 1234567890
  field_id: priority
  field_name: "Priority Level"
  field_description: "How urgent is this issue?"
  field_type: short
  field_required: true

Modifies an existing field. You can update any property individually.

/fields edit
  message_id: 1234567890
  field_id: priority
  field_required: false

Deletes a field from the template.

/fields remove
  message_id: 1234567890
  field_id: priority

Modifies the appearance of the ticket button embed.

/embed edit
  message_id: 9876543210
  color: #00FF00
  title: "🎫 Open a Support Ticket"

Recreates the ticket button embed if it was accidentally deleted.

/embed recreate
  channel: #tickets
  message_id: 1234567890
  title: "Support Tickets"
  description: "Click below to open a ticket"

Creates a new private thread in any text channel and invites selected users or roles to it.

1. Run the command with the thread name (and optional message)
2. A modal will appear where you can select users and/or roles to invite
3. The bot creates the private thread and adds all selected users
4. If you select roles, all members with those roles will be added to the thread

/private_thread
  name: "Team Discussion - Project Alpha"
  message: "Let's discuss the new project requirements here."

After running this command, a modal will open where you can select which users or roles should be added to the private thread.

If you encounter issues or have questions:

1. Check that you have the Manage Channels permission
2. Verify you're using the correct message ID
3. Ensure Developer Mode is enabled in Discord settings
4. Make sure the bot has appropriate permissions in the channels

The footer of each embed contains the channel_id and message_id for reference.