When you first run the plugin, it will create a default configuration for you. This file will explain everything that you need to know about the plugin.
If you read this and have questions, don't hesitate to post a comment on the main plugin page! I will normally respond within a few hours and your question will probably be added to an FAQ here.
Here is the default configuration, which will generate on first run:
#PLEASE READ ALL OF THIS. IT IS EXTREMELY IMPORTANT. IF YOU POST WITH AN ERROR REGARDING THE CONFIGURATION, I WILL NOT RESPOND. #IF SOMETHING IS UNCLEAR, FEEL FREE TO POST, BUT IF IT IS EXPLAINED HERE, YOU WILL RECEIVE NO RESPONSE. # #USE NO TABS. ONLY SPACES. #LEAVE NO BLANK LINES UNLESS AT THE VERY END OF THE FILE OR THEY HAVE A HASH (#) ON THEM SOMEWHERE. # #This is the minimum amount of inventory spaces that the player must have free. If they do not have this amount of spaces, the command will cancel #and they will not lose any tickets, as the command failed and they would've received nothing. minimumInventorySpaces: 1 # #Items: This is the function of the plugin. When a user uses a mysterybox 'ticket,' a ticket is taken from his/her ticket #count and a prize for such is selected COMPLETELY AT RANDOM from this list. If the same item and quantity is entered twice, that will only #increase the odds of getting the aforementioned item. # #Commands can also be invoked upon the sender, as long as they are runnable by console. # #Items should be entered in such a way: # --> MATERIAL_ID;quantity;"Message to send to the player" <-- #Be minded that the message is not required, and the semicolon that separate the quantity and the message can be omitted along with the message. #If you do not specify a message, a default in this form will be sent instead: "You got <quanitity>x <MATERIAL>!". # #While the message is not required, a quantity is. # #The material MUST be a valid material from the Material enumeration found within Bukkit. #In English: follow this link and any material on the page can be used in this plugin. ITEM IDS WILL NOT WORK. #The link: ---> http://jd.bukkit.org/apidocs/org/bukkit/Material.html <--- #I WILL NOT ANSWER ANYTHING LIKE "what is the material for a diamond chestplate?". IF YOU CANNOT USE THE #MATERIAL LIST, USE /GIVE COMMANDS INSTEAD. MORE DETAILS BELOW! # #Commands should be entered in this way: # --> /command %player%;"Message to send to the player" <-- #Again, the semicolon can be omitted and the message along with it, and does not need to be included. #If the message is not included, a default of "Your prize invoked a server command: <command> <sender>" will be sent to the player. # #The %player% parameter will always reference the player who sent the command. Always put this somewhere in the command, whether it benefit #or be misfortunate for the player or nothing will happen to them! # #The commands can be used to do just about anything that the materials can possibly limit. #If you don't want to use materials, use the /give command instead. #If you want it to give out GodSwords or GodBows or something, should you have a plugin that does such a thing, you can use that command here! # #If you have any suggestions for what this can do, feel free to let me know (but I feel that this is pretty much done). items: - DIAMOND;1;You got a diamond! - DIAMOND;64 - GOLD_SWORD;1 - /heal %player%;You were healed by your MysteryBox! - /give %player% 2 3;You were given some grass by your MysteryBox! - /god %player% - /kill %player%;Your MysteryBox killed you! - /give %player% 5>>>3 64;You got some jungle planks.