[INACTIVE][ADMN] PetitionPlugin v1.34 - Help ticket system [600-818]

This plugin is used for players to log problems, requests and complaints. This plugin relies on Permissions.jar for access control. This will ofcourse be changed once permissions are properly implemented in Bukkit.

The source code is included in the .jar file, feel free to do whatever you want with it. If you use it to save the universe, credits would be nice.

Features:

• Players may open one or more petitions and get assigned a unique ticket # for each. This number can be used to track the petition until it has been closed.
• Each petition may be assigned to a specific op/admin or left as unassigned
• Players as well as ops/admins may add comments to an open petition
• Ops/admins (and currently players) may warp to the location where the petition was opened
• Ops/admins (and currently players) may review the history of each open petition
• Closed petitions are archived and can be reviewed or reopened by moderators
• Use the command "/petition" or the shorthand command "/pe". These can be reconfigured if you want. Option to change these was removed in v1.20, sorry.
• All commands are case-insensitive
• New and updated petitions are announced to everyone with 'petition.moderate' permission
• Want to call them something else than petitions? This can be configured.
• Supports multiple worlds
• Offline players receive notifications on petition updates when logging in
• Server admins can handle petitions on the server console
• Players and moderators are reminded of their open petitions at configurable intervals

Command syntax

Code:

/pe open|create|new <Message>
/pe comment|log <#> <Message>
/pe close <#> [<Message>]
/pe list [<count>]
/pe view <#>
/pe assign <#> [<Operator>]
/pe unassign <#>
/pe warp|goto <#>

Note that the command/alias "/pe" can no longer be changed by the server administrator.

How to install

1. Download http://minecraft.atc.no/plugins/PetitionPlugin.jar
2. Copy it to your "plugins" directory
3. Optionally create a new directory called "plugins/PetitionPlugin"
4. Optionally create a new directory called "plugins/PetitionPlugin/archive"
5. Optionally create a new file "plugins/PetitionPlugin/settings.txt"
6. Load the plugin (Restart the server, or use any plugin you have for this purpose)

Settings
The configuration file is optional, the following settings are available:

Code:

single=Petition
plural=Petitions
notify-all-on-close=false
notify-owner-on-assign=true
notify-owner-on-unassign=true
notify-interval-seconds=300
warp-requires-permission=false

Command examples
A player in distress:

Code:

/pe open Someone has burned down my home!
# the player receives a ticket number, say 45 for this example
/pe comment 45 And killed my chicken!

The brave (but slightly insensitive) administrator arrives:

Code:

/pe list
# the plugin shows me a list of currently open petitions
/pe assign 45 FloydATC
# the petition status is changed to show that I am now handling this incident
/pe warp 45
# I am teleported to the scene
/pe comment 45 Nice crater
/pe close 45 Feather refunded, have a nice day
# +1 served

Again, note that the command/alias "/pe" can be changed by the server administrator.

Changelog:
v1.00 - Original release
v1.01 - Rebuild (fixed onPlayerCommand issue)
v1.02 - Implemented locking and permissions
v1.03 - Added notifications and colors, and fixed a stupid permission bug
v1.04 - Fixed a few problems with notifications, added more colors.
v1.05 - Command/alias can now be configured. More colors.
v1.06 - Fixed crash bug when closing without a comment. Added optional notifications on assign/unassign.
v1.07 - Improved error-checking. Players may now list/close/comment/view/warp to their own petitions.
v1.08 - Automatically create necessary directories and files if they don't exist
v1.10 - A few cosmetic fixes + petition length in header
v1.11 - Added experimental support for multiple worlds
v1.12 - Changed to use world name instead of ID
v1.20 - Rewrote to use onCommand(), fixed /pe warp security issue + much more.
v1.21 - Removed the "stupidly long constructor" as per Bukkit team recommendation
v1.22 - Implemented a notification system for offline players, admins and operators
v1.23 - Fixed duplicate messages. Commands now work from the server console.
v1.24 - Added optional setting to limit use of warp. Petitions are now almost listed in correct order.
v1.25 - Fixed null pointer error on player join.
v1.26 - Petitions are now listed in correct order. Finally.
v1.27 - Optional online/offline filter to /pe list implemented.
v1.28 - Non-moderators could assign/unassign their petitions. Fixed.
v1.30 - Closed petitions may be viewed and reopened. Added list filters "closed", "unassigned", "newest" plus Regular Expression matching.
v1.31 - The list would always get reversed. Fixed.
v1.32 - Notification thread implemented, remind users and mods at regular intervals.
v1.33 - Changed onPlayerJoin() as required by build #600. Fixed deprecated call to void teleportTo().
v1.34 - Added option to notify all players when a petition is closed, not just the moderators.

Dependencies:

• Requires the Permissions plugin (2.6 or equivalent required) Use other versions or compatible plugins at own risk.

Permissions

• 'petition' required to open, comment and view a petition
• 'petition.warp-to-own' required IF 'warp-requires-permission' is enabled
• 'petition.warp-to-own-if-assigned' required IF 'warp-requires-permission' is enabled
• 'petition.moderate' required for everything else

Known problems
Certain situations can lead to double notifications, such as an operator commenting on his own petition. Colorization is work-in-progress.

I'm a Java newbie, please be gentle.
Thank you

 

I'll probably just move this thread onto a shared account with Floyd that way i'll be able to keep things up to date untill he returns.

 

I've posted a new thread here:
http://forums.bukkit.org/threads/admn-petitionplugin-v1-34-help-ticket-system-1000.27737/

I'll make sure to keep it up to date, hopefully Floyd will return soon!

 

Awesome. Thank you for helping out

 

I NEED HELP our server was spammed with over 3000 pe's last night and i need a quik way to clear them all

 

You're still using this...? It hasn't even been updated since Bukkit build 800!