Coinage

Table of Contents

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

Comments

emperor321
- Join Date: 10/20/2023
- Posts: 4
- Member Details
#119 emperor321

View User Profile

Send Message

Posted Oct 20, 2023
My heart is bleeding this plugin is dead for years ...

Rollback Post to Revision RollBack
XHawk87
- Join Date: 3/28/2012
- Posts: 688
- Member Details
#120 XHawk87

View User Profile

Send Message

Posted Oct 20, 2023
In reply to emperor321:

It means a lot that my work is appreciated. I wish I could have more easily kept this up-to-date.

Rollback Post to Revision RollBack
bravonolan1994
- Join Date: 1/12/2018
- Posts: 8
- Member Details
#114 bravonolan1994

View User Profile

Send Message

Posted Apr 30, 2018
This seems to be the only item-based economy plugin that works on my 1.7.10 Thermos server. Much appreciated!

Rollback Post to Revision RollBack
XHawk87
- Join Date: 3/28/2012
- Posts: 688
- Member Details
#115 XHawk87

View User Profile

Send Message

Posted May 1, 2018
In reply to bravonolin:

You're very welcome! I try to maintain backwards-compatibility wherever I can for situations just like this.

Rollback Post to Revision RollBack
bravonolan1994
- Join Date: 1/12/2018
- Posts: 8
- Member Details
#116 bravonolan1994

View User Profile

Send Message

Posted May 1, 2018
In reply to XHawk87:

How can I let other plugins spawn Coinage money items? Like let's say I'm using item id 4450 for a dollar bill and I want to have a kits plugin give players one in the config. I can specify the item id 4450 but that would just spawn the regular item and not the enchanted Coinage version that counts as server money. Is there a way to directly spawn the custom Coinage items for use in other plugins?

Thanks

Rollback Post to Revision RollBack
XHawk87
- Join Date: 3/28/2012
- Posts: 688
- Member Details
#117 XHawk87

View User Profile

Send Message

Posted May 3, 2018
In reply to bravonolin:

There are a few different ways you can approach this:

NBT Tags solution

Check if the kit plugin allows you to specify NBT data for an item, as you can with the Minecraft /give command.

Coinage checks several things to see if a coin is real or just a normal item. You must re-create all of these using NBT data for the coin to be accepted as genuine:

The display name of the coin must be explicitly set to the denomination alias that was used when it was created with: /CreateDenomination ([currency]) [denomination] [alias] [value] ([item ID:data value]) [text]

There must be exactly one line of lore on the item containing the currency alias that was used when creating the currency: /CreateCurrency [name] [alias]

Followed immediately by the denomination print that was used when it was created with: /CreateDenomination ([currency]) [denomination] [alias] [value] ([item ID:data value]) [text]

It should end up something like this:

{display:{Name:"MyCoin",Lore:["MyCurrency Coin Print"]}}

For reference, you can find any of these again in the config.yml for Coinage. You can also check coins created in this manner against a real Coinage coin for accuracy.

Command-based solution

The /givecurrency [player] [currency] [value] command will give a player a specific value of a currency, automatically calculating the right number of coins of each denomination. If there is a facility to run a command within that plugin, you can have it run that for the player. Alternatively, you can use command blocks or functions to run the command on the player at the right time, or modify the plugin to run the command.

You can alternatively use /givecoins [player] [currency] [denomination] [amount] to give a specific number of a specific coin to a player.

API-based solution

It is possible for plugins to make calls to Coinage functions directly, however this may require making a fork of a plugin yourself as I don't currently know of any published plugin that does this. You can find the source code for Coinage here: https://github.com/XHawk87/Coinage/

Coinage coinage = (Coinage) getServer().getPluginManager().getPlugin("Coinage"); Currency currency = coinage.getCurrency("MyCurrencyName"); currency.give(player, totalValue);

Vault-based solution

If your kit plugin uses Vault, you can set up your Coinage currency as the primary Vault currency (/setVaultCurrency [name]), and then any money which you tell your kit plugin to give will be given in that currency.
Rollback Post to Revision RollBack
bravonolan1994
- Join Date: 1/12/2018
- Posts: 8
- Member Details
#118 bravonolan1994

View User Profile

Send Message

Posted May 3, 2018
In reply to XHawk87:

Thank you for the in-depth and thorough reply

Rollback Post to Revision RollBack
_ForgeUser9832725
- Join Date: 10/18/2012
- Posts: 25
- Member Details
#105 _ForgeUser9832725

View User Profile

Send Message

Posted Dec 22, 2016
Good sir,

Terribly sad your plugin does not work with the plugin "Jobs Reborn"

Link to the plugin:

https://dev.bukkit.org/projects/jobs-reborn

Another "Jobs" plugin was working with this, so I wonder if you can solve it?

Previous "Jobs" is outdated but was working and I'm using the coinage for rankup and it's working.

I send the same message to the author of Jobs Reborn

The problem on the console with payment:

http://static.pokazywarka.pl/bigImages/7182814/19627005.jpg?1482423651

Thank you in advance for an answer

Last edited by _ForgeUser9832725: Dec 22, 2016

Rollback Post to Revision RollBack
XHawk87
- Join Date: 3/28/2012
- Posts: 688
- Member Details
#106 XHawk87

View User Profile

Send Message

Posted Dec 23, 2016
It appears as if the Vault API has changed, so plugins using the new API won't work with economy plugins implementing with the old API. I will investigate.

