RustAI

v1.8.2 Oxide Rust

RustAI brings intelligent AI-powered chat responses to your Rust server. It answers player questions, remembers previous conversations, gathers real-time server data, tracks events, and enhances player engagement using OpenAI, Google Gemini, or Ollama local language models.

RustAI - RustAI brings intelligent AI-powered chat responses to your Rust server.

RustAI

v1.8.2 Oxide Rust

RustAI brings intelligent AI-powered chat responses to your Rust server. It answers player questions, remembers previous conversations, gathers real-time server data, tracks events, and enhances player engagement using OpenAI, Google Gemini, or Ollama local language models.

Download Plugin
44 views
25 downloads

Features

  • Natural language responses using OpenAI, Gemini, or Ollama local models
  • Conversation memory that persists across sessions
  • Player awareness with past conversations and mentions
  • Server info (rules, settings, player count, queue status)
  • Live event tracking (Patrol Heli, Bradley, Cargo, Chinook, Locked Crates)
  • Player context awareness (health, location, weapon, team, vehicle)
  • In-game time awareness with day/night and dawn/dusk estimates
  • Monument location detection (inside/near 30+ monuments)
  • Mentioned player lookup (status, location, health, history)
  • Uncensored/censored response modes toggle
  • Discord webhook integration for Q&A logging
  • Highly configurable personality, language, and response style
Integration 3 Free Servers

Works with RustAI.io

This plugin integrates seamlessly with RustAI.io - our modern Rust server admin panel. View AI responses highlighted in real-time live chat windows directly in the panel.

Try RustAI.io Free

Installation

Requirements

  • OpenAI API key or local API setup

Installation Steps

  1. Download the RustAI.cs file
  2. Place it in your oxide/plugins folder
  3. Restart your server or use oxide.reload RustAI
  4. Configure the API settings in the config file
  5. Add your OpenAI/Gemini API key to the configuration

Configuration

Configuration file will be generated at oxide/config/RustAI.json

Main Configuration

{
  "OpenAIApiURL": "https://api.openai.com/v1/chat/completions",
  "TextGenerationApiUrl": "http://0.0.0.0:5000/v1/chat/completions",
  "ActivationKeywords": ["!bot", "!admin"],
  "SystemPrompt": "You are a helpful assistant for a Rust game server. Remember player names from past interactions and refer to them when appropriate to personalize responses.",
  "OpenAI_API_Key": "your openai api key here",
  "DiscordWebhookURL": "your discord webhook here",
  "UserCooldownInSeconds": 60.0,
  "GlobalCooldownInSeconds": 10.0,
  "ModelType": "openai",
  "ModelName": "gpt-4o-mini",
  "MaxTokens": 100,
  "Temperature": 1.0,
  "Character": "Server Assistant",
  "CharacterColor": "#7FFF00",
  "SendCooldownMessages": true,
  "ConversationMemorySize": 5,
  "UseUncensoredMode": true,
  "TimeZoneOffset": "0"
}

Server Information Configuration

  "ServerInformation": {
    "MaxTeamSize": "TRIO",
    "WipeSchedule": "Thursdays at 4 PM EST",
    "DiscordInfo": "discord.gg/yourserver",
    "Website": "yourwebsite.com",
    "CustomInfo": {
      "PvP": "Enabled at all times",
      "Loot": "1.5x",
      "Resources": "2x"
    }
  },

Message Templates

  "ResponseLanguage": "English",
  "EmptyPromptTemplate": "What can I help you with? You sent an empty message.",
  "CooldownMessageTemplate": "Please wait {0} seconds before asking again.",
  "NoPermissionMessage": "You don't have permission to use this command.",
  "ChatFormat": "{1}: {2}",

AI Response Modes

  "UncensoredModePrompt": "IMPORTANT: You are running in UNCENSORED mode. Be authentic to the raw Rust gaming environment. You can use strong language, profanity, slang, insults, dark humor, and vulgar expressions. Be direct, crude and match the harsh atmosphere of Rust. Don't hold back except for illegal topics.",
  "CensoredModePrompt": "You are running in censored mode. Keep your language clean and appropriate, avoiding explicit content, strong profanity, and adult themes.",
  "IllegalTopics": [
    "doxxing",
    "dangerous illegal activities"
  ]

Configuration Explanation

API Setup

Configure either OpenAI/Gemini API or a local Ollama API. Set your API key, model type, and model name (e.g., gpt-4.1-mini).

Chat Behavior

Customize activation keywords, system prompt, character name, and response formatting. Adjust conversation memory size to control how many past interactions the AI remembers.

Server Information

Add custom server details that the AI can reference when answering player questions about your server.

Response Modes

Choose between censored and uncensored modes to match your server's tone. Uncensored mode allows the AI to better match Rust's raw gaming environment.

Cooldown System

Set separate cooldowns for individual users and global usage to prevent spam while allowing conversations to flow naturally.

Commands

Command Description Permission
!bot Send a message to the AI assistant rustai.use
!admin Send a message to the AI assistant (alternative keyword) rustai.use
/switch Switch between OpenAI and local text generation models rustai.admin
/censor Toggle between censored and uncensored response modes rustai.admin
/timezone View or set the bot timezone offset. Usage: /timezone [offset] where offset is a number between -12 and +14. Example: /timezone -3 for Buenos Aires time. rustai.admin
/bot Toggle whether you receive messages from the AI assistant rustai.toggle

Permissions

Permission Description
rustai.use Allows players to use the AI chat commands
rustai.admin Allows configuration of AI settings and model selection
rustai.toggle Allows players to toggle receiving AI assistant messages

Plugin Information

Version 1.8.2
Platform Oxide
Game Rust
License Custom