Voice Interaction changelog

New9

Fixed14

• Shop carry checks no longer incorrectly reject items as INVENTORY_FULL when the item is not recognized by ox_inventory. Unknown items are now treated as carriable so players are not falsely blocked from purchases.
• Fixed a cold-join race condition with TTS where the provider state was not ready when a player first joined, causing TTS to fail silently on connection.
• ElevenLabs synthesis now correctly sends the target language for translation when the server language is set to a non-English locale, ensuring subtitles and audio match the configured language.
• Fixed the TTS audio cache becoming stale after updates. The cache has been renamed internally, so outdated cached audio is automatically discarded and regenerated.
• Voice hints no longer attempt to set animals as voice targets, preventing errors and unintended NPC interactions when animals are nearby.
• Ambient NPC crime reaction and hint translation now correctly skip animals during target scanning, preventing errors when animals are in range.
• Fixed ambient NPC voice hints not translating correctly — hints are now translated via the native script pipeline as intended.
• Fixed a missing backendUrl in the voice hints payload that could cause hint requests to fail when a custom backend is configured.
• VOIP relay now correctly stops when a recording is cancelled, and the relay start is non-blocking so it no longer holds up other voice processing.
• Fixed the NPC Manager displaying the wrong voice name (Edge TTS default) when an ElevenLabs voice was assigned — the correct ElevenLabs voice name is now shown.
• Fixed the NPC debug panel hooks to use the VoiceHints system for target management, aligning debug behavior with the rest of the voice pipeline.
• If an invalid or mistyped language code is set in config, the script now validates it and automatically falls back to English rather than breaking voice features.
• Fixed the translation database upgrade path — the DB version has been bumped to 7 and variable restoration now handles a wider range of bracket formats, preventing data loss on upgrade.
• Fixed the UI page loading from an incorrect path, which could prevent the voice interaction interface from displaying properly.

Files changed45

New23

Improved4

• Deprecated separate groq_api_key convar — Groq STT key is now reused for LLM
• Applied IntegrationRegistry pattern to banking, hospital, and shops addons for cleaner integration management
• Renamed NetworkAudio config section to NetworkSync
• Translation system now auto-detects when translation is needed and wires up dual matching automatically

Fixed18

• Fixed microphone selection — falls back to the first available device when a saved microphone ID is stale or disconnected
• Fixed VOIP relay not stopping when the voice interaction key is released
• Fixed processing animation not clearing immediately when a short recording is cancelled
• Unified TTS animation timing with the progress bar and added an animation refresh loop to prevent stale states
• Fixed default voice being cached before NPC config has finished loading
• ElevenLabs and Azure TTS now correctly use English locale internally and let the backend handle script translation
• TTS cancellation is now broadcast to nearby players so remote audio stops correctly
• TTS progress ring now displays correctly when the NPC is in locked (busy) mode
• Ambient NPCs now preserve their scenarios and animations during voice interactions instead of resetting to idle
• Ambient NPCs no longer flee or act scared while actively in conversation with a player
• Voice settings keybind now persists correctly and long key names no longer overflow the UI
• Multiple voice UI polish fixes: voice card alignment, preview toggle behavior, and NPC manager access restriction removed
• Fixed ox_inventory shop detection failing when shops.lua contains leading annotations
• Fixed NPC communication issues — corrected RPC call structure and response handling
• Voice settings keybind now syncs from config each time the panel opens
• Improved startup connection banner with clearer status messages and retry feedback
• TTS responseLanguage is now only sent when it differs from the primary language, reducing unnecessary API calls
• Improved shop ped spawning with duplicate prevention, ground snapping, and coordinate override support

Files changed51

New9

• Shop NPC Interactions — Talk to shop NPCs using your voice to browse and buy items. Supports qb-shops, ox_inventory, and esx_shops out of the box
• ESX Banking Integration — Added esx_banking support for the banking addon, so ESX servers can use voice banking
• ESX Shops Integration — Added esx_shops support for the shops addon
• Custom Integration Templates — Added _template.lua files for shops, banking, and hospital addons so server owners can easily add support for any custom resource
• Voice Hint Customization — New setScale and setOffset APIs let addons control the size and position of 3D voice hint bubbles above NPCs
• NPC-Lift: Free Exit — You can now leave a ride vehicle anytime. Removed the global cooldown that blocked requesting rides from other NPCs
• NPC-Lift: 2D Hints in Vehicle — Voice hints switch from 3D bubble to a 2D screen overlay while inside the vehicle for better visibility
• Dependency Check — The resource now requires onex-base v1.33.0+ and will show a clear error on startup if the dependency is missing or outdated
• Shop Ped Spawning — For shop systems that don't spawn their own NPCs, the addon now spawns peds at configured locations automatically

Improved5

• Shop Integration System — Rebuilt how shop systems are detected and loaded, making it easier to add new shop resources
• Hospital & Banking Addons — Simplified to use the same integration pattern as shops for consistency
• NPC-Lift Vehicle Manager — Simplified ride logic and payment handling
• Shared Ped Utilities — Extracted common NPC utilities used across addons into a shared module
• Dead Code Cleanup — Removed unused code across client, server, addons, and web UI

Fixed7

• Fixed translation not using the configured target language — it was always defaulting to English
• Fixed NPC driver driving off early when the player exits — handbrake is now enforced during exit
• Fixed qb-banking ped using wrong behind-counter coordinates
• Fixed voice hints sometimes appearing when too far from the NPC
• Fixed ox_inventory shop locations not matching correctly when peds are nearby
• Fixed ox_inventory shops.lua file not parsing correctly in some cases
• Fixed duplicate ped spawning in the banking addon

Files changed47