Skip to main content

Housing Integration

Housing Integration provides precise location detection for housing areas, enabling accurate syncshell matching for housing plots, wards, and interiors.

What It Does​

Housing Integration:

  • Detects housing ownership and permissions for plots
  • Maps housing interiors (ground floor, basement, second floor)
  • Surveys housing plots to determine exact locations
  • Verifies housing properties for syncshell matching
  • Detects when you're inside housing interiors vs outside

When to Use It​

Housing Integration enhances:

  • Housing syncshells: Create syncshells for specific housing plots
  • Private events: Set up syncshells that only work inside your house
  • Ward gatherings: Share with players in your entire ward
  • Interior roleplay: Different syncshells for different floors of your house
  • Housing districts: Broad syncshells for entire housing areas

How It Works​

Housing Plot Survey​

Sphene surveys housing plots to determine:

  • Plot location: Exact territory, ward, and plot coordinates
  • Ownership status: Whether a plot is owned and by whom
  • Interior access: Which interiors are accessible (basement, upper floors)
  • Outdoor vs Indoor: Whether you're currently inside or outside

Interior Mapping​

For housing interiors, Sphene can detect which floor you're on:

  • Ground floor: Default interior level (map ID offset 0)
  • Basement: Below-ground level (map ID offset +1)
  • Second floor: Above-ground level (map ID offset +2)

This allows you to create syncshells that only work on specific floors of a house.

Ownership Detection​

Sphene can detect:

  • Your owned plots: Which housing plots you own
  • Friend's plots: Housing owned by your paired friends
  • Public access: Plots that are accessible to anyone
  • Private access: Plots with restricted entry

Location Matching​

Combine Housing Integration with Area-Bound Syncshells for precise matching:

  • Housing Ward Only: Match all plots in a specific ward
  • Housing Plot Only: Match a specific plot regardless of owner
  • Housing Plot Outdoor: Match when player is outside the plot
  • Housing Plot Indoor: Match when player is inside the plot (with floor detection)

Use Cases​

Private House Syncshell​

Create a syncshell that only works inside your house:

  1. Set matching mode to "Housing Plot Indoor"
  2. Select your specific plot
  3. Set floor to "Any" or specific floor
  4. Only players inside your house will join

Ward Gathering​

Create a syncshell for your entire ward:

  1. Set matching mode to "Housing Ward Only"
  2. Select your ward
  3. All players in that ward will automatically join

Floor-Specific Roleplay​

Different syncshells for different floors:

  1. Create syncshell for ground floor RP
  2. Create syncshell for basement RP
  3. Create syncshell for second floor RP
  4. Players automatically switch syncshells as they move between floors

Configuration​

Configure housing integration in syncshell settings:

  • Plot survey trigger: When to survey plots (on zone change, manual)
  • Interior detection sensitivity: How aggressively to detect floor changes
  • Ownership refresh frequency: How often to update ownership data

Tips​

  • Use Housing Plot Indoor mode for private house syncshells
  • Combine with City Syncshells for comprehensive location coverage
  • Survey plots after housing updates to ensure accuracy
  • Check the syncshell UI to see which housing syncshells are available in your current location