Agency-Phone

✨ New

• TopV Social: Adds feed, stories, reels, direct messages, profiles and live streams, synced with topv.gg and the TopV Android and iOS apps.
• TopV Social: Appears on home screen page 2 next to Weather, follows phone language and light or dark mode, and can post gallery and camera photos.
• TopV Social: Notifications appear as banners and a red icon badge.
• App SDK 2: Developers can register web apps with RegisterApp and a UI address, with theme, language, gallery, camera, dialogs, notifications and badges.
• App SDK 2: Apps can use the usual phone bridge from other phone scripts, and include a full-size icon and store page with screenshots.
• Phone state: Scripts can read LocalPlayer.state.phoneOpen and use events for phone open and close state.

🔧 Improved

• Cloudflare TURN: CloudflareTurnApiUrl is now filled in by default; only Token ID and API Token are needed.

🐛 Fixed

• Recents: Finished calls appear immediately, deleted calls stay deleted, and rows slide out smoothly.
• FaceZoom: Video calls remain video calls after reconnecting, and deleting a tile removes every call behind it.
• Maps: Your waypoint leads the pin list with its street name, and deleted pins and hidden units stay gone.
• Maps: The list shows real map blips instead of dozens of built-in ATMs.
• Jobs: The last card is no longer covered by the home bar.
• Pictogram: Video stories and video tiles now have the correct size.

⚙️ Config

• AgencyConfig.ExternalAppSlots controls where added apps appear on the home screen.

📦 Update notes

• Replace the resource; your existing config.lua keeps working. Players will not see a new update screen.
• To enable TopV Social, copy the included phone-topv folder into your resources, ensure ox_lib runs, and add ensure phone-topv after ensure agency-phone.
• Players need Discord linked to FiveM to use TopV Social.
• For Cloudflare TURN with an older config.lua, set CloudflareTurnApiUrl as shown in CHANGELOG.md. In versions 27.0.0 and 27.0.1, it was empty and TURN stayed off.

🐛 Fixed

• Set the internal Companion relay address back to empty so the phone connects to api.agencyg.de.
• Restored MusicAllowExternalLinks to false and MusicReviewCallbackUrl to empty.

⚙️ Config

• If keeping your own config.lua, set RelayInternalUrl = '' in the Companion block.
• Set MusicAllowExternalLinks = false and MusicReviewCallbackUrl = '' unless you changed them yourself.

📦 Update notes

• Replace the resource, run refresh, then restart agency-phone, or restart the server.
• Players will not see a new update screen. After restarting, the console should show Companion relay connected.

✨ New

• Device: Adds a rendered in game phone model with a thin metal edge, chamfer, side buttons and eight aluminium finishes.
• Angy: Understands requests and responds in the phone’s language, recognizes all 52 apps in ten languages and can open apps. No API key or external connection is required.
• FaceZoom: Adds a video call grid for favourites, recents and contacts, with a draggable filter pill and one tap calling.
• FaceZoom: Shows a contact’s picture on the call screen instead of a coloured letter.
• Wallet: Adds WalletCards, transfers, fixed deposits, trading and a full activity list.
• Wallet: Adds Agency Pay at checkout, with money moved server side.
• Store: Adds a page for every app showing what it does, who made it and what it needs. Users can install or remove apps.
• Store: Keeps Store, Settings, Phone, Buzz, Contacts, Snapr, Gallery, Clock, Wallet and Angy protected from deletion and reinstalls them if removed by config.
• Games: Adds Dice, Coin Flip, Slots, Roulette, Snake and Brick Blast, with money handled server side.
• Home screen: Adds draggable, resizable widgets and a factory layout reset.
• App names: Adds person friendly names for all 52 apps in ten languages. Custom config names display exactly as written and are never translated.

🔧 Improved

• Angy: Uses the phone’s language when answering and recognizes short app names, including Handy, SMS, Navi and Wecker.

🐛 Fixed

• Home screen: Resetting the phone now resets the widget layout.
• Widgets: The delete badge now stays inside its circle.
• Widgets: The confirmation dialog is no longer transparent.
• Power off: The screen is no longer see through in game, keeping text readable.
• Light mode: Removes the bright ring and four white corners around the display.
• Games: Hardware buttons no longer dim until they disappear.
• Setup wizard: The Companion step no longer starts at the top or slides under the Agency Island.

⚙️ Config

• Config: Adds the ProtectedApps block to config.lua.

📦 Update notes

• Do not copy your old config.lua over the new file. Back up your values, install the new config and set them again.
• Player settings and Companion pairings survive the update.
• The update screen appears once on first open, then never again.
• Restart the resource after updating.
• The update is free for everyone who already owns Agency Phone.

