Modificador global compartido entre páginas: % descuento en ventas, x2 XP en eventos, tasa de drop.
globalVariable#
Define una variable global que otros addons pueden referenciar para ajustes masivos: 10% de descuento de temporada, XP doble los fines de semana, multiplicador de drop rate durante eventos.
Por qué importa#
Los diseñadores de live ops ajustan "palancas globales" todo el tiempo. Sin este addon, tendrías que editar 50 ítems individualmente cada vez que hagas una promo de "20% de descuento en todo". Aquí defines item_buy_discount = 0.20, y todos los economyLinks que referencian esa variable lo aplican automáticamente — luego lo desactivas cambiando solo 1 número.
Dónde suele vivir#
- Páginas en blanco dedicadas a palancas globales (ej.: "Variables de Live Ops").
- El wizard de Ítem crea automáticamente 2 globalVariables auxiliares (
item_buy_discounteitem_sell_markup) la primera vez — las reutilizas para todos los ítems.
Singleton — 1 variable por página. Para múltiples variables, crea múltiples páginas (o un grupo dedicado).
Esquema#
| Campo | Tipo | Padrão | Descrição |
|---|---|---|---|
idSí | string | ID interno. | |
nameSí | string | Nombre amigable (ej.: Descuento en Compra). | |
keySí | string | Clave técnica (snake_case) que va al JSON. Ej.: item_buy_discount, event_xp_multiplier. | |
displayNameSí | string | Nombre amigable duplicado para la UI (generalmente == name). | |
valueTypeSí | "percent" | "multiplier" | "flat" | "boolean" | percent: 0–100 (%). multiplier: ×N (1.0 = sin efecto). flat: número absoluto sumado. boolean: palanca on/off. | |
defaultValueSí | number | boolean | Valor inicial. | |
scopeSí | "global" | "mode" | "event" | "season" | global: siempre activa. mode: solo en modos específicos. event: durante eventos. season: por temporada/parche. | |
notes | string | Notas libres (reglas de evento, historial, etc.). |
Ejemplos#
Descuento global de temporada#
{
"id": "var-buy-discount",
"name": "Descuento en Compra",
"key": "item_buy_discount",
"displayName": "Descuento en Compra",
"valueType": "percent",
"defaultValue": 0,
"scope": "global",
"notes": "Configurar en 20 durante el Black Friday. Vuelve a 0 al final del evento."
}
Multiplicador de XP para un evento#
{
"id": "var-event-xp",
"name": "XP de Evento",
"key": "event_xp_multiplier",
"displayName": "XP × N",
"valueType": "multiplier",
"defaultValue": 1.0,
"scope": "event",
"notes": "Configurar en 2.0 durante el evento de XP doble."
}
Quién referencia globalVariable#
economyLink.buyModifiersyeconomyLink.sellModifiers— refs ({refId: sectionId}) a variables que ajustan precios.- Otros addons pueden referenciarla mediante integración personalizada en el motor.
Comportamiento práctico#
La semántica vive en el lado del motor del juego: el addon solo describe la variable y su valor por defecto. Cómo se aplica (multiplicativo, aditivo, sobreescritura) es responsabilidad de la implementación del juego. El valueType es una pista para el motor.
Recomendación: trata percent como dividir entre 100 (item_buy_discount: 20 → 20% de descuento), multiplier como factor directo (xp_multiplier: 2 → ×2), flat como suma directa, boolean como flag.
Wizard#
No tiene wizard propio. Pero el wizard de Ítem (🎒 Ítems y ⚔️ Ítems con Efecto) crea automáticamente las variables item_buy_discount e item_sell_markup la primera vez — en dos páginas autocreadas llamadas "📉 Descuento en Compra" y "📈 Bono en Venta".
A partir de ahí, todos los futuros economyLinks vienen con referencias a esas dos variables ya configuradas.