Translate text and messages with /translate, and optionally add a flag reaction on messages that are not in your server’s default language. Pressing that reaction replies with a translation embed.

No API key is required. Dreamliner uses Google’s public translate endpoint via google-translate-api-x. That endpoint can rate-limit under heavy use.

#Server default language

Set top-level default_language in guild config (dashboard Server settings), default en:

yaml

default_language: en

This is the target for /translate when no language is chosen, and the flag used by auto-translate.

#Configuration

yaml

plugins:
  translation:
    enabled: true
    config:
      auto_translate: false
      ignored_channels: []

Field	Description
`auto_translate`	Dreamliner One exclusive. When `true`, react with the default-language flag on messages that look like another language. Default `false`.
`ignored_channels`	Channel IDs where auto-translate is skipped.

#Commands

Command	Permission	Description
`/translate`	`can_translate`	Translate `text` or a `message_id` (raw ID in this channel, or a Discord message link). Optional `language` (autocomplete); otherwise uses the server default.

Grant can_translate to a Dreamliner Role on the dashboard's Roles page (or /permissions role grant) — see permissions.md.

#Auto-translate

Auto-translate is a Dreamliner One exclusive.

Subscribe to Dreamliner One for the server.
Enable auto_translate in the dashboard or YAML.
Members post in any channel except those in ignored_channels.
If Dreamliner detects a different language than default_language, it adds that language’s flag reaction.
Anyone can press the reaction; Dreamliner posts a silent plain-text translation as the original author (via webhook), with a small “Translated with Dreamliner” footer. The bot needs Manage Webhooks in that channel for the author avatar/name; otherwise it falls back to a plain bot reply.

/translate stays available without Dreamliner One. Auto-translate flag reactions do not run unless Dreamliner One is active.

Very short messages (under 4 characters) are skipped for detection noise.

#Examples

yaml

default_language: es

plugins:
  translation:
    enabled: true
    config:
      auto_translate: true
      ignored_channels:
        - "1111111111111111111"

Or use Discord:

Set Default language on the dashboard Server page.
Open the Translation plugin → enable Auto translate.
/translate text:Hola language:English