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
Hello, this plugin is excellent, I am however having an issue. I'm not getting any errors but Vault does not seem to recognize this as an economy plugin. Can you offer any possible solutions?
@Thuzle
Glad you like the plugin.
The chest support will work with commands, so it would require a command-based script plugin or command blocks to use, so I am not sure that is what you are needing. It is intended to allow coins to be transferred to chests for player-owned shops, but it could be used for player banks too.
For towny support, it seems the only thing missing is support for sending money to offline/non-existent players. That is something I can add in a later release.
I am still active and maintaining all of my plugins. If I ever abandon a project, it will be marked as abandoned.
I absolutely love this mod! I've been using Gringotts, but this gives me so much more delineation in currency. I can't wait for the update that gives chest support like Gringotts has with Towny & Vault.
People used to use signs all the time, but with the meta data you could make a physical item that goes inside a chest to designate it was a Vault. I do hope you're still active because this is a one of a kind economy plugin!
@Razorskills
Unfortunately I doubt it could work like that since Coinage uses the lore of the item to identify the denomination of the coin, unless that mod can be configured to print out the right lore on the coins it creates.
Hello, I have shops set up using npc's from the mod CustomNPC's. It works great, only thing is that you need physical coins instead of just using a debit system.
It works the same as a villager item trading. You can set the item price as anything/any amount of an item. The mod adds its own coin items in the game and we are using them. I was wondering if it was possible to set these coins as a worth with your plugin and when you are in the traders menu, it could buy the item if you have enough money in your account worth the same amount the coins are worth.
But not need to place the coins in the slot. It would be like the plugin would fill the slot with coins virtually if you had the amount required to place that many coins in the slot, then if you clicked on the item, it would pull the money from your balance and you would get the item.
-----Now that im thinking about this. I think it might be more simple to try get the mod author to let us use vault to buy things as well as the trade system.. But Il leave that post up if you think it might be cool, or want to laugh at my probably bad idea haha
Cheers
@redrabbit348
Try stopping your server, editing the config, saving it, then starting your server.
All right sorry if I offended you, I just didn't know if the plugin was functioning correctly because I just can't seem to get it to work. Sorry if you misinterpreted this for insulting you in any way. I'll just move on to another plugin.
@redrabbit348
In future I would appreciate a little more courtesy than making alarmist and disparaging statements like "this plugin is broken", which could easily be misunderstood by others to mean it doesn't work at all, potentially putting off people who could really make good use of this plugin. This is not fair to them or to me. All of my plugins go through thorough testing before release, and I also use this plugin on my own server, much like several hundred other server owners, without issues. I completely customised the currencies and moneybags for my server using the config file, and didn't run into anything like this.
I will need a http://pastebin.com of any error logs on the console, the steps you took to cause it (in detailed steps, nothing left out), as well as a http://pastebin.com of the configuration file before and after. Also, any other details about your system that might be relevant, such as if you are using a non-standard build of CraftBukkit e.g. Spigot, MCPC etc
You will find that you get much better responses from developers if you are polite, provide this information up front, and choose your words with more care.
I do know how to run a server, I just want to know why every time I edit anything on the .config (I am replacing lines here, trying to rename things, no drastic changes) then save it, the config deletes itself. I just wanted to know what I am doing wrong, ive been running a server for over a year now and this is the only plugin in which this has happened.
@redrabbit348
The commands are displayed in standard Bukkit/Minecraft command syntax, this is based on a form of command syntax used in many command line interpreters. [square brackets] mean replace this term, without typing the square brackets. (round brackets) mean this is an optional term, and doesn't need to be entered. Full command help is available in-game by typing any of the commands without parameters.
The config file is in YAML format, just like most other Bukkit plugins, and the Bukkit server itself. Indentation and correct syntax is important, if you make a mistake in the formatting, the config file will not load. I suggest you read the Bukkit tutorials on YAML files, or any other YAML tutorial.
I suggest, before blaming the plugin and harrassing developers, you should attempt to learn to use the actual server. See the Server Admin portal on the Bukkit Wiki to get started: http://wiki.bukkit.org/Portal:ServerAdmin
If you do have a genuine bug report, it is recommended that you give details about what steps are needed to reproduce the bug, and a http://pastebin.com of any relevant configuration files and error logs. Otherwise, there is absolutely nothing a developer can actually do to help you.
Help me please, this plugin is broken and I really need a physical currency plugin. Everytime I edit the .config in ANY way it will delete everything except the first 2 lines. What is happening? Also your "commands" section is very confusing and took me forever to understand.
EDIT: we talked in irc, thanks for the input
Ok, so I just realized you can use the coins to purchase items without having to convert it to money with vault- so I got it all figured out now.
How do I let players trade their coins for vault currency?
I did the command that sets the default currency to Vault, what's next?
NVM :D i got it to work. just took me a lot of trail and errors :P
T_T I'm having a hard time getting started with the plugin... i can create the currency name but have no idea on how to set the denomination.... Help?
@risen32
Thanks for the bug report. This has been fixed in the latest dev build. Please check your messages for a direct download link.
when I type:
./givecoins C0rbinDalls gold1bit 3
I get an error that say's, "An internal error occurred while attempting to perform this command."
Here's the pastebin error that showed up in the error log when running that command as well: http://pastebin.com/A4HdPKPY
@spyermusic
It should work in 1.6.4 without alterations.
1.6.4? :) pls. this is my favourite plugin!!! ;)