(1.8-1.20.1) Prekoyte's Currency | Easily Create Custom Currencies

Prekoyte's Currency Plugin
Prekoyte's Currency is a feature-rich currency plugin for Minecraft servers running Spigot, Bukkit, Paper etc. This plugin allows server administrators to create and manage virtual currencies within their Minecraft worlds. Players can earn, spend, and transfer virtual currencies, and server administrators have complete control over the currency settings.


Features

• Create and manage multiple virtual currencies
• Give or take currency from players
• Check player currency balances
• Transfer currency between players
• PlaceholderAPI support for displaying currency balances in chat and other plugins
• Configurable Starter Balances
• Currency Exchange
  
• Full message customization: modify ALL messages
• A LOT more!

Installation
WARNING! READ THIS!
If you are running 1.13, 1.14, 1.15, 1.16, 1.17 or 1.18, you MUST download a jar with -LEGACY at the end!

1. Download the latest version of Prekoyte's Currency plugin.
2. Place the downloaded JAR file into the plugins folder of your Spigot/Bukkit/Paper server.
3. Restart your server to load the plugin.

Commands

• /currency add <name> <displayName> <symbol> - Add a new currency with the specified name, display name, and symbol.
• /currency remove <name> - Remove an existing currency by its name.
• /currency list - List all available currencies.
• /currency rename <oldName> <newName> <newDisplayName> <newSymbol> - Rename an existing currency and change its display name and symbol.
• /currency give <currencyName> <playerName> <amount> - Give a specified amount of currency to a player.
• /currency take <currencyName> <playerName> <amount> - Take a specified amount of currency from a player.
• /currency balance [currencyName] - Check the balance of a specific currency or all currencies if no currency name is provided.
• /currency pay <playerName> <currencyName> <amount> - Pay a specified amount of currency to another player.
• /currency exchange <fromCurrency> <toCurrency> <amount>

You can set the worth of a currency for the exchange feature in the config.yml


Permissions

• prekoytes_currency.add - Allows players to add new currencies.
• prekoytes_currency.remove - Allows players to remove currencies.
• prekoytes_currency.list - Allows players to list available currencies.
• prekoytes_currency.rename - Allows players to rename currencies.
• prekoytes_currency.give - Allows players to give currency to other players.
• prekoytes_currency.take - Allows players to take currency from other players.
• prekoytes_currency.set - Allows players (admins usually) to set the amount of currency someone has.
  
• prekoytes_currency.reload - Self explanatory
  
• prekoytes_currency.admin - Show the full help message instead of the no op message
• prekoytes_currency.pay - allow users to pay eachother

PlaceholderAPI Support
Prekoyte's Currency plugin supports PlaceholderAPI, allowing server administrators to display player currency balances in various situations, such as in chat or other plugins. To use PlaceholderAPI with this plugin, you can use the following placeholders:

• %currency_balance% - Display the total balance of all currencies for the player.
• %currency_balance_<currencyName>% - Display the balance of a specific currency for the player.

Configuration
The configuration of Prekoyte's Currency plugin is done through the config.yml file located in the plugins/PrekoytesCurrency folder. In this file, you can customize various aspects of the plugin.

- In config.yml:
- Edit your currency names, symbols, displaynames etc
- Edit the starting balances
- Edit currency worth

- In messages.yml:
- Edit ALL messages of the entire plugin

- In player_data.yml:
- edit the amount of currency each player has

- In players_received.yml:
- Edit who has already received the starting bonus. Although I don't understand why you would do that.



API
Prekoyte's Currency provides an API for developers to interact with the plugin programmatically. The CurrencyAPI class contains various static methods that can be used to manage currencies, player balances, and more. Developers can integrate these methods into their own plugins to create more advanced features.

Join my discord for API support!

https://discord.gg/RURukbUJVh





Support
If you encounter any issues or have any questions related to the Prekoyte's Currency plugin, please feel free to contact the plugin author, prekoyte, on the discussion page on SpigotMC.

Thank you for choosing Prekoyte's Currency plugin! We hope this plugin enhances your Minecraft server experience and provides new gameplay possibilities for your players. Enjoy!