Define una moneda del juego (oro, gema, XP) con tipo, código y decimales.

currency#

Define una moneda en tu juego. Cada moneda tiene su propia página — no agrupas "oro + gemas + tickets" en el mismo addon. Por diseño, una moneda vive en una página.

Por qué importa#

Las monedas son referenciadas por muchos otros addons (precios de ítems, costos de habilidades, tasas de cambio, recompensas de recetas). Sin un addon dedicado, cada referencia sería un string suelto como "oro" — y cuando renombras la moneda a "monedas" todo el juego se rompe. Defínela aquí una sola vez y las referencias validadas hacen el resto.

Dónde suele vivir#

Una página de tipo 🪙 Economía. Wizard para Oro, Gemas, Tickets, etc.
Páginas en blanco cuando quieres agrupar monedas atípicas.

Singleton — 1 moneda por página. Para múltiples monedas, crea múltiples páginas (una por moneda).

Esquema#

Campo	Tipo	Descrição
`id`Sí	`string`	ID interno.
`name`Sí	`string`	Nombre del addon (por defecto el título de la página).
`code`Sí	`string`	Código corto en `UPPER_SNAKE` que va al JSON exportado (ej.: `GOLD`, `GEM`). Debe ser único en el proyecto.
`displayName`Sí	`string`	Nombre amigable mostrado en la UI (ej.: Oro, Gema).
`kind`Sí	`"soft" \| "premium" \| "event" \| "other"`	soft: se gana jugando (oro). premium: se compra (gemas). event: evento de tiempo limitado (tickets de Halloween). other: comodín.
`decimals`Sí	`number`	Decimales (0 para enteros). Útil para monedas que aceptan fracciones (créditos de suscripción, fracciones de XP).
`notes`	`string`	Notas libres para el equipo (reglas de balance, historial, etc.).

Ejemplo#

{
  "id": "currency-gold",
  "name": "Oro",
  "code": "GOLD",
  "displayName": "Oro",
  "kind": "soft",
  "decimals": 0,
  "notes": "Moneda principal. Se gana en misiones, drops de enemigos, vendido en tienda."
}

Quién apunta a esta moneda#

economyLink — precios de compra/venta en ítems.
skills.SkillCost — cuando el tipo de costo de habilidad es currency.
currencyExchange.CurrencyExchangeEntry — fromCurrencyRef/toCurrencyRef apuntan a monedas.
craftTable.unlock.currency — desbloquear recetas/habilidades mediante un costo de moneda.

Wizard#

El tipo de página 🪙 Economía crea este addon vacío con un relleno amigable:

code: "COINS" (renombra según necesites)
displayName: "Coins"
kind: "soft"
decimals: 0

Solo edítalo para que refleje la moneda real de tu juego.

Ver también#

currencyExchange

Casa de cambio entre dos monedas con tasa configurable.

economyLink

Vincula precios de compra/venta a monedas en una página de ítem.