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
Is it possible for you to update this and add a scoreboard with the currencies you want and be able to change the currencies in the shop. Would that be possible? Thanks!
@GrimmVoid
Unfortunately, unless there has been an update I am not aware of, its not possible to hide the enchant info without removing the enchant, as that is a part of the game client which we can't affect.
Can you update your plugin to hide the info (materials and the enchant) see my image for example: http://i.imgur.com/reVUhCc.png
thanks!
@cyber_survivor
If it doesn't work in 1.8, please file a bug report. There is no reason a plugin should necessarily need to be updated for every release of Minecraft, they should just work unless there are specific changes that cause them to become outdated or incompatible.
Any hope of updating to 1.8? D: Favorite plugin is dead now :(
@CraftManto
ChestShop won't store the currency for you until you're back online? That is a problem.
Coinage was designed to be purely a physical item currency, so it doesn't support offline transactions. I was thinking about adding support at one time, but it would be a lot of work, and I am reluctant to put a lot of time and effort into anything Bukkit-related at the moment, given their current sorry state of affairs. Perhaps when Sponge is ready I'll redesign the plugin and make a v2.0 with all kinds of new features.
Perhaps some temporary workarounds would be to use Skript as a bridge between currencies, or as a chest shop that handles physical items, or look for shop plugins that support physical item currencies well. Perhaps the ChestShop authors could be convinced to add support for physical item currencies.
It would be nice if you can use ChestShop with this plugin. At the moment it is not useful because you don't get money when you are not online.
(Allow currency to be transferred to offline/non-existent players through Vault)
Is there any possibility to fix this soon?
@My_Name_Was_Stolen
I do use Spigot for my own server, however Spigot still uses Bukkit and CraftBukkit sources, so is affected by the legal issues surrounding the DMCA takedown. The Spigot team seem to be giving it a good try to keep up with updates, however while the legal issues are still unresolved their future is by no means certain. I would prefer to wait for something independent, like Sponge, that won't have similar legal issues, and then start porting plugins across.
AFAIK it should still work in 1.8, I have no plans to make an update specific for it. However if there is something quick and simple that needs adding/changing to provide better support for it, then perhaps I could look into it.
Have you considered moving over to spigot? Do you have plans to make an update specific to 1.8?
@_Magno20_
I am still maintaining it.
Is this plugin discontinued?
@TheTreePuncher98
Inter-operating multiple currency plugins at once could be a bit tricky.
Although both plugins will have their own commands for taking and giving their own currency from a player, using these without a check to see they have at least that amount of money would allow them to dupe the system into giving them as much of the receiving currency as they want.
Using Vault as a bridge partially fixes that problem, as you could set the currency they are transferring from as the Vault currency, and through a scripting plugin like Skript, you can check if they have enough of the first currency in order to convert it into the second before performing that transaction, however that will only work in one direction.
There are a couple of potential solutions in the works, however I haven't had much time to work on Bukkit lately.
VaultMultiCurrency is a work in progress and hasn't even had basic testing yet, the idea is to allow you to switch what currency out of all of the economy plugins you have, is the current Vault currency, at any time while the server is running, or even setting individual per-player currencies at will, and potentially allowing players control over what currency they are using via permissions. You would need a coder to build, test and debug it. The source can be found here: https://github.com/XHawk87/VaultMultiCurrency
With it, you could set the Vault currency to the currency being transferred from, check they have enough, take it from them, set it to the receiving currency, give the currency to them, and you're done. In theory, using command scripting, you would just need to set the currency of a particular transaction beforehand to use any number of economy plugins at once.
I am also planning to add limited command triggers to Coinage that would allow you to run a preset command you define in your config files after a transaction is failed or completed. This would work nicely with command scripting plugins such as Skript. However this has not been implemented yet.
Hey man, so Im settin up an economy and Im fairly new to plugins, how would I bridge this plugin, if it was possible, to lets say somehow trade one of my denominations of currency for $10 of the EssentialsEcon currency?
@emperor25
For denominations? Yes, just like that for the /CreateDenomination command.
However in the config.yml, they are split up into:
oh and I have another question. Is there any way to put item-id like e.g. "397:4" ?
@emperor25
It is designed to work using whole numbers as it makes calculations faster and simpler. I may add a way to customise the formatting of the vault currency to display them as 0.01 instead of 1. For normal use, the items can display 0.01 in the alias but have 1 as the value.
Thank you everything is working PERFECT now and I wonder why it's not the most popular economy plugin... I'm suprised you answered so quickly :P Can I have last question? Is there any one to put value "0,01" or "0.01"? Because I have to multiply everything by 100 without it ... e.g. when I dig a sand I get 0,5$ now I have to write 50$, to many zeros Thank you once again!
@emperor25
Is there a currency named "x"?
You can check by typing /CoinList or open your config.yml file in a simple text editor and see if there is an "x:" under "currencies:"
You should also ensure that Vault plugin is installed and working to use that command.
So long as that plugin works with Vault, it should be fine.
I wrote "/SetVaultCurrency ID"and I've got "there is no currency with id x" WHY :( - I thought it's the best plugin to my server because I need something like this, with different types of money, because I'm making a server with Roman coins system (you know Aureus, Denarius, Sestertius etc.) - Can this plugin work with jobs plugin too? e.g. If someone break stone he gets coin "x" (value: 1)
@killyouslow
Yes. The most-compatible method is to use Vault. It acts as a bridge between economy plugins (like Coinage) and other plugins that involve transactions, like shops, rewards for killing etc.
After installing Vault and any other plugins you want that provide kit features for sale or rewards for killing etc, you can set one of your Coinage currencies as the Vault currency. To do this, you create your currencies how you wish, and then use the /SetVaultCurrency [currency ID] command, and then restart. When it starts up again, all Vault-compatible plugins should consider that Coinage currency to be the one to use in any transaction.
Alternatively, if you have command scripting plugins, such as Skript, you can use those to run Coinage commands such as /GiveCurrency to give coins to a particular player.