API ReferenceGE Extensionscareermodules
Career Reputation Module
Organization reputation level system. Calculates reputation levels (-1 to 3) from numeric values, with per-level perks like loaner cost reduction and delivery bonuses.
Organization reputation level system. Calculates reputation levels (-1 to 3) from numeric values, with per-level perks like loaner cost reduction and delivery bonuses.
Public API
| Function | Signature | Description |
|---|---|---|
M.addReputationToOrg | (organization) | Computes and attaches reputation data to an organization table |
M.getLabel | (level) → string | Returns display name for a level (e.g. "Reliable", "Partner") |
M.getMinimumValue | () → number | Returns -50 (floor for reputation) |
M.getMaximumValue | () → number | Returns 700 (ceiling for reputation) |
M.getValueForEvent | (eventId) → number | Returns predefined reputation change for an event |
Reputation Levels
| Level | Label | Required Value | Loaner Cut | Delivery Bonus |
|---|---|---|---|---|
| -1 | Questionable | -50 (min) | 50% | 0.9× |
| 0 | Neutral | -25 | 35% | 1.0× |
| 1 | Reliable | 40 | 25% | 1.1× |
| 2 | Preferred | 175 | 15% | 1.2× |
| 3 | Partner | 400 | 0% | 1.4× |
Predefined Events
| Event ID | Value |
|---|---|
returnLoanerDamaged | -20 |
discardDeliveryVehicle | -10 |
Level Calculation
calcLevelFromReputationValue(val, organization) returns:
level- integer level (-1 to 3)curLvlProgress- progress within current levelneededForNext- total XP needed for next levelprevThreshold/nextThreshold- boundary values
Organizations can override reputationLevels in their data; missing fields fall back to levelDefaults.
Usage Example
-- Attach reputation to organization for UI display
local org = freeroam_organizations.getOrganization("eastCoastLogistics")
career_modules_reputation.addReputationToOrg(org)
-- org.reputation = {value=120, level=1, curLvlProgress=80, ...}
-- Get label
local label = career_modules_reputation.getLabel(2) -- "Preferred"See Also
- playerAttributes - Stores
<orgId>Reputationvalues - payment - Reputation can be used as a "currency" in fines