Simple Help Tickets
Simple Help Tickets
Description:Simple Help Tickets provides a simple and effective system for users to request the assistance of an admin. Starting out as a rather lightweight plugin I threw together for personal use and decided to share, it has continued to expand due to popular demand. By using /ticket a user can open a help ticket, which can then be reviewed and dealt with by an administrator. Both users and admin are able to reply to tickets to further dialogue regarding a ticket. If a user logs in and an open ticket has received a reply from an admin, they will be notified of the change.
Installation:Updating to 1.0
If you are updating to 1.0 you will need to start with a fresh database.
If you're using SQLite simply delete Tickets.db in SimpleHelpTickets plugin directory
MySQL users, delete the table SHT_Tickets in your database, it will be replaced on server start.
1. Download the .jar
2. Place the .jar in your plugins directory
3. Restart the server
Configuration:
• MaxTickets
Maximum number of tickets per user.
• TicketExpiration
Number of days before a closed ticket expires
• NotifyAdminOnTicketClose
Users with the sht.admin permission will receive a message when a ticket is closed.
• MultiWorld
If using more than one world, take/check ticket will display the appropriate world name in ticket details
• OnJoin
Display number of personal tickets to user / total tickets to admin upon join
• USE_MYSQL
Whether to use MySQL instead of SQLite output.yml
• Use to customize plugin output (Language / Formatting)
Commands:
• /helptickets - SimpleHelpTickets Menu.
• /ticket (description) - Open a help ticket.
• /tickets [-a/-c] - List Open/All/Closed tickets.
• /checkticket <#> - Check the details of a ticket.
• /taketicket <#> - Assign self to a ticket. (and be teleported to the location is was set)
• /replyticket <#> <reply> - Reply to a ticket
• /closeticket [-r] <#> - Close a help ticket.
• /delticket (#) - Delete a help ticket.
• /purgetickets [-c/-a] - Purge expired, Closed or All tickets
Permissions:
• sht.ticket - Open a help ticket.
• sht.admin - Administrate help tickets.
• sht.reload - Reload SimpleHelpTickets.
To Do:
•
•
•
•
•
Web GUI
By popular demand, a Web GUI is available for SimpleHelpTickets.
You can download it below. • SimpleHelpTickets Web GUI
Thankyou for your support! :D Recent Change-Log:
1.4
- Updated for Spigot API 1.10.2
- UPDATED: Updated for new UUID system
(Caveats: UUID not translated to player name)
- Fixed: bug when reopening a ticket
1.3.6
- FIXED: MaxTickets not limiting the amount of tickets a user can open
- FIXED: User OnJoin notification of open tickets repeating itself
- FIXED: MySQL Connection Check. (Merged PR: TheCutter)
1.3.5
- Updated extra formatting to not interfere with colour codes
- Recoded ticket.class
- Fixed "CONSOLE has opened a ticket" bug for MySQL users
- Fixed notification of admin reply on user join
1.3.4
- Added bold/italic/underline/strike/reset to output.yml
- Fixed typo in output.yml
- Added check to getconnection in mysqlconnection.java to ensure connection is established, and if not re-stablish connection before continuing.
1.3.3
- minor bugfix: Users rceiving notification about open tickets even if tickt is/are closed
- minor bugfix: Prefix removed from 'No Tickets To Display' message
- minor bugfix: Instances of getDisplayName changed to getName in closeticket & taketicket (Fronix)
- minor bugfix: A few typos in output.yml have been fixed (if your output.yml is unchanged, delete it before starting your server to generate a new one)
Pls reup the web gui
@Maniaclese
yeaahh this plugin was amazing! The Web GUI Link dont work... :D
The plugin is awesome and compared to others it seems quite easy to setup and use.
One suggestion would be a permissions node that would allow people in certain groups to bypass the maximum number of tickets limit. So while the average user would get say 3 or 5 tickets, a staff member could make unlimited tickets. We like to use this system internally so this would be quite helpful.
Node example: sht.maxtickets.bybass (could be given to all staff)
sht.maxtickets.# (In this case, groups could be assigned whatever number you wish to give them)
Keep up the good work!
Hi,
Is anyone here able to download the web GUI?
This is one amazing plugin and I would love to have web access too :)
Is there anyway to split the upper level permissions? Such as, I would like purgetickets and (admin) delticket to be on their own nodes.
Amazing plugin Odiumxxx, could you please add an option to change the [SimpleHelpTickets v.0.95 (or any other version)] to a custom text or will it not change because you would like to promote the plugin, we don't really mind though, but if it was added it would be cool, plus, credit will be given to you on our very own SHT Web GUI, Thank You!
Hello really n1 plugin! i found a bug? I set the Prefix in the output...but when i type /ticket he says [ SimpleHelpTickets ] ? :D
And the WebGUI Link dont work.
@BlackFing85
Have you even tried to plugin?
Noob explenation on how the plugin works: Example situation: A player gets griefed.
Player A (The griefed player) logs on, after being offline for a while, he finds his build completely destroyed and griefed. He does /ticket grief at the location of the grief
Player B (a server admin) logs on, and see that a new ticket has been made, he checks for new tickets and finds Player A's ticket, he use /taketicket [#] and gets teleported to the location where Player A created his ticket.
That's why you have to stand in the location, so the admin/mod can see what he needs help with.
Why do you have to stand in the location? It says that in User Commands help
@diannetea
Nicely caught.
sht.reload wasn't listed in the above permissions, it is now listed.
lol with sht.admin it tells me I don't have permission to reload it :(
@xxtalamanderxx
There doesn't appear to be anything in the code which would cause this.
My immediate assumption is that you've configured your permissions incorrectly.
Can you check that you the sht.admin permission is distributed correctly?
Can you tell me a little more about the error?
Are you using MySQL or SQLite?
Cheers.
I found that players can delete other players tickets. Is there a way I can prevent players from doing this? A permission node I can use? This plugin is great and I'd like to keep it if I could fix this. Thanks
@GodsDead
I am also having this issue, the max does not do anything at all.
@Odiumxxx
Looking for two potential new commands if you're willing:
/assignticket -> Something so staff can assign a ticket to another staff member if a particular person is needed to handle the ticket
/escalateticket -> Something so a staff member can flag a ticket so an admin is notified (or at least sees in the list) something they should handle asap.
Just installed this and activated MYSQL, added perms, it works, but MaxTickets does not work, a user can create an infinate amount of tickets, with no cooldown.
A much much better option for a web interface would be to use an existing ticket system, like the open source OSTicket, or even one of the big boys Kayako, WHMCS or zendesk. They all have API's for really easy integration.
Could u make a config option for disabling teleporting to the ticket creation location?
Hey Odiumxxx,
MaxTickets in config.yml gets ignored. Could you please fix it?
Hello I am having a issue with SHT. Every time someone connects to the server I get this error in the server log: [14:00:21] [Server thread/INFO]: §7[SimpleHelpTickets] §cError:§f com.mysql.jdbc.exceptions.jdbc4.MySQLNonTransientConnectionException: No operations allowed after connection closed.Connection was implicitly closed by the driver.