Economia premium + soft + câmbio#

Cenário: você quer modelar a economia clássica de mobile/free-to-play — 3 moedas com papéis diferentes + uma casa de câmbio que converte premium em soft.

As 3 moedas#

Crie 3 páginas de tipo 🪙 Economia, uma pra cada moeda:

Gold (soft)#

{
  "code": "GOLD",
  "displayName": "Ouro",
  "kind": "soft",
  "decimals": 0
}

DataID: DATA_GOLD

Moeda ganha jogando — quests, vendas, drops. Sem limite de aquisição.

Gem (premium)#

{
  "code": "GEM",
  "displayName": "Gema",
  "kind": "premium",
  "decimals": 0
}

DataID: DATA_GEM

Moeda comprada com dinheiro real. Usada em compras VIP, skip de timers, gachas.

Energy (event)#

{
  "code": "ENERGY",
  "displayName": "Energia",
  "kind": "event",
  "decimals": 0
}

DataID: DATA_ENERGY

Limitada a eventos sazonais. Some quando o evento termina ou precisa de regeneração temporal.

Casa de Câmbio (Gem → Gold)#

Crie uma página de tipo 💱 Casa de Câmbio. O wizard pede as 2 moedas + a taxa:

• From: Gem
• To: Gold
• fromAmount: 100
• toAmount: 5000
• direction: oneWay (não permite voltar Gold → Gem — escassez de Gem)

Resultado: 100 Gem → 5000 Gold.

Adicione mais entries pra pacotes maiores com bônus:

Cada entry é uma CurrencyExchangeEntry independente. UI agrupa todas no mesmo painel.

globalVariables pra balancing global#

Crie 2 páginas de globalVariable pra alavancas que ajustam todos os preços do jogo de uma vez:

Desconto de compra#

{
  "key": "item_buy_discount",
  "displayName": "Desconto de Compra",
  "valueType": "percent",
  "defaultValue": 0,
  "scope": "global"
}

Sobe pra 20 durante Black Friday → todos os itens ficam 20% mais baratos automaticamente. Volta pra 0 no fim do evento.

Bônus de venda#

{
  "key": "item_sell_markup",
  "displayName": "Bônus de Venda",
  "valueType": "percent",
  "defaultValue": 0,
  "scope": "global"
}

Sobe durante eventos pra incentivar venda de loot. Volta pra 0 depois.

economyLink referenciando tudo#

Cada item do jogo tem um economyLink que aponta:

{
  "buyCurrencyRef": "section-gold",   // ou "section-gem" pra itens premium
  "buyValue": 100,
  "buyModifiers": [
    { "refId": "section-buy-discount-var" }
  ],
  "sellCurrencyRef": "section-gold",
  "sellValue": 50,
  "sellModifiers": [
    { "refId": "section-sell-markup-var" }
  ]
}

O motor lê os modifiers no runtime — buyValue × (1 - item_buy_discount/100) durante eventos.

Wizard automático#

A boa notícia: você não precisa criar manualmente as 2 globalVariables nem ligar elas em cada item.

Quando você cria a primeira página de 🎒 Itens (ou ⚔️ Itens com Efeito), o wizard automaticamente:

1. Cria 2 páginas auxiliares: "📉 Desconto de Compra" e "📈 Bônus de Venda" com as globalVariables
2. Conecta os refs no economyLink

A partir da segunda página de item, ele só reutiliza as variáveis já existentes. Você só precisa setar buyValue e sellValue por item.

Estrutura final no GDD#

📦 Conteúdo do Jogo
├── 💎 Economia
│   ├── 🪙 Ouro (DATA_GOLD)
│   ├── 🪙 Gema (DATA_GEM)
│   ├── 🪙 Energia (DATA_ENERGY)
│   ├── 💱 Banco Premium (Gem → Gold)
│   ├── 📉 Desconto de Compra (auto)
│   └── 📈 Bônus de Venda (auto)
└── 🎒 Itens
    ├── ⚔️ Espada de Ferro (100 Gold)
    ├── ⚔️ Espada Mythril (50 Gem)
    └── ...

Veja também#

• currency — schema da moeda
• currencyExchange — schema da casa de câmbio
• economyLink — refs de buyModifiers/sellModifiers
• globalVariable — alavancas globais