> For the complete documentation index, see [llms.txt](https://bizachi-dev.gitbook.io/bullethell-elemental-template/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bizachi-dev.gitbook.io/bullethell-elemental-template/scriptables/create-new-currency.md).

# Create New Currency

To create a Currency, right-click inside any project folder, go to Create > BulletHellTemplate > Monetization > Currency.

Remember that this item has to be added to the **Game Instance > Currency Data** list in the Login scene.

<figure><img src="https://215355839-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc8AVbPtcUOjcVrQx9Eyu%2Fuploads%2Fgit-blob-bd3bb2812db1c18e647d07f7e85650f27ba261e4%2Fv16-currency.png?alt=media" alt="Currency in the Inspector"><figcaption></figcaption></figure>

### Coin Information

Coin Name: Name of the currency shown in the menus (with **Coin Name Translated** for other languages).

Coin ID: Unique id of the currency. Every other asset refers to the currency by this id (shop prices, quest rewards, coupons, upgrade costs, map costs, the battle pass price), so choose it once and do not change it.

Icon: Currency icon.

Initial Amount: Amount a new account starts with.

### Maximum Amount Settings

Use Max Amount: Limits the currency to a maximum.

Max Amount: The maximum amount.

Can Exceed Max Value: When checked, purchases, rewards and gifts can go above the maximum. When not checked, they stop at the maximum. A recharge always stops at the maximum.

### Rechargeable Settings

Is Rechargeable Currency: The currency refills over time. See [Rechargeable Currencies](/bullethell-elemental-template/user-interface-menus/rechargeables-manager.md).

Rechargeable Time Scale / Rechargeable Time: Time between two recharges (in Seconds, Minutes or Hours).

Recharge Amount: Amount added at each recharge.

Recharge While Offline: Keeps recharging while the game is closed (applied by the WebSocket server; the Offline and Firebase backends always count the time the game was closed).

***

## Display currency in game interface

<figure><img src="https://215355839-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fc8AVbPtcUOjcVrQx9Eyu%2Fuploads%2Fgit-blob-90215b948c6f289b3812ddc8cd835381badf5cc7%2Fv16-currency-display.png?alt=media" alt="Currency Display in the Inspector"><figcaption></figcaption></figure>

To show the amount of a currency on screen, use the **Currency Display** component. The currency bar at the top of the Home screen (`Display_CurrencyGold`, `Display_CurrencyDiamond`, `Display_CurrencyEvent` in the UIMainMenu prefab) is a good example to copy.

Currency ID: Coin ID of the currency to show.

Currency Amount: Text that shows the amount.

Currency Icon: Image that receives the currency icon.

For a rechargeable currency, the component can also show the time to the next recharge and the amount of each recharge.

{% hint style="info" %}
The demo currencies start with 40000 Diamonds and 40000 Gold so you can test everything. Set the real **Initial Amount** of each currency before you release your game.
{% endhint %}