Monetizer - Sell your goods

Description:

Monetizer is a lightweight but highly configurable plugin
which allows to /sell various item and receive money for those.
Vault is required for Monetizer to work.

Features:

You can configure every item in the game to be saleable:
- Give every item a list of names which you can use later in /sell [item name]
- Set the value $ for every item
Monetizer is using Vault as Economy plugin so almost all Economy plugins are supported!
Full multi-language support (If you want to update or create a translation, feel free to PM me)
You don't like the default messages or colors? simply change them in the language config!
All of my plugins are signed by myself so you can verify that no one changed it or abused it :)
to verify the file execute: jarsigner -verify Monetizer.jar

Commands & Permissions:

Command:	Permission:	Function:
/sell [item]	monetizer.sell	Displays information about that item
/sell [item] [amount]	monetizer.sell	Sells [amount] of the specified item and deposits the total value to the players economy account
/monetizer version	monetizer.admin	Shows the version of this plugin
/monetizer reload	monetizer.admin	Reloads the config and the language files

Permission:	Description:
monetizer.admin	Permission to Administrate Monetizer
monetizer.sell	Permission to sell items
monetizer.*	Permission to everythig

Configuration:

After the first startup, a config.yml and language files should have been created in plugins/Monetizer. If you want a fresh copy of those files, just delete them and restart your server they will be created and filled with life again :)
Careful: those .yml files are saved as utf-8 so you can use special characters and colors!

config.yml:

#| Monetizer configuration file
#| Check out http://dev.bukkit.org/bukkit-plugins/monetizer for further description and help

# language yml file
# default: "language/lang-en.yml"
language_file: "language/lang-en.yml"

# list of items that can be sold
# leave this empty if you don't want to sell anything
# (but why the hell would you use this plugin in that case?)
# structure of this list:
#
# items:
#   item_id: value  # item_id:  id of the item -- like 264 for diamonds
#                   # value:    amount of money a player receives when selling 1 of this item
#
# ### DON'T FORGET THIS ###
# look inside your lang-xx.yml config for defining names and command aliases
# (so you don't have to use the item id in /sell [item])

items:
  266: 0.2
  264: 2
  388: 1

Language:

Inside plugins/Monetizer/language/ there are files called lang-xx.yml - where xx is the country code. If you want to add a language or change the default ones, just edit them to fit your needs and don't forget to update the config.yml to point to the right language file. I'd really appreciate if you would like to share your created language files with me, so I can add them to Monetizer (for sure you will get mentioned)!

The well documented english language file lang-en.yml:

#| Monetizer language file
#| If you want to use special letters or colors in the messages you have to save the file as UTF-8
#| Also check out http://dev.bukkit.org/bukkit-plugins/monetizer
#| 
#| if a string is empty, no message will be sent -- like this:
#|   some_message: ""
#| 
#| you can set text color with the § prefix -- like this: §6Hello
#| 
#| variables:
#|   general:
#|     %player%  --> the players name -- or "[console]" if executed from console
#|     %world%   --> the world where %player% currently is in -- or "none" if executed from console
#|     %version% --> Monetizer version
#|   monetizer: #those are only available for messages starting with sell_
#|     %amount%  --> amount of item to sell
#|     %item%    --> name of item to sell (like defined in names list)
#|                   singular or plural will be chosen automatically
#|     %value%   --> value of one item
#|     %total%   --> total amount (%amount% * %value%)
#| 
#| the names list should have the same item_ids as defined in the [items] list in config.yml
#| if you miss one ore more items defined in config.yml, their singular and plural will both be
#| the item_id itself -- so just don't miss them!
#| 
#| if you just miss the singular and plural names of an item here
#| they will both be the first entry in command_names
#| 
#| structure of names list:
#| names:
#|   item_id:               # item id if the item
#|     singular: "Diamond"  # singular name of [item_id]
#|     plural: "Diamonds"   # plural name of [item_id]
#|     command_names:       # names which can be used for this item in /sell [item_name]
#|                            if you leave this out, you have to use the item_id which is available everytime
#|       - diamond          # those are case insensitive
#|                            you can alse use more than one word here (e.g. "iron ingot")
#|       - diamonds
#|       - dia
#|       - dias
#| 