✨ New

• Own app for Agency-Watch on Phone and Pad, plus further changes for the Watch release

✨ New

• Phone: Added call history, with normal and test calls shown in Recents.
• Games: Added stake selection so net profit matches the reward logic.
• Setup Wizard: Added translations for the updated flow in every supported phone language.
• Localization: Added keys for new Mail, Buzz, FaceZoom, Browser, Wallet, Contacts and Theme flows.

🔧 Improved

• UI: New flows use translation keys instead of hardcoded visible strings wherever possible.

🐛 Fixed

• Phone: Fixed the call animation getting stuck after calls end.
• Buzz: Fixed sent messages appearing on the same side for sender and receiver, emoji menu crashes, and emoji panel sizing.
• Buzz: Fixed white mode text contrast in list and chat views.
• Buzz: Fixed sent locations opening Maps and shared contacts opening or saving in Contacts.
• Buzz: Fixed photo messages appearing only for the sender.
• Mail: Fixed deleted emails reappearing because they were not removed from the database.
• Mail: Fixed player-to-player mail sending.
• Mail: Fixed the primary mailbox star requesting Face Unlock when disabled.
• Mail: Fixed reply and create actions disappearing in white mode.
• Wallet: Fixed Agency Pay staying disabled until restart after creating a card.
• Wallet: Fixed selected states appearing white on white in white mode.
• Photos: Fixed deleted photos returning until restart and the fullscreen viewer getting stuck after pressing Home.
• Settings: Fixed language changes not updating the settings experience and app-specific settings not applying on-device.
• Settings: Fixed notification and privacy toggles not being enforced correctly.
• Settings: Fixed hide-number mode revealing numbers for saved contacts.
• VidFlow: Fixed playback continuing incorrectly when the phone closes; playback now pauses.
• Music: Fixed nearby shared playback requiring Music to be opened first.
• Music: Fixed shared pause and seek synchronization, and volume changes not reaching nearby listeners.
• Maps: Fixed generic Pin or Blip labels by preferring real nearby blip names.
• Games: Fixed incorrect displayed or credited winnings in Coinflip, LuckySlot and Roulette.
• Race: Fixed race acceptance so both players receive the correct update.
• Invoices: Fixed endless loading and improved compatibility detection for supported billing systems.
• Browser: Fixed website loading, back navigation to browser home or phone flow, direct Google searches and handling of blocked pages.
• Wallet and App Store: Fixed deleted apps not always being reinstallable from the store.
• Contacts: Fixed modal and action menu layouts in contact submenus.
• Setup Reset: Fixed the full phone wipe returning to setup with default apps and layout instead of a broken leftover state.

✨ New

• Pictogram Live: Added live comments, analytics summary, viewer history and comment history after streams end.
• Pictogram Live: Added an in-phone-only live rendering path.
• Privacy: Added call blocking that makes callers see the target as unreachable.

🔧 Improved

• Story Viewer: Added progress bars, entry and exit motion, and clearer story timing.
• Dialer: Improved recent-call cards, floating navigation placement and keypad readability.
• White Mode: Corrected white-on-white text and buttons in Browser, Buzz, Mail, Wallet, Contacts and newer screens.
• Safe Areas: Adjusted screens so top controls, live bars and bottom actions fit around the notch and home indicator.
• Pictogram Live: Switched live transport to latent events instead of normal reliable events.
• Music Sync: Improved shared play, pause, seek and volume synchronization for nearby listeners.
• Privacy: Moved number hiding and call acceptance to server-enforced behavior.
• Mail: Preserved mailbox state across app or script restarts and prevented incorrect reopening of the creation flow.
• Photos and Pictogram: Stored uploaded media URLs for reuse in gallery and social posting flows.
• Branding: Removed or replaced legacy real-brand wording and standardized on Agency naming.
• Data Plans: Reused plan speed as the single network-profile value for downloads and selected online actions.
• Liquid Glass: Expanded styling across Mail, Buzz, Contacts, Phone, FaceZoom, Wallet and Setup.
• Animation: Added softer open and close transitions for stories, panels, setup steps and wallet card actions.
• Pictogram Stories: Enforced 24-hour expiry based on actual post time and showed story post timing in the UI.
• Browser: Improved URL parsing to distinguish real domains from search queries.
• Localization: Moved new UI text to locale keys instead of hardcoded strings.
• Settings: Expanded full-row interaction for app settings beyond toggle-only hit areas.
• Mail: Removed the unused microphone button from search.

🐛 Fixed

