Define uma moeda do jogo (ouro, gema, XP) com tipo, código e número de casas decimais.

currency#

Define uma moeda do jogo. Cada moeda é uma página própria — você não junta "ouro + gema + tickets" no mesmo addon, e por design uma moeda só vive em uma página.

Por que importa#

Moedas são referenciadas em vários outros addons (preços de itens, custos de skill, taxas de câmbio, recompensas de receita). Sem um addon dedicado, cada referência seria uma string solta tipo "gold" — e quando você renomear a moeda pra "ouro" o jogo todo quebra. Aqui você define uma vez e refs validadas seguem o resto.

Onde costuma viver#

Página de tipo 🪙 Economia. Wizard pra Ouro, Gema, Tickets, etc.
Páginas em branco quando você quer agrupar moedas atípicas.

Singleton — 1 currency por página. Pra múltiplas moedas, crie múltiplas páginas (uma por).

Schema#

Campo	Tipo	Descrição
`id`Sim	`string`	ID interno.
`name`Sim	`string`	Nome do addon (default: o título da página).
`code`Sim	`string`	Código curto em `UPPER_SNAKE` que vai pro JSON exportado (ex.: `GOLD`, `GEM`). Único no projeto.
`displayName`Sim	`string`	Nome amigável que aparece na UI (ex.: Ouro, Gema).
`kind`Sim	`"soft" \| "premium" \| "event" \| "other"`	soft: ganha jogando (ouro). premium: paga (gema). event: evento limitado (tickets de Halloween). other: catch-all.
`decimals`Sim	`number`	Casas decimais (0 pra inteiros). Útil pra moedas que aceitam frações (créditos de assinatura, frações de XP).
`notes`	`string`	Notas livres pro time (regras de balanceamento, history, etc).

Exemplo#

{
  "id": "currency-gold",
  "name": "Ouro",
  "code": "GOLD",
  "displayName": "Ouro",
  "kind": "soft",
  "decimals": 0,
  "notes": "Moeda principal. Ganha em quests, dropa de inimigos, vendas no shop."
}

Quem aponta pra esta moeda#

economyLink — preços de compra/venda em itens.
skills.SkillCost — quando custo da skill é tipo currency.
currencyExchange.CurrencyExchangeEntry — fromCurrencyRef/toCurrencyRef apontam pra moedas.
craftTable.unlock.currency — desbloqueio de receitas/skills via custo em moeda.

Wizard#

A page type 🪙 Economia cria este addon vazio + um pre-fill amigável:

code: "COINS" (você renomeia)
displayName: "Coins"
kind: "soft"
decimals: 0

Depois é só editar pra refletir a moeda real do seu jogo.

Veja também#

currencyExchange

Casa de câmbio entre duas moedas com taxa configurável.

economyLink

Vincula preços de compra/venda a moedas em uma página de item.