Simple Help Tickets

Table of Contents

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.

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.

Installation:
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:
• ~~Add config options for customizing messages.~~Done.
• ~~Add SQLite support, expand ticket communication and logging.~~Done.
• ~~Add MySQL Support.~~Done.
• ~~Add resolve ticket feature.~~Done.
• ~~Add ticket expiration.~~Done.
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)

Comments

_ForgeUser8452758
- Join Date: 2/19/2012
- Posts: 44
- Member Details
#30 _ForgeUser8452758

View User Profile

Send Message

Posted Apr 26, 2012
@Odiumxxx

Which permissions node(s) do I use so a user does not see all tickets, but just those opened by them? Also, can I prevent them from using /checkticket on tickets not created by them?

Rollback Post to Revision RollBack
_ForgeUser7156827
- Join Date: 7/7/2011
- Posts: 222
- Member Details
#29 _ForgeUser7156827

View User Profile

Send Message

Posted Apr 26, 2012
You can;t reply to a ticket more than once.........

http://pastebin.com/4Dbws36u

Rollback Post to Revision RollBack
_ForgeUser8170698
- Join Date: 12/30/2011
- Posts: 272
- Member Details
#28 _ForgeUser8170698

View User Profile

Send Message

Posted Apr 26, 2012
@Jayyx2

Glad you like it, and thanks. :D

I've just finished the long-awaited rewrite to include a lot of the functionality people were after.

In the newest version (0.5) a user can see a list of their own tickets with /tickets and check one of their ticket's status (Replies, admin assigned, etc) with /checkticket <Ticket#>

I'm assuming this is what you meant?

Rollback Post to Revision RollBack
_ForgeUser8452758
- Join Date: 2/19/2012
- Posts: 44
- Member Details
#27 _ForgeUser8452758

View User Profile

Send Message

Posted Apr 26, 2012
I really like this plugin. Thanks for your work on this. Not sure if possible, but could a user check on the status of their ticket?

Rollback Post to Revision RollBack
_ForgeUser7800795
- Join Date: 11/2/2011
- Posts: 231
- Member Details
#24 _ForgeUser7800795

View User Profile

Send Message

Posted Apr 24, 2012
RustyDagger is right, hope to see that in near future.

Rollback Post to Revision RollBack
_ForgeUser8170698
- Join Date: 12/30/2011
- Posts: 272
- Member Details
#23 _ForgeUser8170698

View User Profile

Send Message

Posted Apr 21, 2012
@RustyDagger

Good idea.

Rollback Post to Revision RollBack
_ForgeUser6852073
- Join Date: 5/20/2011
- Posts: 560
- Member Details
#22 _ForgeUser6852073

View User Profile

Send Message

Posted Apr 21, 2012
Anti Ticket spam feature?

lets face it some players are just stupid and make far too many tickets. a limit of some kind like say a set amount per day or a delay between sending them or just some way so that they can only have 1 ticket open at a time..

The public mindcrack servers have large amounts of players and with the ability to press the up key and send it again it really could be bad. with out some anti spam. built in.

Rollback Post to Revision RollBack
_ForgeUser8170698
- Join Date: 12/30/2011
- Posts: 272
- Member Details
#21 _ForgeUser8170698

View User Profile

Send Message

Posted Apr 13, 2012
@halorrr

I'll see what I can do :)

Rollback Post to Revision RollBack
halorrr97
- Join Date: 9/27/2011
- Posts: 77
- Member Details
#20 halorrr97

View User Profile

Send Message

Posted Apr 11, 2012
Could you add the ability to take input from console, having it just see the sender as console?

My server runs buy craft and are looking for a plugin that we can use it's commands to send admins a ticket when someone buys a vault and needs it to be set up for them. Buycraft runs all it's commands from console though.

Rollback Post to Revision RollBack
_ForgeUser7048570
- Join Date: 6/20/2011
- Posts: 28
- Member Details
#19 _ForgeUser7048570

View User Profile

Send Message

Posted Apr 11, 2012
Love the permisisons nodes =D

Rollback Post to Revision RollBack
_ForgeUser8413416
- Join Date: 2/12/2012
- Posts: 318
- Member Details
#18 _ForgeUser8413416