• Pictogram Live: Reduced frame payload weight and capture frequency to lower lag and prevent event overflow crashes.
• Gallery: Made deleted photos disappear immediately and remain gone after restart.

⚙️ Config

• Mail: Added configurable mailbox domain and mailbox account limit.
• Browser: Added configurable proxy URL, proxy mode and optional allowlist behavior.
• Dialer: Added a configurable test number, defaulting to 511.
• Media Storage: Added support for FiveManage and Discord upload providers.

📦 Update notes

• Media Storage: Config guidance explains that Discord webhooks can expire, causing media to disappear over time.

✨ New

• Setup Wizard: Added a software update stage before first use.
• Setup Wizard: Powers off after setup, so the phone must be turned on again before use.
• Setup Wizard: Added Light, Auto, and Dark theme selection during onboarding.
• Mail: Added a mailbox hub with menus, inbox views, compose flow, and primary mailbox selection.
• Mail: Requires mailbox creation before mail can be received.
• Contacts: Added contact sharing through Agency Drop and tappable contact cards in chats.
• Browser: Added Google search fallback for input that is not a URL.
• Wallet: Unlocks Agency Pay immediately after the first card is created.
• Music: Added a background-ready shared playback receiver for nearby shared music.
• Media Storage: Added selectable upload backends, FiveManage and Discord webhooks. FiveManage is the default.

🔧 Improved

• AgencyOS26.3: Rebranded the phone system, setup flow, and app surfaces.
• Browser: Reworked the start page, top bar behavior, back flow, and compatibility messaging.
• Music: Improved bottom safe-area handling and now-playing screen spacing.
• Pictogram: Reworked stories, story viewer, story timing, live overlays, and live analytics presentation.
• Phone: Reworked Recents density, keypad spacing, typed-number area, and bottom navigation placement.
• Buzz: Redesigned the messaging hub with filters, edit mode, search, and quick actions.
• Contacts: Redesigned the contacts hub with Lists, an improved self-card, and group and list creation.
• Phone: Redesigned the phone experience with Favorites, Recents, Contacts, Keypad, and floating navigation.
• Homescreen: Reworked page resolution, widget placement, and page movement to prevent scattered app layouts.
• Homescreen: Improved cross-page dragging, wheel navigation in edit mode, and safer edit-mode entry.
• Homescreen: Added a reset to a clean default app layout after a phone wipe.
• Mail: Improved layout, sizing, spacing, and readability in white and dark modes.
• Buzz: Improved conversation layout, bubble alignment, emoji composer, white mode readability, and filter transitions.
• Contacts: Improved card sizing, action layout, and white mode appearance.
• Wallet: Improved card animations and selection visibility, especially in white mode.
• FaceZoom: Reworked the hub layout, call overlays, and transition from audio to video calls.

⚙️ Config

• Mail: Added configurable default mailbox limit and agencyg.de domain.
• Mail: Added optional per-app Face Unlock handling instead of requiring unlock for every mailbox action.
• Phone: Added configurable always-reachable test number 511 for audio and video calls.
• Browser: Unrestricted website mode is enabled by default. Allowlist and proxy configuration remain available.
• Browser: Added configurable proxy mode and clearer browser compatibility warnings.
• Settings: Added Auto appearance mode based on the phone's configured time.

✨ New

• Added first-time card onboarding so users create their own card before using Wallet features.
• Added custom Agency Pay card creation with multiple finishes.
• Added a redesigned Wallet with Cards, Agency Pay, Transfer, Fixed and Activity tabs.
• Added Agency Pay quick launch via Action Button, power double-press and /agencypay.
• Added a redesigned Settings app with profile, appearance, device info and Agency Shop sections.

🔧 Improved

• Improved folder drop behavior and reduced accidental page switching while rearranging apps.
• Moved Widgets into edit mode and hid the clock while editing.
• Improved Agency Pay fullscreen checkout, success flow, terminal detection and payment state handling.
• Improved Agency Pay state cleanup after repeated use.
• Dispatch calls now stack instead of replacing each other.
• Respond now sets GPS routing and tells callers which unit is on the way.
• Improved MDT patient search and removed legacy back-button handling.
• Improved app open and install flow, and refined store card presentation.
• Improved 2048, Flappy Bird and roulette presentation and interactions.
• Reworked the Dynamic Island music player in compact and expanded states with richer playback controls.
• Updated device frame rendering and finish customization for a premium metal look.
• Refined app editing, widget access and system overlays.
• Updated AgencyOS26.2.1 version references in system info and update areas.
• Refined lock screen clock styling with a liquid-glass look.
• Improved Settings and Wallet readability in light mode.
• Expanded translations for payments, dispatch, settings and game flows.

