Modificador global compartilhado entre páginas: % de venda, x2 XP em evento, taxa de drop.
globalVariable#
Define uma variável global que outros addons podem referenciar pra ajustes em massa: desconto sazonal de 10%, dobro de XP no fim de semana, multiplicador de drop em eventos.
Por que importa#
Designers de live ops mexem em "alavancas globais" o tempo todo. Sem este addon, você teria que editar 50 itens individualmente quando rodar uma promo de "tudo 20% off". Aqui você define item_buy_discount = 0.20, todos os economyLinks que referenciam essa variável aplicam automaticamente, e você desliga depois mudando 1 número.
Onde costuma viver#
- Páginas em branco dedicadas a alavancas globais (ex.: "Variáveis Live Ops").
- O wizard de Itens cria automaticamente 2 globalVariables auxiliares (
item_buy_discounteitem_sell_markup) na primeira vez — você reaproveita elas pra todos os itens.
Singleton — 1 variável por página. Pra múltiplas, crie múltiplas páginas (ou um agrupamento dedicado).
Schema#
| Campo | Tipo | Padrão | Descrição |
|---|---|---|---|
idSim | string | ID interno. | |
nameSim | string | Nome amigável (ex.: Desconto de Compra). | |
keySim | string | Chave técnica (snake_case) que vai pro JSON. Ex.: item_buy_discount, event_xp_multiplier. | |
displayNameSim | string | Nome amigável duplicado pra UI (geralmente == name). | |
valueTypeSim | "percent" | "multiplier" | "flat" | "boolean" | percent: 0–100 (%). multiplier: ×N (1.0 = sem efeito). flat: número absoluto somado. boolean: liga/desliga. | |
defaultValueSim | number | boolean | Valor inicial. | |
scopeSim | "global" | "mode" | "event" | "season" | Domínio onde se aplica. global: sempre. mode: apenas em modos específicos. event: durante eventos. season: por temporada/patch. | |
notes | string | Notas livres (regras de evento, history, etc.). |
Exemplos#
Desconto sazonal global#
{
"id": "var-buy-discount",
"name": "Desconto de Compra",
"key": "item_buy_discount",
"displayName": "Desconto de Compra",
"valueType": "percent",
"defaultValue": 0,
"scope": "global",
"notes": "Setado pra 20 durante a Black Friday. Volta pra 0 no fim do evento."
}
Multiplicador de XP em evento#
{
"id": "var-event-xp",
"name": "XP do Evento",
"key": "event_xp_multiplier",
"displayName": "XP × N",
"valueType": "multiplier",
"defaultValue": 1.0,
"scope": "event",
"notes": "Vira 2.0 durante o evento de XP em dobro."
}
Quem aponta pra globalVariable#
economyLink.buyModifierseeconomyLink.sellModifiers— refs ({refId: sectionId}) pra variáveis que ajustam preços.- Outros addons podem referenciar via custom integration no motor.
Comportamento prático#
A semântica fica do lado do motor de jogo: o addon só descreve a variável e seu valor padrão. Como ela se aplica (multiplicativo, aditivo, sobrescrita) é responsabilidade da implementação no jogo. O valueType é dica pra o motor.
Recomendação: trate percent como divisão por 100 (item_buy_discount: 20 → 20% off), multiplier como fator direto (xp_multiplier: 2 → ×2), flat como soma direta, boolean como flag.
Wizard#
Não tem wizard próprio. Mas o wizard de Itens (🎒 Itens e ⚔️ Itens com efeito) cria automaticamente as variáveis item_buy_discount e item_sell_markup na primeira vez — em duas páginas auto-criadas chamadas "📉 Desconto de Compra" e "📈 Bônus de Venda".
A partir daí, todos os economyLinks futuros já vêm com refs pra essas duas variáveis.