FB2CareerComponent

Overview

Career component - manages per-Zoi career activity (job, business, freelance), freelance licenses, and freelance rewards/credit.

Metadata

Field	Value
Kind	`component`
Environment	B2 - Simulation
Category	`components`
Extends	`FB2Component`
Require	`require('Components.B2CareerComponent')`

Properties (15)

Name	Type	Description
`ActiveFreelanceOrderInstanceId`	`FB1FreelanceOrderInstanceId`
`AfterWorkQuestIdList`	`string[]`
`CareerSlots`	`table<EB1CareerType, FB1CareerSlotData>`
`ExamPreparation`	`number`	This week's exam-preparation accumulation (0~~100). Reset to 0 on FB2School::OnWeekReset. Kept on CareerComponent (moved from FB1SchoolEvaluationData, 2026-05). RunExam scales this proportionally to an exam score (0~~ExamMaxScore).
`ExamStudyBonusCountToday`	`integer`	Today's exam-study bonus counter (0~ExamStudyBonusMaxPerDay). Reset to 0 daily on FB2School::OnDayChanged. Spec 4.2: +3 per use, max 3 times/day = +9 total.
`ExpulsionRecords`	`FB1SchoolExpulsionRecord[]`	Expulsion history. Dropout is not added - re-enrollment is possible.
`GraduationRecords`	`FB1SchoolGraduationRecord[]`
`LastJoinCareerTicksMap`	`table<EB1CareerType, integer>`	Last join time per CareerType. Stores join time for employment without a slot (e.g. HouseholdBiz employees). Regular Careers use the slot's JoinedTicks; this map is merged (max).
`LastLeftCareerTicksMap`	`table<EB1CareerType, integer>`	Last resignation time per CareerType. Kept on the character because MemberJobInfo is deleted after resignation; split by CareerType for level-based buff conditions.
`LicensesMap`	`table<string, FB1License>`
`PensionDataList`	`FB1PensionData[]`	Pension data after retirement. Kept after the Career slot is removed and used for daily pension payouts. Currently only Business Career is eligible.
`RoyaltyContractMap`	`table<FB1RoyaltyContractId, FB2RoyaltyContract>`	Royalty
`SchoolWeeklyHistory`	`FB1SchoolWeeklyResult[]`	Mirror of the weekly school-evaluation history (same data as FB2School::WeeklyHistory), kept permanently on the character. Capped at DA->MaxWeeklyHistoryCount (recommended 4); remains after school deletion/city move/dropout/expulsion.
`Statistics`	`FB1FreelanceStatistics`
`bVoluntarilyLeftSchool`	`boolean`	Whether the student dropped out voluntarily.

Functions (72)