names:
  266:
    singular: "Gold Ingot"
    plural: "Gold Ingots"
    command_names:
      - gold
      - goldingot
      - goldingots
      - gold ingot
      - gold ingots
      - gold_ingot
      - gold_ingots
  264:
    singular: "Diamond"
    plural: "Diamonds"
    command_names:
      - diamond
      - diamonds
      - dia
      - dias
  388:
    singular: "Emerald"
    plural: "Emeralds"
    command_names:
      - emerald
      - emeralds

sell_to_few_items: "§7You don't have §3§o%amount%§r§6 §o%item%§r§7!"
sell_invalid_amount: "§3[§7§oamount§r§3]§7 has to be a §3§onumber§r§7 bigger than §30§7!"
sell_error_creative: "§7Selling in §3§ocreative mode§r§7 is forbidden!"
sell_error_item_unknown: "§7Unknown item §3[§7§o%item%§r§3]§7"
sell_item_list: "§7List of sellable items:"
sell_item_info: "§7§31§7 §3%item%§7 is §3%value%§a$"
sell_success: "§7You have sold §3§o%amount%§r§6 §o%item%§r§7 for a total of §3%total%§a$"

error_no_economy_plugin_found: "§3Monetizer§7 wasn't able to hook into an Economy-plugin!"

plugin_config_reloaded: "§3Monetizer§7 config reloaded"
plugin_version: "§3Monetizer§7 version §7%version%"
plugin_invalid_for_console: "§7You cannot execute this command from the §3console"
plugin_invalid_for_player: "§7You cannot execute this command as a §3player"

Want to add some more color to your messages? use the § prefix and the default minecraft formatting code (like §3 for blue, ...)! Despite of reading the documentation up there you have got a question? Feel free to PM me or leave a comment! :)

Add a new saleable item:

Lost track of how to add a new saleable item? Read through this quick tutorial!
Go to the config.yml and add your desired item_id to the items: list and write the value of that item behind the ":", like this:

items:
  ... #other items
  item_id: item_value #item

but thats not all because you need to give your item a name, so go to your active language file
and add your item_id in the names: list there, like here:

#singular name is taken when [amount] is 1
#plural name is taken when [amount] is not 1
#command_names are all names allowed in /sell [item_name]
  
names:
  item_id:
    singular: "Gold Ingot"
    plural: "Gold Ingots"
    command_names:
      - name_one
      - name_two
      - name of item with spaces
      - name_of_item_without_spaces
      - like you want it

Don't forget to replace item_id with your item's id!! (like 264 for diamond)
and also replace item_value with a decimal value denoting how much money the player receives when he sells one of that item. (like 0.5 or 7.5)

Stats:

Quote:
This plugin utilises Hidendra's plugin metrics system, which means that the following information is collected and sent to mcstats.org:

A unique identifier
The server's version of Java
Whether the server is in offline or online mode
The plugin's version
The server's version
The OS version/name and architecture
The core count for the CPU
The number of players online
The Metrics version
Opting out of this service can be done by editing plugins/Plugin Metrics/config.yml and changing opt-out to true.

Known Bugs:

None so far :)

Changelog:

Version 1.1:

Fixed a typo
changed message color slightly

Version 1.0:

Initial verision
Added Main commands /sell and /monetizer
Added Permissions
Added multi-language support
Added Metrics

Questions or Bugs?

Do you have a question? Experienced a bug? Found a language mistake?
Leave me a PM or create a ticket!
I'm really appreciating any help! :)

I hope you will have as much fun with Monetizer as I do!