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
can this plugin be used to reward coins for killing players, which can then be used to purchase special kits etc?
@McZocker135
I haven't had any problems with it. Although, it might not work with fractional amounts of currencies as Coinage uses whole numbers only.
If you think you've found a bug, I'll need to see the full stack trace. Use http://pastebin.com or similar for formatting.
Hello, i loe this plugin, but I'm writing a Shopplugin and when I us Iconomy, everything workds fin, but when I use this plugin, it throws a NullPointerException... Could it be, that the vault support doesn't work 100%?
@KentDMC
The alias is an alternative name, a display name, as opposed to its internal reference ID name.
What is alias? Tell me please
@pepper82
Sorry, no. For something on this scale a database would be overkill, as we do not record account data. They are stored as the actual items in the minecraft world files and player data. The only storage we handle are the Moneybags, and they are not thread-safe so would introduce item duplication exploits if used on a bungee network for example. Flat files are perfectly adequate for the needs of a single server.
does it support mysql?
What about 1.7.5 or sup build update ?
I wait for your amazing work
Suggestion : Add compatibility with faction bank ? (like create a check storage in a chest in the faction territory, or something.)
@XHawk87
It doesn't yet, but it's something I can add in a future version. Can you create a ticket or a GitHub issue for it?
@PhilosLogos
I can add a command to open a moneybag for a player in a later release.
@PhilosLogos
Full customisation of currency lore is already a planned feature.
@XHawk87
Is there any way to make currency names in some format other than a bunch of run-on phrases, such that they can have complex names that are actually legible? Is this already possible?
Hey, it's me again! Sorry to bother you AGAIN but I have an idea that I think would be useful. I use CreateYourOwnMenus, and I would like there to be a command to open your moneybag. I would do /menu script add /moneybag @p (or whatever you would want the command to be.) This way, players could view their Money Bag conveniently through their stat menu, or wherever you would put it (In my server options menu). I sure hope this is added because it would be very useful!
@DeltaWhy
That's very nice. Can it handle the different denominations of a single currency? I.e. 1p, 2p, 5p, 10p etc. If it can, I would gladly endorse it as a Coinage-compatible shop plugin.
@cyber_survivor
You should check out FancyShop. It's an item-based shop plugin rather than Vault-based, and supports custom items as currency so it should work together nicely with Coinage. (Disclaimer: I am the author)
@XHawk87
It's ok, I solved the problem. I posted this comment before I found your IRC channel, and I have everything working now! I use a different plugin so I can have a player run economy. I tried to use my old shop plugin, but it did not hook in to vault properly. I decided to have automated shops with skript, and then eventually found a plugin that let me have player run shops. Thanks for your help, everything is working now!
@cyber_survivor
If you have only a single currency, you can hook that into Vault and use the Skript "player's account" expression to check how much money they have before giving them the item.
Sorry for double post, but I need some help.
I use skript, and I want to create shop signs. I have the lines that check for the sign: on rightclick: is sign blahblah
so basically it checks to see if that sign is a shop. If you rightclick the sign, it will take the coins out of your inventory and give you the item. My problem is when the player does not have enough coins to spend. It says "you do not have the money" blah blah, but gives you the item! Any suggestions? Is there a shop plugin I could use that works with this? What would be better is if this was a player ran economy, and the players had to trade around the coins they earn, giving them actual value.
... MUST TRY NOW!