Commands - HoshiKurama/TicketManager GitHub Wiki

TicketManager has many commands. Sometimes text is clickable, but usually users must interact with the plugin via commands. The remainder of this page provides details on each TM command.

assign

Assigns a ticket to a specified user, phrase, or group.

Format
/ticket assign [Ticket ID] player [Player] (Regular; to player)
/ticket assign [Ticket ID] group [Group] (Regular; to group)
/ticket assign [Ticket ID] phrase [Phrase] (Regular; a phrase)
/ticket s.assign [Ticket ID] player [Player] (Silent; to player)
/ticket s.assign [Ticket ID] group [Group] (Silent; to group)
/ticket s.assign [Ticket ID] phrase [Phrase] (Silent; a phrase)

As implied above, assignments must specify the target. This impacts tab-completion options and affects assignment count.

claim

Asssigns a ticket to yourself.

Format
/ticket claim [Ticket ID] (Regular)
/ticket s.claim [Ticket ID] (Silent)

close

Closes a ticket with or without a comment.

Format
/ticket close [Ticket ID] (Regular + Without Comment)
/ticket close [Ticket ID] [Comment...] (Regular + With Comment)
/ticket s.close [Ticket ID] (Silent + Without Comment)
/ticket s.close [Ticket ID] [Comment...] (Silent + With Comment)

closeall

Closes all tickets between the bounds inclusively.

Format
/ticket closeall [Lower ID] [Upper ID] (Regular)
/ticket s.closeall [Lower ID] [Upper ID] (Silent)

comment

Comments on a ticket.

Format
/ticket comment [Ticket ID] [Comment...] (Regular)
/ticket s.comment [Ticket ID] [Comment...] (Silent)

create

Creates a ticket.

Format: /ticket create [Message...]

deepview

View ticket information with full action history

Format: /ticket deepview [Ticket ID]

help

View the help page with command information in-game.

Format: /ticket help

history

View a user's ticket creation history.

Format
/ticket history (Own history)
/ticket history [User] (History of specified user)
/ticket history [User] [Page] (History of specific user at the specified page)

list

Lists all open tickets.

Format
/ticket list (Page 1)
/ticket list [Page] (Specified Page)

listassigned

Lists all open tickets assigned to you. This includes tickets assigned to any permission group you belong to.

Format
/ticket listassigned (Page 1)
/ticket listassigned [Page] (Specified Page)

listunassigned

List all unassigned open tickets.

Format
/ticket listunassigned (Page 1)
/ticket listunassigned [Page] (Specified Page)

reload

Reloads plugin. Allows new config and locale file changes to take effect without restarting the server.

Format: /ticket reload

reopen

Reopens a ticket.

Format
/ticket reopen [Ticket ID] (Regular)
/ticket s.reopen [Ticket ID] (Silent)

search

Searches for all tickets in the database that meet the specified constraints.

Format: /ticket search where [Constraints...]

A few helpful notes about this command:

  • All constraints follow the same pattern:
    • type <symbol> value(s)
  • Applicable symbols vary with the constraint type
  • Multiple constraints are combined with && and makes results match ALL constraints. For example,
    • creator = HoshiKurama && priority = 5
  • Constraint order does not matter. For example:
    • creator = HoshiKurama && time < 4 hours && priority != 3
    • time < 4 hours && priority != 3 && creator = HoshiKurama
    • Both yield identical results
  • Repeated criteria override the searched value. For example:
    • creator = HoshiKurama && priority = 1 && priority = 3
    • creator = HoshiKurama && priority = 3
    • Both yield identical results.
Unique Keyword Notes
  • keywords: can accept multiple values separated by ||. For example:
    • keywords = Kotlin || TicketManager || Hoshi
  • assignedto: assignments are checks by assignment type. For example:
    • assignedto = user HoshiKurama (to user HoshiKurama)
    • assignedto = group admin (to group admin)
    • assignedto = phrase insert phrase here (to "insert phrase here")
    • assignedto = Console (to Console)
    • assignedto = Nobody (not assigned to anyone)
Keyword Symbols Description Examples
assignedto =, != Ticket assignment assignedto = user HoshiKurama, assignedto != group Developer,
closedby =, != User who has closed the ticket before closedby = HoshiKurama
creator =, != Creator's name creator = HoshiKurama
keywords =, != Keywords within the initial ticket and subsequent comments. Keywords may or may not be in the same comment keywords = Kotlin, keywords = Kotlin || Java
lastclosedby =, != Last user to close ticket lastclosedby = HoshiKurama
priority =, !=, <, > Priority between 1 and 5 or LOWEST to HIGHEST priority != 3, priority > NORMAL
status =, != Ticket Status status = OPEN, status = CLOSED
time =, != Ticket's maximum age time > 2 weeks, time < 4 weeks 12 hours 13 seconds
world =, != name of world ticket was created in world = world_THE_END

setpriority

Sets a ticket's priority.

Format
/ticket setpriority [Ticket ID] [Priority] (Regular)
/ticket s.setpriority [Ticket ID] [Priority] (Silent)

Priority values should be between 1 and 5 inclusive, with

  • 1: lowest priority
  • 5: highest priority Alternatively, use LOWEST to HIGHEST.

teleport

Teleport to a ticket's creation location

Format: /ticket teleport [Ticket ID]

version

View plugin version and the wiki link. This is always viewable by all users.

Format: /ticket version

view

View ticket information with comments.

Format: /ticket view [Ticket ID]

unassign

Assign a ticket back to no one.

Format
/ticket unassign [Ticket ID] (Regular)
/ticket S.unassign [Ticket ID] (Silent)
⚠️ **GitHub.com Fallback** ⚠️