UB1HouseholdBizDataAsset

Overview

• Data asset defining global configuration for the household business system, including customer settings, fee rates, notifications, UI text maps, timeline IDs, tip system settings, and FarSite simulation parameters.

Metadata

Field	Value
Kind	class
Environment	B1 - Presentation
Category	classes
Extends	UB1DataAssetBase

Properties (125)

Name	Type	Description
AccommodationCheckInScriptIds	string[]	Scripts run once for each guest when an accommodation booking is created. The guest is Self.
AccommodationCheckOutHour	integer	Hour of day used when calculating accommodation checkout ticks.
AccommodationCheckOutNoticeHours	integer	How many hours before checkout the pre-checkout notice activity feed is sent. Must be in [1, 23].
AccommodationCheckOutPairScriptIds	string[]	Scripts run once for each unordered guest pair when an accommodation booking finishes.
AccommodationCheckOutSelfScriptIds	string[]	Scripts run once for each guest when an accommodation booking finishes. The guest is Self.
AccommodationCrowdCheckInHour	integer	Hour of day at which the accommodation crowd system checks vacant rooms and places guests.
AccommodationCrowdCityConfigs	FB1AccommodationCrowdCityConfig[]	Per-city min/max target range for occupied accommodation rooms. Cities not listed here are opted out of the accommodation crowd system (no rooms will be filled there).
AccommodationCrowdMaxStayDays	integer	Maximum number of nights a system-placed accommodation crowd guest stays.
AccommodationCrowdMinStayDays	integer	Minimum number of nights a system-placed accommodation crowd guest stays.
AccommodationGuestRecentHouseholdCooldownCount	integer	How many most-recently-placed waiting-family households are held back from the accommodation crowd guest pool, so the same family does not show up as a guest over and over. 0 disables the cooldown. Keep this below the city's waiting-family count, otherwise every candidate ends up on cooldown and the system falls back to reusing the oldest one.
AccommodationMaxStayDays	integer	Maximum number of days allowed for an accommodation booking.
AlreadyGiveTipsBuffId	string	Buff ID used to track that a tip has already been given today (one-day cooldown).
BizBaseExp	integer	Base experience points awarded for a successful business day.
BizEmptySiteIcon	UTexture2D	Icon texture displayed when the business site is empty or unoccupied.
BizEmptySiteName	string	Localized text ID for the empty business site name displayed in the UI.
BizExpGrowthRate	integer	Exponential growth rate applied to business experience requirements per level.
BizJobIcon	UTexture2D	Icon texture representing the business job role in the UI.
BizLevelRewardIconMap	table<integer, string>	Map of business level to its reward icon ID used in the business record UI.
BizMaxLevel	integer	Maximum level a business can reach.
BizStallPurchaseInteractionBagId	string	InteractionBagId used when a saleable object is placed on a business stall/sale surface.
BizTemplateThumbnail	UTexture2D	Thumbnail texture used to represent a generic business template in the UI.
BusinessRelationshipLevelScores	table<integer, integer>	Map of relationship level to customer satisfaction score bonus.
BusinessReviewFactorRanges	table<EB1BusinessReviewFactorType, FB1BizFactorRange>	Min/max satisfaction score bounds per review factor type; keep default values to use open bounds.
BusinessStallObjectTag	string	Object tag that marks a sale surface object for business purchases.
CustomerBaseTimelineId	string	Base timeline ID used for customer characters.
CustomerBaseVisitHour	integer	Base number of hours a customer stays per visit.
CustomerDissatisfiedMinStayHours	integer	Minimum number of hours a customer must stay before a dissatisfaction icon is displayed.
CustomerGaugeZOffset	number	Z offset for the customer purchase desire gauge widget above the character's head.
CustomerSatisfactionBonusRelationshipId	string	Relationship type ID used to apply bonus satisfaction scores for customers.
CustomerSpawnDelayMaxMinutes	integer	Maximum delay (in game minutes) before the first customer arrives after business opens.
CustomerSpawnDelayMinMinutes	integer	Minimum delay (in game minutes) before the first customer arrives after business opens.
DailyBusinessEndByDisasterNotificationId	string	Notification ID sent when the daily business session ends due to a disaster.
DailyBusinessEndNotificationId	string	Notification ID sent when the daily business session ends normally.
DailyBusinessFeeRate	number	Daily fee rate charged proportional to the site price at the start of each business day.
DailyBusinessStartNotificationId	string	Notification ID sent when the daily business session starts.
EmployeeBaseTimelineId	string	Base timeline ID used for employee characters.
EmployeeSuddenLeaveNotificationId	string	Notification ID sent when an employee unexpectedly leaves during the business day.
EndDailyBusinessReasonTextMap	table<EB1HouseholdBizEndDailyBusinessReason, string>	Map of end-of-daily-business reason enum to localized display text ID.
EntranceFeeTypeTextMap	table<EB1HouseholdBizEntranceFeeType, string>	Map of entrance fee type enum to localized display text ID.
EntrepreneurAmbitionCompleteDiscount	number	Additional daily business fee discount rate applied when the Entrepreneur ambition is fully completed (0.0–1.0).
EntrepreneurAmbitionId	string	Ambition ID for the Entrepreneur business ambition.
EvictedCustomerEntryBlockDayCount	integer	Number of in-game date changes before an evicted customer can enter the business again.
FarSiteBaseCustomerCountPerHour	integer	Base number of customers simulated per hour in the FarSite simplified simulation.
FarSiteBaseProductRevenue	integer	Base product purchase revenue per customer in the FarSite simplified simulation.
FarSiteBaseSatisfactionScore	integer	Base satisfaction score used in the FarSite simplified simulation.
FarSiteBaseServiceRevenue	integer	Base service revenue per customer in the FarSite simplified simulation.
FarSiteSatisfactionBonusPerEmployee	integer	Additional satisfaction score added per employee in the FarSite simplified simulation.
FarSiteSatisfactionBonusPerSkillLevel	integer	Additional satisfaction score added per top skill level point in the FarSite simplified simulation.
FranchiseLicenseUnlockLevel	integer	Business level at which the franchise license is unlocked, allowing additional businesses to be opened.
HouseholdQuestIdPrefix	string	Quest ID prefix used to identify household business tutorial quests.
ImmigrationButtonImage	string	Background image for the "Go Immigration" card button on the city-move selection screen. B1Texture2D.Id.
InsufficientDailyBusinessFeeEmployeeNotificationId	string	Notification ID sent to employees when the daily business fee cannot be paid.
InsufficientDailyBusinessFeeManagerNotificationId	string	Notification ID sent to the manager when the daily business fee cannot be paid.
Level4RevenueBonus	number	Revenue bonus rate applied when the business reaches level 4 (0.0–1.0).
ManagerBaseTimelineId	string	Base timeline ID used for the business manager character.
ManagerTooYoungNotificationId	string	Notification ID sent to the manager when the business cannot start due to age restrictions. DA_HouseholdBiz never set this value, so the alert never fired. The default is kept in code instead of relying on data.
MaxBizDescLen	integer	Maximum allowed length for the business description string.
MaxBizNameLen	integer	Maximum allowed length for the business name string.
MaxBusinessCountWithLicense	integer	Maximum number of businesses that can be operated when a franchise license is held.
MaxBusinessCountWithoutLicense	integer	Maximum number of businesses that can be operated without a franchise license.
MaxCustomerActivityCount	integer	Maximum number of recommended customer activities that can be configured.
MaxCustomerFilterCount	integer	Maximum number of customer filter conditions that can be configured.
MaxRecipeNum	integer	Maximum number of recipes that can be configured for a business.
MaxStaffActivityCount	integer	Maximum number of staff activities that can be configured per role.
MaxUniformSlotCount	integer	Maximum number of uniform slots displayed per page in the uniform selection widget.
NegativeSubIcon	string	Inner thought icon ID displayed for negative status in the business management sub-tab.
NoEmployeeNotificationId	string	Notification ID sent when no employees are present at the business site.
PositiveSubIcon	string	Inner thought icon ID displayed for positive status in the business management sub-tab.
PricePolicyMultipliers	table<EB1HouseholdBizPricePolicyType, number>	Service price multipliers keyed by price policy type.
PricePolicyTypeTextMap	table<EB1HouseholdBizPricePolicyType, string>	Map of price policy type enum to localized display text ID.
PurchaseDesireCheckIntervalMinutes	integer	Interval in game minutes between purchase desire threshold checks.
PurchaseDesireKioskPaymentInteractionBagId	string	InteractionBagId used to initiate the KIOSK payment interaction when threshold is reached.
PurchaseDesireMax	number	Maximum absolute purchase desire value a customer can accumulate.
PurchaseDesirePaymentFailureDecrease	number	Purchase desire decrease amount when the payment flow fails after retries.
PurchaseDesirePaymentInteractionBagId	string	InteractionBagId used to initiate the payment interaction when threshold is reached.
PurchaseDesirePaymentRetryDurationMinutes	integer	Maximum game minutes to keep driving (retrying) the purchase payment after the threshold is reached, before applying the failure decrease.
PurchaseDesirePaymentSuccessDecrease	number	Purchase desire decrease amount applied at the C++ transaction-success point of a purchase.
PurchaseDesireProductInteractionTags	string[]	InteractionBag tags that identify product-purchase interactions. Used to cache purchasable object interactions for payment completion.
PurchaseDesireScanBatchSize	integer	Number of objects to scan per TimeTask tick when building the purchasable interaction cache.
PurchaseDesireThreshold	number	Purchase desire threshold that triggers a payment interaction for the customer.
PurchaseDesireUIChangeThreshold	number	Minimum absolute purchase desire delta required before the customer gauge toast is visible.
PurchaseDesireUIShowDurationSeconds	number	Duration in seconds for the customer gauge toast after a visible purchase desire change.
PurchaseKioskRecommendedObjectId	string	KIOSK object recommended in build mode when the KIOSK payment method is selected.
PurchasePaymentMethodTextMap	table<EB1HouseholdBizPurchasePaymentMethod, string>	Map of purchase payment method enum to localized display text ID.
RelationshipEventCooldownMaxDays	integer	Maximum cooldown in days before another relationship-based event can trigger (Min <= Max; both 0 means no cooldown).
RelationshipEventCooldownMinDays	integer	Minimum cooldown in days before another relationship-based event can trigger (0 means no cooldown).
RelationshipEventRules	FB1HouseholdBizRelationshipEventRule[]	List of relationship-based event rules evaluated at the end of each business day.
RequiredNoticeRecipeCategory	string	Recipe crafting category that carries the "required" notice for a restaurant-type business. Must be the first VisibleRecipeCategory entry.
RestaurantCustomerSpawnCutoffLeadMinutes	integer	Lead time in game minutes before closing that stops automatic restaurant customer spawning. Skipped when the day's operating span does not exceed this value.
RestaurantGroupHouseholdWeight	integer	Relative weight for selecting the Household companion pool when spawnable candidates exist. Zero disables the pool.
RestaurantGroupMinRelationshipValue	number	Minimum relationship stat value (romance/business/friendship, whichever is highest) for a related Zoi to be picked as a party companion.
RestaurantGroupOtherWeight	integer	Relative weight for selecting the non-Household, non-romance relationship companion pool. Zero disables the pool.
RestaurantGroupRomanceWeight	integer	Relative weight for selecting the non-Household romance companion pool when spawnable candidates exist. Zero disables the pool.
RestaurantGroupSeedRelationshipValue	number	Friendship value seeded between otherwise-unrelated single Zois so they can form a restaurant party.
RestaurantGroupVisitChance	number	Probability [0,1] that a spawned restaurant customer arrives as the anchor of a relationship-based party.
RestaurantPossessClaimIntervalMinutes	integer	Interval in game minutes at which restaurant reconciler steps may act on possessed characters (claim assignment/revocation, and system-queued guide/order/payment toward a possessed customer).
RestaurantReconcileIntervalMinutes	integer	Interval in game minutes between restaurant reconciler task ticks.
RestaurantServiceCompletedCooldownMinutes	integer	Game minutes a customer must stay away after completing restaurant payment before re-entering counts as a new visit (resets bRestaurantServiceCompleted).
RestaurantServiceStallCheckIntervalMinutes	integer	Interval in game minutes between restaurant service stall checks. Kept coarse because the stall threshold is hours.
RestaurantServiceStallSatisfactionScore	integer	ServiceAvailability satisfaction score applied to each customer of a table whose service stalled past the timeout.
RestaurantServiceStallTimeoutMinutes	integer	Game minutes a restaurant table may stay in the same service state before its party is sent home.
RestaurantServingSlotObjectDestroySatisfactionScore	integer	Satisfaction score applied when restaurant serving destroys a non-customer object occupying the assigned food slot.
RoleDefaultActivityData	FB1HouseholdBizRoleActivityData	Default activity tags automatically assigned per role (Manager/Employee/Customer) without explicit user selection.
SalaryLevelMultipliers	table<EB1HouseholdBizSalaryLevelType, number>	Hourly wage multipliers keyed by salary level type.
SalaryLevelTypeTextMap	table<EB1HouseholdBizSalaryLevelType, string>	Map of salary level type enum to localized display text ID.
SaleableHHBStateGroupId	string	StateGroupId that marks an object as saleable for HouseholdBiz slot scanning.
SatisfactionToExpRatio	number	Amount of experience gained per 1 point of customer satisfaction score.
ServiceCustomerEntryDefaultPrice	integer	Default auto-revenue price on customer entry for a business with zero recipes (service-centric). The business level / PricePolicy multiplier is additionally applied.
SkillSalaryInfoList	FB1HouseholdBizSkillSalaryInfo[]	Salary multiplier entries mapped to employee skill level thresholds.
StoreMannequinAutoPurchaseInteractionBagId	string	InteractionBagId used for automatic store mannequin purchase completion.
TargetCustomerData	FB1TargetCustomerData	Full target customer data used in the business customer-targeting configuration widget.
TipBottleEmptyStateId	string	State ID representing the empty state of the tip bottle.
TipBottleFullNotificationId	string	Notification ID sent when the tip bottle becomes full.
TipBottleFullStateId	string	State ID representing the full state of the tip bottle.
TipBottleHalfFullStateId	string	State ID representing the half-full state of the tip bottle.
TipBottleObjectTag	string	Object tag used to identify the tip bottle object in the scene.
TipBottleStateGroupId	string	State group ID used to change the visual appearance of the tip bottle object.
TipConfig	FB1HouseholdBizTipConfig	Global configuration for the tip system, including base amounts, multipliers, and probabilities.
TipSuccessBuffId	string	Buff ID applied to the employee upon successfully receiving a tip.
TravelButtonImage	string	Background image for the "Go Travel" card button on the city-move selection screen. B1Texture2D.Id.
TravelForcedReturnBuffId	string	Buff granted to the travel party when a city travel ends early. Checkout scripts branch on it.
TravelStampTextureMap	table<string, string>	Stamp image shown on the travel confirm page, keyed by destination city. Key = Map.Id (city), Value = B1Texture2D.Id.
UniformDataList	FB1BizUniformAssetData[]	List of uniform assets available for selection in the business uniform widget.
ValidateFailedReasonTextMap	table<EB1HouseholdBizValidateFailedReason, string>	Map of validation failure reason enum to localized display text ID.
VisibleRecipeCategory	string[]	Recipe categories displayed in the business recipe panel. The array order is the display order and is fixed by spec; RequiredNoticeRecipeCategory must stay at index 0.