HelpTicket
What is HelpTicket?
Most of the time on server's you will see user's persistently asking for help because someone had griefed or stolen from them. This plugin allows those users to file a ticket that staff can then look at and deal with as they see fit. If a staff member cannot deal with the situation they can assign the ticket to a staff member who can. When you port to a ticket you are not only assigned to the ticket but teleported and the situation is brought up on screen for you to see. Everything is fully customizable and documentation on this can be found here
Features
- MySQL support (through DeityAPI)
- Tickets are assigned a unique ID # which can be used to track the ticket
- Tickets can also be assigned a priority of LOW, MEDIUM, HIGH the default being MEDIUM
- Tickets will be sorted by the priority when viewing all tickets
- Fully customizable language.yml file
- Comment System
- Teleporting to location that ticket is made, viewing the situation just as the person who created the ticket
- Notifications of staff as well as members when ticket is modified
- Offline players will get notified of updates to their tickets when they join
- '/pe' being an alias for '/ticket' for people moving from PetitionPlugin to this
- If my plugin Mail is installed ticket creators will be notified of the status via an in game Mail if they are not online to see the change.
Requirements
Setup
- Place HelpTicket within your plugins folder
- Add permission nodes to users where relevant
- Optional: you can change almost every user message and formatting via the language.yml file I will update the language config wiki soon
Permissions
General Users
For general users you can add the helpticket.general.* or specify below
- helpticket.general.list
- helpticket.general.create
- helpticket.general.info
- helpticket.general.select
- helpticket.general.comment
- helpticket.general.close
Admin users
For admin users you can add the helpticket.admin.* . Or specify below, Note that admins should also have the helpticket.general.* permission as well
- helpticket.admin.tp
- helpticket.admin.assign
- helpticket.admin.priority
- helpticket.admin.purge
How to operate
After your set-up is all complete you are ready to start using it. You can use '/ticket ?' or '/ticket help' in-game to view a list of commands that can be used.
Before you start dealing with tickets you need to select one. To do this you type /ticket select <ticket-id> . After that you can deal with the ticket as you need to
Commands
User Commands
- /ticket list <OPEN/CLOSED> <page-number> - Shows all tickets
- /ticket [select/sel] [ticket-id] - Shows the selected tickets information
- /ticket info <page-number> - Shows the selected tickets information
- /ticket [create/new] [message] - Creates a ticket
- /ticket [comment/cmt] [message] - Comments on the selected ticket
- /ticket close <message> - Closes the selected ticket
Admin Commands
- /ticket [teleport/tp] - Teleports to the selected ticket
- /ticket assign [staff-name] - Assigns the selected ticket
- /ticket [priority/pri] [increase/decrease] - Alters the priority of the selected ticket
- /ticket purge [player-name] - Deletes all the tickets created by the player specified
Console Commands
- /ticket [comment/cmt] [ticket id] [ticket commenter] [message] - Comments on the selected ticket
- /ticket close [ticket id] [ticket commenter] <message> - Closes the selected ticket
- /ticket assign [ticket id] [staff-name] - Assigns the selected ticket
- /ticket [priority/pri] [ticket id] [increase/decrease] - Alters the priority of the selected ticket
- /ticket purge [player-name] - Deletes all the tickets created by the player specified
Extra Links
Source: GitHub
Documentation: Wiki
Player Made Tutorials
I'm having trouble with installing this plug-in, I get the following error:
I am using the latest update of this plug-in and I am running craftbukkit 1.3.1 R2.0
@vanZeben
Wonderful =) Thanks a lot!
@Stuntweed
Ahh alright, ill patch that and add in the teleport in the next version
@vanZeben
Thats ture, It just our mods are lazy and with the economy an all I just thought you know. Heck why not let them TP with the website as well!
There is however a bug with the comments via console. Instead of just commenting the text it will add ID, Commenter and the comment.
@Stuntweed
No problemo, and the teleport I didn't see as applicable.They would need to be in-game to run the teleport anyways, so instead of clicking a button on a site to teleport there, why not just type the actual teleport command?
@vanZeben
The webversion is very nested in our website so making it opensource would require me to basically recode everything. Perhaps when I have more freetime I'll make it =D
Btw you can't TP to the ticket with the console? :P
@imilkywayz
I originally had done this, but considering that most my plugins work better with additional features when used in conjunction with other of my plugins each maintaining their own Database connection, having a single connection open was a much preferred means. Also, this requirement helps get the "word out" of the API which hopefully will get developers on it, meaning a more stable and regulated database connection as opposed to each plugin maintaining their own, which has already proved to work, as a few developers have built plugins based off of the api.
I would use this however the requirement of deityapi turned me away. It would be a lot easier if you just included the contents of the deityapi in your source so its not a dependency. Keeping track of 1 plugin is easier then two, :P.
@Stuntweed
Yeah sure! I was planning on doing a web version for this anyways, which would require this. Let me get to the issues rnztrom posted and requested and ill add in your request into the next version as well... Any chance on the web version being open source and including it in the original post?
EDIT: Ok there you guys go, check the main description for information on command syntax
@vanZeben I will write this here as well just in case ^^
It would be awesome with a console command to manage tickets. I have developed a ticket system for our website however sending the information straight to the database wont update the players in-game. So if there was a command that could be executed in the console instead of having to run a command that runs AS a player that requires the moderators to be online when answering all tickets, that would make it easier.
My solution right now: Comment on website -> Send commands to serverconsole -> serverconsole("sudo $commenter ticket sel $id") -> serverconsole("sudo $commenter ticket comment $comment")
New solution: Comment on website -> Send commands to serverconsole -> serverconsole("ticketconsole comment $id $comment")
OR Comment on website -> Send commands to serverconsole -> serverconsole("ticketconsole tp $id")
OR Comment on website -> Send commands to serverconsole -> serverconsole("ticketconsole assign $mod $id")
And so on, hope you understand. I don't like the solution but I'm not sure how else to make it work on the website and in-game without setting up a small web server in HelpTicket.
@vanZeben
Sounds great! :)
@harryjamesuk
MySQL is a requirement on this plugin, if you don't use MySQL, the plugin will not work.
@thernztrom
Yeah ill check into the empty ticket issue and add a config value for max tickets open... I wont be able to do it today/tomorrow as im with family on a trip atm, however ill see if i can get to it on friday/this weekend...
@thernztrom
Also, along the empty ticket issue, would there be any way to block people so they only can have max 1 ticket opened at a time, so that they dont create lots of similar tickets.
Edit: Created a github issue for this.
@Asip
Same here, Using latest, Not using MySQL.
@vanZeben
Would it be possible to block people from creating empty tickets. Right now some on my server types wrong, or doesnt understand how it works and creates empty tickets.
So I have to close empty tickets all time, and it would be wonderfull if it was possible to block those.
@Llamasquishy
It supports any perm plugin supported in Vault. If its not supported by Vault, im not going to add in special support for plugins that are either a) not support by vault or b) dont support SuperPerms
I can't seem to get this working with GroupManager. The only way I am able to use any of the commands is via OPing myself. Does it not support GroupManager permissions, or am I doing something wrong? I have tried with a fresh 1.3.1-R2.0 RB and the latest version of HelpTicket (also tried older versions), and I also tried with a fresh 1.2.5-R4.0 RB with the matching GroupManager and HelpTicket, to no avail. The plugin works, but permissions aren't working with GroupManager. I have also tried with and without Vault, to no avail. Would you be able to add support for GroupManager? Thanks!
- Llamasquishy
@Asip
This is a very random question. I will need some context as to if you are using DeityAPI as well and which version, as well as version info on help ticket as well. Your comment means nothing atm really, since there is good feedback from others that the plugin is indeed working so im assuming its a user error atm
Hello, can I get help. I got the plugin and when I went to the config. There is no stuff in the config.yml file
Also when I type the command /ticket Theres no commands that pop up, and If I type /help helpticket it says /Ticket : null
@Necavi
yeah understandably so
@weja93
I just inserted some generic information into the language for these actions. They all can be customized so that they messages suit what you need. Also ill probably just show the info when you select it as well...