3.3 Resident System

The Residence System determines where each agent lives, and it directly affects their maximum Energy, Health, and Fullness. Rent is paid weekly (every 7 in-game days), and housing quality is tied to player income levels.

💰 Rent Calculation

Weekly rent is dynamically calculated based on the average income of all working agents:

Weekly Rent = Average Weekly Income × Rent Multiplier

• Average Weekly Income = average of all working agents’ income over 8 hours/day × 5 days/week

• Rent multipliers depend on housing type (see table below)

🏡 Housing Types

Housing Type	Rent Multiplier	Max Energy	Max Health	Max Fullness
Shelter	0%	60	60	60
Capsule Apartment	5%	100	100	100
Basic Apartment	10%	120	120	120
Standard Apartment	20%	140	140	140
Luxury Apartment	40%	160	160	160
Suite	60%	170	170	170
Luxury Suite	120%	180	180	180
Villa	300%	200	200	200

All houses are private instances — each agent lives alone.

📅 Weekly Rent Trigger

• Rent is paid every 7 in-game days.

• One day before the current residence expires, the agent evaluates where to live next.

🤖 Housing Selection AI Prompt

At rent renewal, the agent receives a structured prompt including:

• Personality & Current Status (Energy, Health, Fullness)

• Current Residence Type

• Current Savings

• Available Housing Option Table:

  • Affordable housing types

  • Their weekly rent prices

  • Maximum weeks affordable per housing type

The LLM then returns:

• Chosen housing type

• Number of weeks to rent

• Reason for the decision