RustAI

v1.3.2 Oxide Rust

Advanced AI chat system for Rust servers with OpenAI integration, conversation memory, and customizable responses. The plugin creates a dynamic chat assistant that remembers player interactions, provides server information, and can be configured with different personas to enhance your server community.

RustAI - Advanced AI chat system for Rust servers with OpenAI integration, conversation memory, and customizable responses.

RustAI

v1.3.2 Oxide Rust

Advanced AI chat system for Rust servers with OpenAI integration, conversation memory, and customizable responses. The plugin creates a dynamic chat assistant that remembers player interactions, provides server information, and can be configured with different personas to enhance your server community.

Download Plugin
139 views
70 downloads

Features

  • OpenAI, Gemini and custom local API support
  • Player-specific conversation memory system
  • Persistent chat history across sessions
  • Dynamic player context awareness
  • Customizable AI personality and responses
  • Censored and uncensored response modes
  • Discord webhook integration for logging
  • User and global cooldown system
  • Multi-language response capabilities
  • Customizable activation keywords
  • VIP permission system
  • Automatic server information integration

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 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 API or a local text generation API. Set your API key, model type, and model name (e.g., gpt-4o-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.3.2
Platform Oxide
Game Rust
License Custom