Career Player Attributes Module

Dependencies

M.dependencies = {'career_career'}

Central attribute store for career mode. Tracks money, BeamXP, vouchers, and per-branch XP values. Every change is logged with reason/tags for the logbook financial and gameplay history views.

Internal State

Field	Type	Description
`M.logAttributeChange`	varies	Assigned as `logAttributeChange`

Public API

Function	Signature	Description
`M.addAttributes`	`(change, reason)`	Adds/subtracts attribute values with tagged reason; clamps to min/max
`M.setAttributes`	`(newValues, reason)`	Sets absolute values (internally computes delta and calls addAttributes)
`M.getAttribute`	`(attributeName)` → table	Returns full attribute object `{value, gains, losses, min, max}`
`M.getAttributeValue`	`(attributeName)` → number	Returns just the current numeric value (0 if missing)
`M.getAllAttributes`	`()` → table	Returns entire attributes table
`M.getAttributeLog`	`()` → table	Returns the full change history array

Lifecycle Hooks

Hook	Purpose
`M.onExtensionLoaded`	Loads attributes + log from save; handles version migration
`M.onSaveCurrentSaveSlot`	Persists `playerAttributes.json` and `attributeLog.json`
`M.onCareerModulesActivated`	Creates reputation attributes for all organizations
`M.onLogbookGetEntries`	Generates Financial History and Rewards History logbook cards

Dependencies

career_career - active check, tutorial state
career_saveSystem - save slot paths
career_branches - branch definitions, attribute key ordering
career_modules_reputation - min/max reputation bounds
career_modules_log - internal log entries
freeroam_organizations - organization list for reputation attributes

Attribute Structure

attribute = {
  value  = 5000,             -- current value
  gains  = {all = 8000, gameplay = 3000, selling = 5000},
  losses = {all = -3000, buying = -3000},
  min    = nil,              -- optional floor (e.g. reputation)
  max    = nil,              -- optional ceiling
}

Reason Format

reason = {
  label = "Sold 3 Parts.",
  tags  = {"partsSold", "selling"},  -- converted to LUT internally
}

Built-in Attributes

Attribute	Description
`money`	In-game currency (starts at 10000, +3500 if tutorial disabled)
`beamXP`	General experience points
`vouchers`	Bonus stars for fast repairs
`<branchId>XP`	Per-branch progression XP
`<orgId>Reputation`	Per-organization reputation (clamped -50 to 700)

Usage Example

-- Award money + XP
career_modules_playerAttributes.addAttributes(
  {money = 500, beamXP = 50},
  {label = "Completed delivery", tags = {"gameplay", "delivery"}}
)

-- Check balance
local money = career_modules_playerAttributes.getAttributeValue("money")

Hooks Emitted

Hook	Data
`onPlayerAttributesChanged`	`(change, reason)` - notifies all systems of attribute mutations

Dependencies

M.dependencies = {'career_career'}

Central attribute store for career mode. Tracks money, BeamXP, vouchers, and per-branch XP values. Every change is logged with reason/tags for the logbook financial and gameplay history views.

Internal State

Field	Type	Description
`M.logAttributeChange`	varies	Assigned as `logAttributeChange`

Public API

Function	Signature	Description
`M.addAttributes`	`(change, reason)`	Adds/subtracts attribute values with tagged reason; clamps to min/max
`M.setAttributes`	`(newValues, reason)`	Sets absolute values (internally computes delta and calls addAttributes)
`M.getAttribute`	`(attributeName)` → table	Returns full attribute object `{value, gains, losses, min, max}`
`M.getAttributeValue`	`(attributeName)` → number	Returns just the current numeric value (0 if missing)
`M.getAllAttributes`	`()` → table	Returns entire attributes table
`M.getAttributeLog`	`()` → table	Returns the full change history array

Lifecycle Hooks

Hook	Purpose
`M.onExtensionLoaded`	Loads attributes + log from save; handles version migration
`M.onSaveCurrentSaveSlot`	Persists `playerAttributes.json` and `attributeLog.json`
`M.onCareerModulesActivated`	Creates reputation attributes for all organizations
`M.onLogbookGetEntries`	Generates Financial History and Rewards History logbook cards

Dependencies

career_career - active check, tutorial state
career_saveSystem - save slot paths
career_branches - branch definitions, attribute key ordering
career_modules_reputation - min/max reputation bounds
career_modules_log - internal log entries
freeroam_organizations - organization list for reputation attributes

Attribute Structure

attribute = {
  value  = 5000,             -- current value
  gains  = {all = 8000, gameplay = 3000, selling = 5000},
  losses = {all = -3000, buying = -3000},
  min    = nil,              -- optional floor (e.g. reputation)
  max    = nil,              -- optional ceiling
}

Reason Format

reason = {
  label = "Sold 3 Parts.",
  tags  = {"partsSold", "selling"},  -- converted to LUT internally
}

Built-in Attributes

Attribute	Description
`money`	In-game currency (starts at 10000, +3500 if tutorial disabled)
`beamXP`	General experience points
`vouchers`	Bonus stars for fast repairs
`<branchId>XP`	Per-branch progression XP
`<orgId>Reputation`	Per-organization reputation (clamped -50 to 700)

Usage Example

-- Award money + XP
career_modules_playerAttributes.addAttributes(
  {money = 500, beamXP = 50},
  {label = "Completed delivery", tags = {"gameplay", "delivery"}}
)

-- Check balance
local money = career_modules_playerAttributes.getAttributeValue("money")

Hooks Emitted

Hook	Data
`onPlayerAttributesChanged`	`(change, reason)` - notifies all systems of attribute mutations

Career Player Attributes Module

Dependencies

Internal State

Public API

Lifecycle Hooks

Dependencies

Attribute Structure

Reason Format

Built-in Attributes

Usage Example

Hooks Emitted

See Also

On this page

Career Player Attributes Module

Dependencies

Internal State

Public API

Lifecycle Hooks

Dependencies

Attribute Structure

Reason Format

Built-in Attributes

Usage Example

Hooks Emitted

See Also

On this page