AI Translation (FREE) 0.1.2

TRANSLATE YOUR RUST PLUGIN LANGUAGE FILES

AI Translation Free translates an installed plugin's English language file into one target language per command. Use it to prepare plugin messages for your community without translating every JSON value by hand.

Runs on Oxide and Carbon. Player-chat translation and multi-language bulk operations are available in the Pro edition.

FREE OR PRO?

Choose Free for one target language per file command. Choose Pro for multiple languages, bulk file translation and global chat.

View AI Translation Pro →

CONFIGURE IN YOUR BROWSER

Configure AI Translation Free on PimpMyRust: choose the model, adjust request limits and export the JSON for your server. Import your existing configuration when updating an installed plugin.

Configure AI Translation Free on PimpMyRust →

INSTALLATION AND ACCESS

For AI Translation Free 0.1.2, you need a Rust server running Oxide or Carbon and your own OpenAI API key with available provider credit. No additional plugin is required.

1. Install AITranslation.cs in your server plugin directory. Loading it creates AITranslation.json in the framework configuration directory.
2. Set OpenAIToken, review the model and limits, then reload the plugin. Keep access to the configuration file restricted.
3. Check that the installed plugin has an English source file at oxide/lang/en/<PluginName>.json.

Server console, RCON and Rust administrators can run file commands. Grant aitranslation.admin only to other trusted users who should be allowed to trigger paid OpenAI requests.

Free and Pro are mutually exclusive. When both are installed, Pro takes priority and Free unloads.

TRANSLATE A PLUGIN

To create a French language file for an installed plugin named MyPlugin, run this command from server console or RCON:

aitfree.translateplugin MyPlugin fr

Replace MyPlugin with the plugin name and fr with your target language code. The source is oxide/lang/en/MyPlugin.json; a successful translation writes oxide/lang/fr/MyPlugin.json.

The historical alias ait.translateplugin MyPlugin fr performs the same operation. Use either command once.

FILE VALIDATION AND BACKUPS

Before writing, the plugin checks JSON structure, the exact key set, string values, recognized placeholders and size limits. Interrupted provider responses are rejected. If validation fails, the existing target file is left unchanged.

When replacing an existing target, the plugin keeps a backup and uses staging and rollback files to recover from interrupted writes. A first translation into a new locale creates a new file; there is no previous target to back up.

Review the translated messages before using them with players. These checks protect the file structure; they do not verify translation accuracy or guarantee that every sentence is in the requested language.

OPENAI COSTS AND CONFIGURATION

The plugin is free; OpenAI API usage is billed separately to your account. Queue, concurrency, request-rate, daily-request, token and retry limits apply locally. Monitor provider usage as well; local token limits are not a currency spending cap.

An authorized command sends the selected English file's JSON keys and values, target language and translation instructions to OpenAI. The plugin does not write API keys, language-file contents or provider response bodies to its logs.

Complete default configuration for Free 0.1.2, with a token placeholder. Replace the placeholder with your own key. If you already have a configuration, keep your settings and review changes before replacing it.

{
  "OpenAIToken": "PASTE_TOKEN_HERE",
  "LangFilesConfiguration": {
    "Enabled": true,
    "Model": {
      "Model": "gpt-5.6-luna",
      "Temperature": 0.0,
      "MaxTokens": 4096,
      "Prompt": ""
    }
  },
  "Limits": {
    "MaxQueued": 16,
    "MaxConcurrent": 2,
    "MaxRequestsPerMinute": 20,
    "MaxRequestsPerDay": 500,
    "DailyTokenBudget": 250000,
    "MaxRetries": 2,
    "MaxLanguageFileCharacters": 60000,
    "MaxProviderResponseCharacters": 150000
  }
}

Temperature and Prompt are retained for legacy compatibility. Current requests use built-in translation instructions.

DOCUMENTATION AND SUPPORT

If translation does not start, check the key, source file, enabled setting, local limits and any unresolved recovery files. Keep an existing backup until you have checked the result.

For support, provide the plugin and framework versions, command, target language and redacted error code. Never share your API key or private file contents.

Read the AI Translation Free installation and recovery guide →

Explore our other Rust plugins and available beta versions on PimpMyRust →