View User Profile

Send Message

Posted Apr 9, 2012
nice plugin :D

Rollback Post to Revision RollBack
ARoyalMango
- Location: Austin, TX
- Join Date: 4/8/2010
- Posts: 74
- Member Details
#17 ARoyalMango

View User Profile

Send Message

Posted Apr 9, 2012
@Odiumxxx

Already fixed, all though it seems irrelevant to what i had asked, you didn't even reply to what you thought about my ideas or suggestions.

Rollback Post to Revision RollBack
_ForgeUser8170698
- Join Date: 12/30/2011
- Posts: 272
- Member Details
#16 _ForgeUser8170698

View User Profile

Send Message

Posted Apr 9, 2012
@MajorCyto

Their*

Rollback Post to Revision RollBack
ARoyalMango
- Location: Austin, TX
- Join Date: 4/8/2010
- Posts: 74
- Member Details
#15 ARoyalMango

View User Profile

Send Message

Posted Apr 9, 2012
@MajorCyto

Also a way to edit internal plugin message please? :P Such as

"Your ticket has been logged, and will be addressed by an admin shortly." Not only admins check my tickets :O

Rollback Post to Revision RollBack
ARoyalMango
- Location: Austin, TX
- Join Date: 4/8/2010
- Posts: 74
- Member Details
#14 ARoyalMango

View User Profile

Send Message

Posted Apr 9, 2012
@MajorCyto

Also there should be a command for a user to close there own ticket if they resolve their own issue before the ticket is helped with.

Last edited by ARoyalMango: Apr 9, 2012

Rollback Post to Revision RollBack
ARoyalMango
- Location: Austin, TX
- Join Date: 4/8/2010
- Posts: 74
- Member Details
#13 ARoyalMango

View User Profile

Send Message

Posted Apr 9, 2012
For your "future to-do" list i think it would be cool to implement a small and short survey system that players can receive to rate there experience. (For those of us with moderators and managers also reviewing tickets.) Once the ticket has been closed a survey notice can come in chat..

"You have been selected for a survey please type /ticket survey to rate your experience!"

And it can ask a configurable set of questions, surveys can be reviewed only by those with permission to which on my server would be admins only so i can review the moderators and managers lol.

Also to help others out could also of course implement a option to completely turn off survey's and also a percentage chance to receive a survey. So at ticket close if the option is "50%" then there will be a 50% chance they would get a ticket survey at ticket close.

I appreciate your consideration!

Rollback Post to Revision RollBack
_ForgeUser8546364
- Join Date: 3/7/2012
- Posts: 87
- Member Details
#12 _ForgeUser8546364

View User Profile

Send Message

Posted Apr 3, 2012
I would like to see it to where the owner and admins see when the ticket is closed by another admin and maybe the message "ticket details"

and agreeing with some kind of reply system. You open ticket perhaps you get a notify that the ticket was closed.

thanks

Rollback Post to Revision RollBack
_ForgeUser8170698
- Join Date: 12/30/2011
- Posts: 272
- Member Details
#11 _ForgeUser8170698

View User Profile

Send Message

Posted Apr 2, 2012
@poler303

Editing messages we can surely do without too much fuss. Replying to tickets might require somewhat of a re-write, but I'll see what I can do. :)

Rollback Post to Revision RollBack
_ForgeUser6840805
- Join Date: 5/19/2011
- Posts: 1
- Member Details
#10 _ForgeUser6840805

View User Profile

Send Message

Posted Apr 1, 2012
I second what TheLar said. I would love to be able to edit messages and reply to tickets. Thank you for this awesome plugin!

Rollback Post to Revision RollBack
_ForgeUser8187733
- Join Date: 1/2/2012
- Posts: 31
- Member Details
#9 _ForgeUser8187733

View User Profile

Send Message

Posted Mar 29, 2012
I think it would be nice, if you can edit the mesaages. Great Plugin!

Rollback Post to Revision RollBack
To post a comment, please login or register a new account.

Project ID

37713
Created

Mar 18, 2012
Last Released File

Jun 22, 2017
Total Downloads

34,181

Bukkit

Simple Help Tickets

Bukkit Plugins