🐛 Fixed

• Fixed app dragging so moved apps stay visible on the cursor.
• Fixed Agency Pay cancellation so Wallet returns to the correct state.
• Fixed saved cards not being recognized immediately after a restart.
• Reduced Wallet and Agency Pay state rebuild issues that could cause blank screens or stuck overlays.

⚙️ Config

• Added an option to disable all money-generating gambling apps.
• Added Agency Pay terminal settings for location, heading, amount, label and reward support.
• Added aluminium frame finish selection in Settings, with presets and appearance controls.

📦 Update notes

• Added configurable Agency Pay terminals with terminal detection, pricing, reward and metadata support.

✨ New

• AutoRide: Added driverless pickups, vehicle choices, live ride controls, pricing, passenger support, and phone-language pickup requests.
• Agency Reports: Added V2 integration with standard, ad-free, and legacy modes.
• AgencyOS26.2: Expanded translations across all supported languages.
• GarageSystem: Added auto-detection and expanded garage provider support.
• Storage: Added an option to store phone data per device instead of per player.
• Stocks: Added profit and loss tracking, portfolio charts, additional stocks, and ETF options.
• Banking: Added Oxide Banking as a provider option.

🔧 Improved

• Notifications: Added a Notification Center and Lock Screen system with stacking, history, app deep links, highlights, and home and lock screen delivery.
• Maps: Overhauled the app with a GTA-style map, Fast Nav, pins, nearby points of interest, and synced GPS waypoint routing.
• FaceZoom: Added phone-number-based video calls without account login and handheld call presentation in the phone.
• Agency HUD: Added sync exports for phone open and close events.
• Pictogram: Added livestream and story features, with an upgraded social media feature set.
• App Store: Downloads now behave like installations, with apps locked until completion and clearer progress.
• Control Center: Improved swipe behavior, dismissal, gesture zones, performance toggle access, and scale synchronization.
• Performance Mode: Added support for lower-end PCs, startup activation, and Control Center access.
• AgencyOS26.2: Redesigned the homescreen, setup wizard, Control Center, notifications, widgets, calculator, music, maps, and system overlays with a liquid-glass style.
• Apps: Redesigned Angy, Music, Maps, Calculator, Radio, App Store, and AutoRide for consistent visuals and navigation.
• Homescreen: Improved edit mode app and widget dragging, folders, persistence, and long-press handling.
• Startup and shutdown: Added a boot animation, shutdown slider, emergency actions, and improved first-boot and update experiences.
• Music: Made the app a default app and redesigned now-playing with stronger media controls.
• UI: Improved app close animations and background loading.
• Game Mode: Redesigned presentation around the Dynamic Island with cleaner entry and exit behavior.
• Lock Screen: Refined notifications, swipe-to-dismiss behavior, and white and dark mode presentation.
• AutoRide: Redesigned ride overlays, commands, live pricing, and boarding flow.
• Control Button: Expanded short-press and long-press behavior to align with system settings.

🐛 Fixed

• Garage: Spawned vehicles now retain saved tuning, colors, health, and fuel data.
• Buzz: Received messages are now visible when opening the app.
• Chirper: Fixed posting, gallery media use, and social posting flows.
• Crypto: Buy and sell actions now work in the app with custom amounts.
• Police MDT: Fixed category switching navigation.
• Gallery: Deleted photos remain removed after reopening the app.
• Alarms: Fixed background triggering and timezone handling.
• UI: Fixed white and dark mode readability in popups, forms, menus, and app content.

⚙️ Config

• Agency Reports: Added provider selection for V2, ad-free V2, or legacy mode.
• Wallet: Added fixed-deposit configuration for terms, durations, and interest rates.
• Performance Mode: Added default and startup behavior settings.
• AutoRide and Angy: Added feature toggles, including full disable support.
• LifeInvader: Added V2 integration toggle behavior.
• Banking: Added Oxide Banking as a provider option.

📦 Update notes

• Re-import agency-phone.sql to apply the AgencyOS26.2 database schema changes.

✨ New

• Agency-Phone: Added md-garage support.
• Agency-Phone: Home indicator opens the Angy overlay on the homescreen.

🔧 Improved

• Agency-Phone: Added swipe auto-dismiss.
• Agency-Phone: Improved ESX JSON vehicle parsing.
• Agency-Phone: Smoother app close animation.

🐛 Fixed

• Agency-Phone: Fixed homescreen wallpaper.

⚙️ Config

• Agency-Phone: MDT apps are hidden when EnableMDT = false.
• Agency-Phone: Added GarageSystem to force a specific garage or auto-detect.