Skip to content

Tickets

Jump to bottom
Cyrusbye720 edited this page Jun 6, 2026 · 3 revisions

Tickets

A private Discord channel is created per ticket, accessible to the requester and the configured support roles. Tickets can be opened from Discord (/ticket) or from Minecraft (/zdiscord ticket <subject>).

Configuration

tickets:
  enabled: true
  support-roles:
    - "123456789012345678"
  max-per-user: 3
  auto-close-hours: 48

max-per-user limits how many tickets a single Minecraft UUID or Discord ID can have open. Closing a ticket decrements both keys.

Flow

  1. The user runs /ticket <subject> in Discord or /zdiscord ticket <subject> in Minecraft.
  2. A new text channel is created under channels.ticket-category with the name ticket-NNNN-username. The @everyone role is denied view access; the support roles and the requester are granted view and send access.
  3. A control message with Close and Claim buttons is posted in the new channel.
  4. When a support member clicks Close, the message is replaced with a "ticket closed" notice and the channel is deleted after a short delay.

Support role

A user is considered support if they have any of the IDs in tickets.support-roles or have the Administrator permission.

Anti-spam

The ticket creation checks max-per-user and rejects the request with a clear message if the user is at the limit.

ZDiscord v1.1.0 · Home · Issues · Source

Clone this wiki locally