Currency container. Sub-component of ItemContainer, but also usable standalone. Currencies are identified by StringName (e.g. &"coins", &"gems", &"research_points"). The wallet tracks a balance per currency id. There is no implicit cap; cap logic lives in the game (e.g. weight, level, quest progress) and is enforced externally via can_afford / add / remove round-trips. A wallet may be a sub-component of an Inventory (so a player has one container holding both items and currencies) or a standalone instance (e.g. an NPC's quest reward pool). The class doesn't care. Buy/sell transactions move currencies atomically: add_coins() and remove_coins() return the new balance or a negative number on failure, so callers can roll back on partial failure.
Source: addons/item_vault/inventory/wallet.gd
Syntax
class Wallet extends RefCountedMembers
| Name | Kind | Summary |
|---|---|---|
currency_changed | Signal | Emitted whenever any currency's balance changes. payload: { "currency": StringName, "old": int, "new": int } |
get_balance | Method | |
can_afford | Method | |
balances | Method | |
currencies | Method | |
add | Method | |
remove | Method | |
set_balance | Method | |
clear | Method | |
transfer_from | Method | |
merge_from | Method | |
to_dict | Method | |
from_dict | Method |