onex-voiceInteraction supports optional BYOK (Bring Your Own Key) LLM integration. Without a key, the script will work normally. With a key, LLM can be used as a fallback matcher and to power richer NPC responses in addons like Ambient NPC.
| Config Option | What it Does |
|---|---|
LLM.enableMatchingLLM | Uses LLM as a Tier 4 fallback when all onex matching failed (90% time it get but if its totally out of scripted context it fail that time llm take place) |
LLM.enableAddonLLM | Allows addons (e.g., Ambient NPC) to generate LLM-powered responses |
LLM.prioritizeMatchingLLM | Runs LLM matching first, before any fuzzy matching |
These options are set in shared/config.lua but only take effect if a valid API key is registered at server startup.
Groq is the recommended provider.
Create a free account at console.groq.com and generate an API key.
set groq_api_key "your_groq_api_key_here" ensure onex-base ensure onex-voiceInteraction
Config.LLM = { enableAddonLLM = true, enableMatchingLLM = true, prioritizeMatchingLLM = false, }
After restarting the server with a key configured, check the server console for a BYOK registration message. A 200 response confirms the key is valid. A 401 response means the key was rejected — verify you copied it correctly with no leading or trailing spaces.
Never share or commit your API keys to version control. Set them as convars in server.cfg and ensure that file is excluded from any public repositories.
Last updated 14 days ago