BagOfGold

BagOfGold

BagOfGold turns your server economy into physical items that players can see, carry, drop, collect, trade and store.

Money can remain in a player's inventory, be deposited in a BagOfGold bank or be exposed to other plugins through Vault.

Maintained fork

This project is maintained by Becerritoo and continues the work originally created by Rocologo. The original author remains fully credited.

Features

• Physical item-based currency.
• Signed currency metadata designed to reject forged or modified money.
• Bank accounts and physical money deposits.
• Vault economy-provider support.
• Secure Shopkeepers prices and physical-currency payments.
• Support for loose money, bundles and carried shulker boxes.
• Change returned when a player pays with a larger money bag.
• Optional player debt with a configurable limit.
• SQLite and MySQL storage.
• Integration with MobHunting and other Vault-compatible plugins.
• Update checks through reviewed Hangar releases.

Requirements

Paper 1.21.11 is the currently tested server version. Compatibility with other Minecraft versions is not guaranteed unless explicitly listed on a release.

Installation

1. Install CustomItemsLib-1.4.0.jar.
2. Install BagOfGold-4.8.0.jar.
3. Install Vault if MobHunting, shops or other plugins need to access the BagOfGold economy.
4. Install any optional integrations such as Shopkeepers or Citizens.
5. Start or restart the server.
6. Review plugins/BagOfGold/config.yml before opening the economy to players.

A complete server restart is recommended when installing or updating the plugin stack.

Important migration notice

Current BagOfGold releases use signed metadata to validate physical money.

Physical currency created by older, unsigned releases must not be assumed to be valid currency after updating. Automatic conversion of old physical items is intentionally avoided because old items may have been copied or modified.

Before migrating an existing economy:

1. Back up the server, plugin data and databases.
2. Review player and bank balances.
3. Remove or invalidate legacy physical money.
4. Reissue verified balances under administrator control.

This warning concerns legacy physical items. Stored balances should still be backed up and verified as part of the migration.

Physical currency and banks

Players can carry money as physical bags or deposit it into a BagOfGold bank. Because money exists as an item, it can normally be dropped or lost like other inventory contents unless another plugin protects it.

Bank signs and optional Citizens banker NPCs provide access to stored balances.

Shopkeepers integration

BagOfGold supports physical-currency prices in Shopkeepers without requiring an administrator to create an exact real-money bag for every price.

An operator with the bagofgold.shopkeepers.template permission can:

1. Rename a piece of paper to an exact value such as bagofgold 3000.
2. Place the paper in a Shopkeeper trade editor.
3. Save the trade.

BagOfGold replaces the paper with a signed price template bound to that Shopkeeper. The template is not real currency and cannot be deposited or used to increase a player's balance.

The paper stack size acts as a multiplier. For example:

• One paper named bagofgold 200 creates a price of 200.
• Two papers named bagofgold 200 create a total price of 400.

During a purchase, BagOfGold withdraws the exact amount from the buyer's physical money. Larger bags can be split and valid change is returned.

Player trading Shopkeepers receive a newly signed money bag for the completed payment.

Basic commands

• /bagofgold version — Displays the installed version.
• /bagofgold reload — Reloads the configuration.
• /bagofgold update — Checks Hangar for a compatible reviewed release.
• /bagofgold debug — Enables or disables diagnostic logging.
• /money and /bag — Aliases for the main BagOfGold command.

Additional administrative, balance and token-management commands are available through the main command help.

Support and source code

• Maintained source code
• Bug reports and feature requests
• Original source code
• Original SpigotMC project

If you are the original author and would like to coordinate maintenance or project access, please contact me through GitHub.