# Banknotes

<figure><img src="../.gitbook/assets/banknotes/enabled.png" alt="" width="563"><figcaption><p>Banknotes</p></figcaption></figure>

> **Info:**
Every option on this page is set per currency and saved to its own file in the currencies folder. Each note is also recorded in the database.

## How Banknotes Work

Experience currencies use [experience bottles](../features/experience-currencies.md#experience-bottles) instead, and item currencies have neither.

`/<currency> withdraw <amount>` takes the amount from the player and gives them a banknote item worth it, signed with their name. Right-clicking the note pays the amount into whoever holds it, so notes can be traded, dropped or stored in chests like any item.

Every note can only be redeemed once. The amount paid comes from the database, not from the item, so a copied or edited note pays nothing and tells the player it was already redeemed. A note that would push the player past the maximum balance is given back, or paid out if the player left before it could be. Redeeming follows the currency's [permission](../plugin-information/permissions.md#currency-permissions) and [restrictions](../features/worlds-and-servers.md).

## Banknotes

Turns withdrawing notes on or off for this currency. Notes already made can still be redeemed.

## Smallest Note

The smallest amount one note can hold.

<figure><img src="../.gitbook/assets/banknotes/smallest-note.png" alt="" width="563"><figcaption><p>Banknotes (Smallest Note)</p></figcaption></figure>

## Largest Note

The largest amount one note can hold. -1 is unlimited.

<figure><img src="../.gitbook/assets/banknotes/largest-note.png" alt="" width="563"><figcaption><p>Banknotes (Largest Note)</p></figcaption></figure>

## Note Item

The item used for notes, such as a paper with a custom model from your resource pack. Notes already made keep the item they were made with.

<figure><img src="../.gitbook/assets/banknotes/note-item.png" alt="" width="563"><figcaption><p>Banknotes (Note Item)</p></figcaption></figure>

## Note Name

The name of the note, with `%amount%`, `%currency%` and `%player%` for who signed it. Without a name of its own, the editor shows the default name from the translation file, marked `(Default)`. Clearing the name, or Right-Click > Reset to Default, goes back to it.

<figure><img src="../.gitbook/assets/banknotes/note-name.png" alt="" width="563"><figcaption><p>Banknotes (Note Name)</p></figcaption></figure>

## Note Lore

The lore of the note, lines split by `|`, with the same placeholders. Without a lore of its own, the editor shows the default lore from the translation file, marked `(Default)`, and the lore editor starts from those lines. Keeping them unchanged or clearing the lore stays on the default, so later changes to the translation still apply.

<figure><img src="../.gitbook/assets/banknotes/note-lore.png" alt="" width="563"><figcaption><p>Banknotes (Note Lore)</p></figcaption></figure>

## Dupe Protection

Every note and [experience bottle](../features/experience-currencies.md#experience-bottles) has its own ID in the database and pays out once, so a copied note can never create money: the first copy redeemed pays, the rest are worth nothing. Dupe Protection also removes those worthless copies before they can be traded, and tells staff. It is set in **Editor > Settings > Dupe Protection** and under `dupe-protection` in config.yml.

* A note that was already redeemed is removed, and so are extra copies of one note (a stack of the same note, or the same note twice in one inventory). One copy is always kept.
* Notes are checked in chests and other containers when they are opened, in hoppers, as dropped items and on pickup, and in the inventory and ender chest of players joining.
* The player is told when a note is removed. Staff with `phoenixcurrencies.alerts` get an alert with who made the note and who redeemed it first, and every catch is written to the console. Redeeming a used note sends an alert too.
* With the [Discord webhook](../features/discord-webhook.md) on, each catch is posted as an embed.
* On a MySQL database shared by several servers, notes redeemed on another server are picked up every few seconds.
* A note that is not in this server's database, such as one brought from a server with its own SQLite file, is left alone.

Each note is reported once a minute at most, so a chest full of copies sends one alert.

Source: https://www.phoenixplugins.com/docs/phoenix-currencies/main-features/banknotes