AI Translation (FREE) 0.1.2

TRANSLATE ONE PLUGIN. KEEP CONTROL OF EVERY REQUEST.

AI Translation Free turns one installed plugin's English language file into one target locale, on demand. The request starts only when an authorized administrator runs the command, and the translated file is accepted only after strict structural validation.

NO BACKGROUND TRANSLATION. NO PLAYER-FACING PROMPT. ONE COMMAND = ONE FILE, ONE LOCALE.

BUILT TO FAIL SAFELY

• Selected-file scope — only the requested English language file is sent for translation.
• Local usage limits — queue, concurrency, retry, request and daily token limits stay under server-owner control.
• Strict validation — missing keys, extra keys, non-string values, altered placeholders and oversized responses are rejected.
• Recoverable writes — backup and rollback material protect the target before replacement.

ONE COMMAND, FIVE GUARDED STEPS

1. Add your OpenAI API token to the protected plugin configuration.
2. Choose one installed plugin and one target locale.
3. Run the translation command from the server console, RCON or an authorized admin connection.
4. AI Translation validates the complete response before touching the target file.
5. The validated translation is written with recovery material retained for verification.

RUN YOUR FIRST TRANSLATION

Start with a known English source at oxide/lang/en/MyPlugin.json. Run the canonical Free command below; the historical alias remains available for existing Free-only installations. Server console, RCON and Rust administrators may run either command. Grant aitranslation.admin only to a trusted non-admin connection that must initiate provider work.

aitfree.translateplugin MyPlugin fr

ait.translateplugin MyPlugin fr

FREE EDITION AT A GLANCE

• One selected plugin language file translated into one locale per command.
• Oxide and Carbon support.
• Configurable OpenAI model and bounded provider usage.
• Exact key-set, value, placeholder, completeness and response-size validation.
• Backup and interrupted-write recovery protection.
• No required plugin dependency.

Free and Pro are separate, mutually exclusive editions. Pro takes priority automatically when present. Player chat and bulk translation remain Pro features.

REQUIREMENTS

• Rust server running Oxide or Carbon.
• AI Translation Free 0.1.2.
• An owner-supplied OpenAI API token with available provider credit.
• An English source file at oxide/lang/en/<PluginName>.json.

SUPPORT AND RECOVERY

If a request cannot start, verify the token, the language-file feature, the English source and any unresolved recovery file. If a response is rejected, use the redacted error code to identify the failed validation before retrying a smaller file.

For support, include the Free version, Oxide or Carbon version, command shape, target locale and redacted error code. Never share your OpenAI token or private language-file contents.

CONFIGURATION THAT MATTERS

The server owner supplies the OpenAI token and remains responsible for provider availability, pricing and charges. Tokens, language-file contents and provider response bodies are not written to plugin logs.

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