Devices, display and widgets in 3.0

New phones

Existing Y24 items and saved phones keep working and show as Y26.

Add them to your inventory

1. Copy the matching entries from inventory-items/ox-items-yseries.txt or inventory-items/qb-items-yseries.txt.
2. Copy the PNGs they reference. Use the supplied image mapping, including shared icons, instead of new filenames.
3. Keep the new entries in Config.UseableItems and the supplied layout config when you merge your old config.
4. Restart your inventory or server so it loads the items. Shop prices are not added for you.

Install the matching updated props package. YDuo, YPhone Dual and YTriFold now have native hinge animations and fitted cases. Older notes about static-only YTriFold props, or YDuo using a temporary YFold UI, no longer apply.

Using foldables

• Fold with the configured keybind or the phone controls.
• YPhone Dual has a side action rail.
• Supported apps show a list and detail side by side when unfolded, with an adaptive status rail for status and activity controls.

Unique phones

Unique phones need both Config.Item.Require and Config.Item.UniquePhones. Keep the supplied non-stacking/unique item flags and inventory hooks. The item decides which device the player gets; unique-phone layout rules still apply.

What is saved where

Display

In Settings > Display:

• Move phone: drag, save, cancel or reset the phone position. The position adapts when the screen resolution changes. /resetphoneposition restores the default.
• Opening direction: automatic, or top, bottom, left or right.
• Immersive 3D (supported phones, off by default): cursor tracking or a locked angle, plus motion and glare settings.
• Compact pop-ups: show notifications and calls near the saved position while the phone is closed. See Notification preferences.

Home widgets

Hold a widget to open its settings. Available widgets: Calculator, Banking, YPay, Markets, Garage, Homes, Notes, Radio and Recent Calls.

Each widget has its own options, such as:

• pin an account, property, vehicle or note
• pick market assets or saved radio frequencies
• filter recent calls

All widgets also have background, color (light, dark or match the phone), transparency and blur settings.

How widgets behave:

• Folded and unfolded Home keep separate layouts.
• Widgets update from their app's data and are removed if that app is uninstalled.
• A broken widget or missing integration does not stop the rest of Home from loading.
• Garage locate and valet, Homes and Radio controls depend on your server's providers and permissions.

Housing integrations

Config.Housing = "auto" in config/config.housing.lua detects supported housing resources, including the new tk_housing adapter.

• The housing resource can start after the phone.
• If no supported provider is running, Homes data and actions are unavailable.
• To pick a provider yourself, use its exact resource name. Framework requirements still apply.

For a custom adapter:

1. Put it in client/apps/framework/home and server/apps/framework/home (editable).
2. Start from the supplied your_housing.lua templates, and match the resource name to Config.Housing.
3. Keep the YseriesOnHousingReady and YseriesRegisterHomeCallback calls, so late starts and restarts refresh handlers without duplicating them.