Function	Parameters	Returns	Description
`AddAfterWorkQuest`	InQuestId: `string`	`-`	Adds After Work Quest.
`AddExamPreparation`	InAmount: `number`	`-`	Accumulates ExamPreparation, clamped to 0~100. Temporary path (2026-05): called when the Homework_Do interaction ends.
`AddGraduationRecord`	InRecord: `FB1SchoolGraduationRecord`	`-`	Adds a graduation record on graduation (dropout/expulsion are not recorded).
`AddSchoolWeeklyResult`	InResult: `FB1SchoolWeeklyResult`	`-`	Adds School Weekly Result.
`CanAcquireLicense`	InLicenseId: `string`, OutFailReasons: `EB1LicenseAcquireFailReason[]`	`boolean`	Returns whether it can Acquire License.
`CanPublishCraftObject`	InCraftObjectEntityId: `FB1EntityId`	`boolean`	Royalty (Publishing)
`CheatSetLicenseGrade`	InLicenseId: `string`, InGrade: `EB1LicenseGrade`	`-`
`ClearAfterWorkQuests`	`-`	`-`	Clears After Work Quests.
`ComputeHighestEducationData`	`-`	`FB1HighestEducationData`	Computes and returns the highest education data from GraduationRecords (used for packet transmission).
`FindContract`	InContractId: `FB1RoyaltyContractId`	`FB2RoyaltyContract`	Finds and returns Contract.
`GetActiveContracts`	`-`	`FB1RoyaltyContractId[]`	Returns Active Contracts.
`GetActiveOrderInstance`	`-`	`FB2FreelanceOrderInstance`	Returns Active Order Instance.
`GetActiveOrderInstanceId`	`-`	`FB1FreelanceOrderInstanceId`	Returns Active Order Instance Id.
`GetAfterWorkQuestIdList`	`-`	`string[]`	Returns After Work Quest Id List.
`GetCareerEntityId`	InCareerType: `EB1CareerType`	`FB1EntityId`	Returns Career Entity Id.
`GetCareerSlotData`	InSlotType: `EB1CareerType`	`FB1CareerSlotData`	Returns Career Slot Data.
`GetCareerSlots`	`-`	`table<EB1CareerType, FB1CareerSlotData>`	Returns Career Slots.
`GetCityMovePolicyMap`	InCityMoveDataPolicyType: `EB1CityMoveDataPolicyType`	`table<string, EB1CityMoveDataPolicy>`	Returns City Move Policy Map.
`GetCurrentCareerDtId`	InCareerType: `EB1CareerType`	`string`	Returns Current Career Dt Id.
`GetCurrentJobDtId`	InCareerType: `EB1CareerType`	`string`	Returns Current Job Dt Id.
`GetDefaultCityMoveDataPolicy`	`-`	`EB1CityMoveDataPolicy`	Returns Default City Move Data Policy.
`GetExamPreparation`	`-`	`number`	Exam-preparation accumulation (a student's personal capability). Separated from FB1SchoolEvaluationData (2026-05) and kept on CareerComponent. FB2School::RunExam converts this value to an exam score (0~ExamMaxScore).
`GetExamStudyBonusCountToday`	`-`	`integer`	Today's exam-study bonus counter (spec 4.2: +3 per use, max 3 times = +9 total).
`GetExp`	InCareerType: `EB1CareerType`	`number`	Returns Exp.
`GetGraduationRecord`	InEducationType: `EB1EducationType`	`FB1SchoolGraduationRecord`	Returns the graduation record for the given EducationType, or nullptr if none.
`GetGraduationRecords`	`-`	`FB1SchoolGraduationRecord[]`	Returns Graduation Records.
`GetLastJoinCareerTicks`	InCareerType: `EB1CareerType`	`integer`	Returns the Career event time.
`GetLastLeftCareerTicks`	InCareerType: `EB1CareerType`	`integer`	Returns Last Left Career Ticks.
`GetLastPromotionTicks`	InCareerType: `EB1CareerType`	`integer`	Returns Last Promotion Ticks.
`GetLicense`	InLicenseId: `string`	`FB1License`	Returns License.
`GetLicenseGrade`	InLicenseId: `string`	`EB1LicenseGrade`	Returns License Grade.
`GetLicenseReviewExpireTicks`	InLicenseId: `string`	`integer`	Returns License Review Expire Ticks.
`GetLicenses`	`-`	`FB1License[]`	Returns Licenses.
`GetMutableCareerSlotData`	InSlotType: `EB1CareerType`	`FB1CareerSlotData`	Returns Mutable Career Slot Data.
`GetPensionDataList`	`-`	`FB1PensionData[]`	Returns Pension Data List.
`GetRank`	InCareerType: `EB1CareerType`	`integer`	Returns Rank.
`GetSchoolWeeklyHistory`	`-`	`FB1SchoolWeeklyResult[]`	Weekly school-evaluation history (kept permanently on the character, independent of school/city deletion). Synced each exam-day close; capped at DA->MaxWeeklyHistoryCount, oldest entries removed first.
`GetStatistics`	`-`	`FB1FreelanceStatistics`	Returns Statistics.
`HandleApplyCustomPolicyDataRestore`	InTypeDef: `UStruct`, InCityMoveDataPolicyType: `EB1CityMoveDataPolicyType`	`-`
`HandlePreSnapshot`	`-`	`-`
`HandleRetireAge`	`-`	`boolean`	Retirement processing - called from the WBP button when age/work-day conditions are met. Returns success.
`HasActiveContractForCraftEntityId`	InCraftEntityId: `FB1EntityId`	`boolean`	Returns whether it has Active Contract For Craft Entity Id.
`HasActiveOrder`	`-`	`boolean`	Returns whether it has Active Order.
`HasAfterWorkQuests`	`-`	`boolean`	Returns whether it has After Work Quests.
`HasCareer`	InCareerType: `EB1CareerType`	`boolean`	Returns whether it has Career.
`HasLicense`	InLicenseId: `string`	`boolean`	Returns whether it has License.
`HasPensionForCareerType`	InCareerType: `EB1CareerType`	`boolean`	Returns whether it has Pension For Career Type.
`IsCurrentWork`	InCareerType: `EB1CareerType`	`boolean`	Whether it is work hours and the character is inside the Career site.
`IsGraduation`	InEducationType: `EB1EducationType`	`boolean`	Returns whether the given EducationType has been graduated.
`IsLicenseUnderReview`	InLicenseId: `string`	`boolean`	Returns whether License Under Review.
`IsWorkingDayOfWeek`	InCareerType: `EB1CareerType`, InDayOfWeek: `EB1DayOfWeek`	`boolean`	Returns whether Working Day Of Week.
`IsWorkingTime`	InCareerType: `EB1CareerType`	`boolean`	Returns whether Working Time.
`OnChangeGrowthStep`	InPrev: `EB1GrowthStep`, InCurr: `EB1GrowthStep`	`-`	Career-related processing when GrowthStep changes (auto school enrollment, etc.).
`OnDeath`	`-`	`-`	On death, processes resignation from all Careers.
`OnHourChanged`	Before: `FDateTime`, After: `FDateTime`	`-`	Pension payout (called from FB2Character::OnHourChanged at the DA.PensionPayHour time).
`OnInteractionFinished`	InteractionId: `string`, TargetEntityId: `FB1EntityId`, InteractionTags: `string[]`	`-`	Team-project interaction-finished callback (for the RegisterInteractionFinishedListener template).
`OnLicenseReviewCompleted`	InLicenseId: `string`	`-`	Callback invoked on License Review Completed.
`OnOrderFinished`	InResult: `FB1FreelanceOrderResult`	`-`	Callback invoked on Order Finished.
`OnOrderStarted`	InInstanceId: `FB1FreelanceOrderInstanceId`	`-`	Callback invoked on Order Started.
`OnSkillLevelUp`	InSkillId: `string`, InSkillLevel: `integer`	`-`	Detects license-unlock state changes on skill level up and refreshes UI.
`ProcessRoyaltyRepeat`	InContractId: `FB1RoyaltyContractId`	`boolean`
`RecoverCareerSlotsFromMemberInfoIfEmpty`	`-`	`boolean`	If CareerSlots is empty or references an invalid CareerEntityId from a previous city, rebuilds SlotData for the current city by reverse-looking up CareerBase::MemberInfo. Returns true on success.
`RefreshAcquireConditionSatisfiedList`	`-`	`-`
`RegisterRoyalty`	InCraftEntityId: `FB1EntityId`, InWorkName: `string`, InQuality: `EB1Quality`, InCategory: `EB1RoyaltyCategory`	`boolean`	Registers Royalty.
`RemoveAfterWorkQuest`	InQuestId: `string`	`-`	Removes After Work Quest.
`RemoveCareer`	InCareerType: `EB1CareerType`	`boolean`	Removes Career.
`ResetExamPreparation`	`-`	`-`	Resets Exam Preparation.
`ResetExamStudyBonusDaily`	`-`	`-`	Resets Exam Study Bonus Daily.
`SetCareer`	InCareerType: `EB1CareerType`, InCareerSlotData: `FB1CareerSlotData`	`-`	Sets Career.
`TryAcquireLicense`	InLicenseId: `string`, OutFailReasons: `EB1LicenseAcquireFailReason[]`	`boolean`
`TryAddExamStudyBonus`	InAmount: `number`, InMaxPerDay: `integer`	`boolean`	Tries to accumulate one exam-study bonus. If the daily counter check passes, ExamPreparation += InAmount and the counter increments; returns false if over the limit (no change). Called from B2Script_School::Execute_AddExamStudyBonus.
`TryPublishCraftObject`	InCraftObjectEntityId: `FB1EntityId`	`boolean`

Override points (33)

Implement these in Lua as FB2CareerComponent.Override_Name = function(...) end.

Function	Parameters	Returns	Description
`Override_AddAfterWorkQuest`	InQuestId: `string`	`-`	Adds After Work Quest.
`Override_AddExamPreparation`	InAmount: `number`	`-`	Accumulates ExamPreparation, clamped to 0~100. Temporary path (2026-05): called when the Homework_Do interaction ends.
`Override_AddGraduationRecord`	InRecord: `FB1SchoolGraduationRecord`	`-`	Adds a graduation record on graduation (dropout/expulsion are not recorded).
`Override_AddSchoolWeeklyResult`	InResult: `FB1SchoolWeeklyResult`	`-`	Adds School Weekly Result.
`Override_CanPublishCraftObject`	InCraftObjectEntityId: `FB1EntityId`	`boolean`	Royalty (Publishing)
`Override_CheatSetLicenseGrade`	InLicenseId: `string`, InGrade: `EB1LicenseGrade`	`-`
`Override_ClearAfterWorkQuests`	`-`	`-`	Clears After Work Quests.
`Override_ComputeHighestEducationData`	`-`	`FB1HighestEducationData`	Computes and returns the highest education data from GraduationRecords (used for packet transmission).
`Override_FindContract`	InContractId: `FB1RoyaltyContractId`	`FB2RoyaltyContract`	Finds and returns Contract.
`Override_HandleApplyCustomPolicyDataRestore`	InTypeDef: `UStruct`, InCityMoveDataPolicyType: `EB1CityMoveDataPolicyType`	`-`
`Override_HandlePreSnapshot`	`-`	`-`
`Override_HandleRetireAge`	`-`	`boolean`	Retirement processing - called from the WBP button when age/work-day conditions are met. Returns success.
`Override_HasActiveContractForCraftEntityId`	InCraftEntityId: `FB1EntityId`	`boolean`	Returns whether it has Active Contract For Craft Entity Id.
`Override_HasActiveOrder`	`-`	`boolean`	Returns whether it has Active Order.
`Override_HasCareer`	InCareerType: `EB1CareerType`	`boolean`	Returns whether it has Career.
`Override_HasLicense`	InLicenseId: `string`	`boolean`	Returns whether it has License.
`Override_HasPensionForCareerType`	InCareerType: `EB1CareerType`	`boolean`	Returns whether it has Pension For Career Type.
`Override_OnChangeGrowthStep`	InPrev: `EB1GrowthStep`, InCurr: `EB1GrowthStep`	`-`	Career-related processing when GrowthStep changes (auto school enrollment, etc.).
`Override_OnDeath`	`-`	`-`	On death, processes resignation from all Careers.
`Override_OnHourChanged`	Before: `FDateTime`, After: `FDateTime`	`-`	Pension payout (called from FB2Character::OnHourChanged at the DA.PensionPayHour time).
`Override_OnInteractionFinished`	InteractionId: `string`, TargetEntityId: `FB1EntityId`, InteractionTags: `string[]`	`-`	Team-project interaction-finished callback (for the RegisterInteractionFinishedListener template).
`Override_OnLicenseReviewCompleted`	InLicenseId: `string`	`-`	Callback invoked on License Review Completed.
`Override_OnOrderFinished`	InResult: `FB1FreelanceOrderResult`	`-`	Callback invoked on Order Finished.
`Override_OnOrderStarted`	InInstanceId: `FB1FreelanceOrderInstanceId`	`-`	Callback invoked on Order Started.
`Override_OnSkillLevelUp`	InSkillId: `string`, InSkillLevel: `integer`	`-`	Detects license-unlock state changes on skill level up and refreshes UI.
`Override_ProcessRoyaltyRepeat`	InContractId: `FB1RoyaltyContractId`	`boolean`
`Override_RecoverCareerSlotsFromMemberInfoIfEmpty`	`-`	`boolean`	If CareerSlots is empty or references an invalid CareerEntityId from a previous city, rebuilds SlotData for the current city. Returns true on success.
`Override_RefreshAcquireConditionSatisfiedList`	`-`	`-`
`Override_RegisterRoyalty`	InCraftEntityId: `FB1EntityId`, InWorkName: `string`, InQuality: `EB1Quality`, InCategory: `EB1RoyaltyCategory`	`boolean`	Registers Royalty.
`Override_RemoveAfterWorkQuest`	InQuestId: `string`	`-`	Removes After Work Quest.
`Override_RemoveCareer`	InCareerType: `EB1CareerType`	`boolean`	Removes Career.
`Override_TryAddExamStudyBonus`	InAmount: `number`, InMaxPerDay: `integer`	`boolean`	Tries to accumulate one exam-study bonus. If the daily counter check passes, ExamPreparation += InAmount and the counter increments; returns false if over the limit (no change).
`Override_TryPublishCraftObject`	InCraftObjectEntityId: `FB1EntityId`	`boolean`