FutureProg functions
givecurrency
givecurrency overload 1
Boolean givecurrency(Currency currency, Text Number amount, MagicResourceHaver target, Boolean respectGetRules)
Available in
- computer function
- computer program
- standard futureprog
Adds currency to a character, item, or room, creating a currency pile if needed. The amount can be numeric base currency or text parsed by the currency. Errors on null currency, invalid amount text, or null target; returns true when currency was added.
| Parameter | Type | Description |
|---|---|---|
currency |
Currency |
The currency definition to query, load, give, or count. |
amount |
Text Number |
The amount to use. Text amounts are parsed using the target system's normal builder/player parsing rules. |
target |
MagicResourceHaver |
The target character, item, location, or perceivable for the operation. |
respectGetRules |
Boolean |
Whether closed containers and other normal get-access restrictions should be respected. |