Coinage
Not compatible with 1.13+. This is an old plugin that would require an almost total rewrite to get it working in more up-to-date servers. Sorry!
A coin-based economy plugin, designed to mimic real currencies for RPG-style servers. Create as many different currencies, with as many different denominations of coins (or notes/tokens/chips etc) as you want. Each coin is unique and can be customised, using any item, with a custom name and print. Hooks into Vault so it can be used with other plugins, and has a comprehensive selection of commands to create, spend, distribute, convert and modify coins which can be used in command blocks and scripting plugins.
Features
- Can use any item type as a coin
- Supports multiple denominations of a currency
- Uses item display names and lore to make coins unique
- API support for other plugins to use (https://github.com/XHawk87/Coinage)
- Provides a variety commands for admin management and command block use
- Can give or take specified values of a currency from inventories
- Can make change for a given value
- Supports multiple currencies
- Can convert between currencies
- Can manage currencies through commands or configuration file
- Can integrate with Vault to set one currency to be used as the Vault currency
Ideas for Future Development
- Fully customisable lore for each individual coin, as many lines as you want, containing as much text and colours as you want
- Allow chests and other inventory blocks to be used in place of players in Coinage commands using their coordinates
- Add Vault support for non-Coinage currencies in the /ConvertCoins command to allow conversion through Vault
- Optional command to be executed when /SpendCoins fails due to the player not having enough currency available
- Bank support (possibly using chests)
- Compatibility with Skript to provide per-currency checks and transactions
- Allow currency to be transferred to offline/non-existent players through Vault
- Allow adding, removing and modifying commands that can optionally be run after various other Coinage commands
- Add optional arguments to the end of /SpendCoins ([currency]) [player] [amount] ([success] [fail]) to trigger customisable commands on success or failure to remove the coins. @player @currency @amount will be replaced with the actual values as it is parsed
- Add optional argument to the end of /CoinValue ([player]) ([currency]) ([trigger]) to trigger a customisable command after calculating the value in coins the player is holding. @player @currency @amount will be replaced with the actual values as it is parsed.
- Improved support for servers using ANSI text-encoding
- Optionally record amount of coins on item lore/title instead of using the stack amount (bypassing the 64 item limit)
- - Optionally set custom stacking limits
- Provide optional feature to automatically mint coins as they are picked up
- Add a command to open a moneybag for a player
- Add tab-autocompletion to all Coinage commands
If you have an idea, please make a suggestion in the comments!
Known Bugs
- Using any of the currency transaction commands while there are no currencies will throw an error instead of a nice message explaining what's wrong
- Due to a weakness in Minecraft client support for custom inventories, items will very occasionally be lost on placing them into moneybags
- There is a time-related bug in Coinage 2.1 and 2.2 which will prevent any changes to Moneybags from being saved, to fix this, you should update to Coinage 0.2.3 or downgrade to the latest release build
Commands
A full list of commands is available on the Command Reference page.
Detailed command help is available in-game by typing /help Coinage
Troubleshooting
This plugin uses Java 7
If you get the followed error on starting up the server with this plugin installed "Unsupported major.minor version 51.0". This means you are using an out of date version of Java. If you don't know how to upgrade, please contact your server hosting provider and ask them for help in upgrading to Java 7, or contact Oracle customer support. Mac OS X users require JDK 7 instead of JRE 7.
Donations
If you'd like to contribute towards the continued development, support and maintenance of this project, please consider joining me on Patreon, and making a one-time or recurring pledge.
Help
If you need help you can leave a comment below and I will get back to you as soon as I can. You can also join my IRC chatroom using the following link. Please note, I am not always at my keyboard! http://webchat.esper.net/?channels=XHawk87&prompt=1
@DrkMatr1984
The config.yml does have comments in. All of my config.yml files have detailed comments in. On a standard CraftBukkit server these are copied directly from the Jar into the plugin folder. If you are using a CraftBukkit clone where this feature is not working, you may wish to raise an issue with the developer. The full comments are available in the Jar if you wish to extract them.
There is also detailed in-game help and commands that can be used to set everything up from in-game.
Hey man, I know you're busy, but do you think you could possibly either A. Comment the config.yml so we know how to set this up properly without an hour or so of trial and error, or B. Put an example config.yml with comments here on this page to help people with setup? Thanks man! You're the best!
@Typical_Name
The data values are already used to represent different block types such as colours of wool, and to switch over to use that would also require a rewrite.
As I said, I already have a plan to do this. I have a number of other projects that also need my attention, and Coinage has already had 2 updates so far this month.
You could conceivably use data values instead of lore. The only issue I can think of cropping up is that blocks revert their data values to their defaults when they're placed, but this shouldn't be a major issue.
@flimmer
Currently the lore is used by the plugin to determine what sort of coin it is when performing transactions. I have an idea of a way to allow coins to have anything written in the lore, but it will require a partial rewrite and thorough testing, so its not going to happen for a while.
Thanks for the headsup. :)
The problem with the Print/lore, is the fact that the name of the denomination is always the first word in the Lore. And I couldn't find a way to add lines to the lore either.
@flimmer
I will be adding a written and possibly a video tutorial when I have some more time.
If you make changes to the config file, it would be a good idea to save/convert it in UTF-8 format to allow it to use the section symbol (§) for colours properly. It is showing as ? because it is in the wrong text encoding. Same deal with the single quotes and most likely the stripped characters too.
I am not sure what you mean about the print not being fully configurable. Please give me an example of what you cannot do with it in its present state.
Hey I have been a bit confused with how the commands work. ^^
Would it be possible for you to show some examples for the commands? that would help out alot. ^^
And thanks for making it hook to Vaults. :)
PS. Found a bug. When ever you make changes changes the '&' to a '?' in the config file. Also the last character in both Name and Print/Lore is stripped away and it removes single Qoutes aswell.
It can also be a bit annoying that the Print is put behind the Denomination's name It would be nice to have it fully configurable
I am glad to hear that and thanks for clearing up on the latest being a dev build. :)
And a giant thumbs up for the quick reply. :)
@flimmer
The most recent update was a dev build that includes some important bug fixes. I will be looking into hooking this up with Vault as soon as I have some more time.
This is amazing to be honest And i would use it if it weren't for one small problem. This plugin isn't using vaults.
I can see you said you would look into it for your next update but you have posted an update since that, so I am unsure if it is possible to use it with Vaults?
But really keep up the good work. And if you haven't done it, do yourself the favor and hook it to vaults, because a lot of people would find more uses for your plugin.
@mohawkguy
I'll look into that for the next release.
Maybe an option to hook this plugin into Vault would be nice, :)
@ArthurMaker
Thank you. I am glad to know my work is appreciated :)
I LOVED this plugin! Dude, that is what I was looking for.
Thanks for creating this!
I do not check the curse pages often. Please only leave comments on the Project Site. Thank you!