In the meantime, you might be able to find an older version of Jobs Reborn that still works.

Last edited by XHawk87: Dec 23, 2016

Rollback Post to Revision RollBack
_ForgeUser9832725
- Join Date: 10/18/2012
- Posts: 25
- Member Details
#107 _ForgeUser9832725

View User Profile

Send Message

Posted Dec 23, 2016
I downloaded the oldest possible version of Jobs Reborn (v.3.4.0) from Jun 9, 2016 but there is the same problem.

Well I will wait then.

Thank you

Rollback Post to Revision RollBack
XHawk87
- Join Date: 3/28/2012
- Posts: 688
- Member Details
#108 XHawk87

View User Profile

Send Message

Posted Dec 23, 2016
I have made a compatibility update, but I will not have time to do thorough testing until the new year. Here is the link if you want to test it yourself: https://dev.bukkit.org/projects/coinage/files/2359540

Rollback Post to Revision RollBack
_ForgeUser9832725
- Join Date: 10/18/2012
- Posts: 25
- Member Details
#109 _ForgeUser9832725

View User Profile

Send Message

Posted Dec 23, 2016
Thank you a lot!
But when I clicked on your link I've got:

Not found
We were unable to find the page or file you were looking for

Last edited by _ForgeUser9832725: Dec 23, 2016

Rollback Post to Revision RollBack
XHawk87
- Join Date: 3/28/2012
- Posts: 688
- Member Details
#110 XHawk87

View User Profile

Send Message

Posted Dec 23, 2016
The curse moderators have approved the file now. Perhaps now you can see it? https://dev.bukkit.org/projects/coinage/files/2359540

Otherwise, it is under Files -> Coinage 0.2.4 (dev), at the top of the plugin page.

Rollback Post to Revision RollBack
_ForgeUser9832725
- Join Date: 10/18/2012
- Posts: 25
- Member Details
#111 _ForgeUser9832725

View User Profile

Send Message

Posted Dec 23, 2016
I had no hope that it will work

IT WORKS! Unbelievable great.

Thank you very much. If I find any bugs I will report, but seems to be clear and smooth :)

Rollback Post to Revision RollBack
XHawk87
- Join Date: 3/28/2012
- Posts: 688
- Member Details
#112 XHawk87

View User Profile

Send Message

Posted Dec 23, 2016
Yes, new code rarely works perfectly on the first build, I am glad to hear that it has so far. Do let me know if you find any problems.

Rollback Post to Revision RollBack
_ForgeUser9832725
- Join Date: 10/18/2012
- Posts: 25
- Member Details
#102 _ForgeUser9832725

View User Profile

Send Message

Posted Dec 17, 2016
Good sir,

Did you left the project?

It's the best economy plugin - trust me.

I'm using only this and essentials eco.

Would be great to add bank-chest idea. Chest could be open by everyone, so it should be protected. Great idea for RPG server with a chance to rob the "republican treasure"... great to my server about ancient Rome :)

After this you can even make it premium plugin, you will have the first customer :)

Rollback Post to Revision RollBack
XHawk87
- Join Date: 3/28/2012
- Posts: 688
- Member Details
#103 XHawk87

View User Profile

Send Message

Posted Dec 18, 2016
Thank you. I am still here, however I am not intending to add major new features to any of my Bukkit plugins until the move to Sponge. I will only make minor alterations to comply with plugin-breaking updates, and only when strictly necessary. Plugins will need to be rewritten when moving to Sponge, so it will take twice as much work for anything new I add to a Bukkit plugin at this stage. It would be more economical to wait and just add them to the Sponge plugins when the time comes.

Rollback Post to Revision RollBack
_ForgeUser9832725
- Join Date: 10/18/2012
- Posts: 25
- Member Details
#104 _ForgeUser9832725

View User Profile

Send Message

Posted Dec 18, 2016
It's great that you are still here!

I understand your point of view of course.

I'm your "follower" here now and will watch when

you add something new in the future.

Have a nice day/afternoon

Rollback Post to Revision RollBack
_ForgeUser9832725
- Join Date: 10/18/2012
- Posts: 25
- Member Details
#101 _ForgeUser9832725

View User Profile

Send Message

Posted Dec 17, 2016
Good sir,

Did you left the project?

It's the best economy plugin - trust me.

I'm using only this and essentials eco.

Would be great to add bank-chest idea. Chest could be open by everyone, so it should be protected. Great idea for RPG server with a chance to rob the "republican treasure"... great to my server about ancient Rome :)

After this you can even make it premium plugin, you will have the first customer :)

Last edited by _ForgeUser9832725: Dec 17, 2016

Rollback Post to Revision RollBack
XHawk87
- Join Date: 3/28/2012
- Posts: 688
- Member Details
#100 XHawk87

View User Profile

Send Message

Posted Apr 16, 2016
@JujuMot

Sorry, that goes beyond the scope of what I was trying to achieve with this plugin.

Rollback Post to Revision RollBack
To post a comment, please login or register a new account.

Project ID

57733
Created

May 21, 2013
Last Released File

Dec 23, 2016
Total Downloads

6,204
License

GNU General Public License ver...

Bukkit

Coinage

Bukkit Plugins

Coinage

Table of Contents

Known Bugs

This plugin uses Java 7

Comments

About This Project

Categories

Members

Recent Files

Bukkit