EVENTS

Koja Trucker emits server-side events you can listen to from your own resources. They're plain TriggerEvents, so subscribe with AddEventHandler.

AddEventHandler('koja-trucker:delivery:completed', function(data)
    print(('%s earned $%s'):format(data.identifier, data.money))
end)

These fire server-side. The src field is the player's server id; depending on convoy/passenger flow it may differ from the leader — always trust identifier for the player.

koja-trucker:mission:started

Fired when a player successfully starts a delivery.

{
  src,            -- server id
  identifier,     -- player identifier
  mission_id,     -- order id
  category,       -- default|urgent|dangerous|fragile|illegal|business
  required_class, -- 1|2|3
}

koja-trucker:delivery:completed

Fired when a delivery is paid out (also fires for convoy passengers).

{
  src, identifier,
  money,          -- net payout
  xp,
  km,             -- route distance
  elapsed,        -- seconds taken
  category,
  from, to,       -- city names
  company_id,     -- nil if independent
  late,           -- boolean (urgent deadline missed)
}

koja-trucker:company:created

{
  src, identifier,
  company_id,
  name,
  tag,            -- nil if none
}

koja-trucker:skill:purchased

{
  src, identifier,
  skill_id,
  level,          -- new level
}

koja-trucker:promo:redeemed

{
  src, identifier,
  code,
  kind,           -- 'money' | 'xp' | 'sp'
  multiplier,
}

Example: reward streaks in another resource

local streak = {}

AddEventHandler('koja-trucker:delivery:completed', function(d)
    if d.late then streak[d.identifier] = 0; return end
    streak[d.identifier] = (streak[d.identifier] or 0) + 1
    if streak[d.identifier] == 10 then
        -- 10 on-time deliveries in a row → gift a boost
        exports['koja-trucker']:GrantPromoEffect(d.src, 'xp', 2.0, 1800)
    end
end)