How It Works
A visual guide to understanding how the knowledge generator, OpenAI, and your Rust server work together.
Server Admin
Fills out form
This Website
Generates knowledge files
OpenAI
Vector Store
Players
Ask questions in chat
Rust Server
OpenAI Chat Plugin
OpenAI API
Searches knowledge + AI response
Two Ways to Deploy
- 1Fill out the form with your server info
- 2Enter your OpenAI API key in "Deploy to OpenAI"
- 3Click "Deploy to OpenAI" to create your vector store
- 4Copy the Vector Store ID to your plugin config
- 5Update anytime by clicking "Update Files"
Plugin config:
"Vector Store ID": "vs_xxx...""Auto Create Vector Store": false- 1Fill out the form with your server info
- 2Download the knowledge files (.zip)
- 3Extract to your server's knowledge folder
- 4Run
openai.kb syncin console - 5Repeat steps 2-4 to update
File paths:
oxide/data/OpenAI/knowledge/carbon/data/OpenAI/knowledge/openai.kbShow all knowledge base commands
openai.kb statusCheck knowledge base configuration
openai.kb syncUpload local files to vector store
openai.kb pullDownload files from vector store
openai.kb filesList files in vector store
openai.kb clearRemove all files from vector store
What is a Vector Store?
A vector store is a database hosted by OpenAI that stores your knowledge files and allows the AI to search through them semantically. When a player asks a question, the AI searches the vector store for relevant information before generating a response.
Do I need to pay for OpenAI?
Yes, the OpenAI Chat plugin requires an OpenAI API key with credits. Costs vary significantly based on player usage, the AI model selected, and your rate limit settings. We recommend testing the plugin and monitoring your costs on the OpenAI Usage page to determine your expected monthly spend.
Which method should I use?
Deploy from Website is recommended because updates are instant - just click a button. Manual file transfer requires FTP/SFTP access and running sync commands each time you update.
Is my API key safe?
Your API key is stored only in your browser's local storage and sent directly to OpenAI. It never touches our servers. For best security, use a dedicated API key with spending limits.
Can I edit files locally and push them?
Yes! Use openai.kb pull to download files to your server, edit them with a text editor, then openai.kb sync to upload changes.