Currency

Currency helpers for formatting in-game money values and spawning physical money entities.

---

Overview

The currency library centralizes how Lilia formats money text and keeps the configured singular name, plural name, and symbol in sync with framework config updates. On the server it also provides the helper used to spawn `lia_money` entities in the world.

---

lia.currency.get(amount)View Source

Purpose

Formats a numeric amount into the active in-game currency string.

Realm

Shared

Parameters

number amount The amount of money to format.

Returns

string The formatted currency string using the configured symbol and singular or plural name.

Example Usage

  client:notifyInfo(lia.currency.get(250))
  print(lia.currency.get(1))

---

lia.currency.spawn(pos, amount, angle)View Source

Purpose

Spawns a physical `lia_money` entity at the given position.

Realm

Server

Parameters

Vector pos The world position where the money entity should be created.

number amount The money amount stored on the spawned entity. Negative values are rejected.

Angle angle optional Optional spawn angle for the money entity. Defaults to `angle_zero`.

Returns

Entity|nil The spawned `lia_money` entity, or `nil` when the input is invalid.

Example Usage

  local money = lia.currency.spawn(client:getItemDropPos(), 100)
  if IsValid(money) then
      money.client = client
  end

---