SM Translate

Sourcemod plugin that automatically translates messages in chat to all users' target language. Translations are done with Google Cloud Translate v2. A system checks if translation is necessary before even calling the API for a reduction in token usage.

Note

• The server uses franc for detecting languages. By default to reduce false positives, it will not translate any text under 10 characters long.
• Translations are not perfect, nor is language detection. Some messages may show the wrong language or bad translations.

Setup

Requires System 2 extenstion. Some versions of System2 seem to cause crashes with outdated GLIBC libraries.

Plugin

Download plugin from the releases or artifacts pages.

Change sm_translate_api_path (default: http://localhost:5000/translate) as applicable. Config file is at left4dead2/cfg/sourcemod/sm_translate.cfg

Server

Translation server requires an API Key for Google Cloud Translation. I recommend to limit the key by IP address.

By default server listens on http://0.0.0.0:5000, with the API at POST /translate

docker-compose.yaml

services:
  translate:
    image: git.jackz.me/jackz/translate-server:main
    restart: always
    environment:
      GOOGLE_TRANSLATE_API_KEY: ${GOOGLE_TRANSLATE_API_KEY}
      HOST: 0.0.0.0
    env_file: .env
    ports:
      - 5000:5000
    cpu_shares: 512
    deploy:
      resources:
        limits:
          cpus: "1"
          memory: 512M
        reservations:
          memory: 256M

Commands

• sm_t <lang code> <msg> (or /t, !t) - translates message to target language
• sm_lang - Shows current language and prints list of languages to client console
• sm_lang <lang code/OFF/DEFAULT> - Sets client's target language for translations, or uses game's language (DEFAULT), or disables receiving translations (OFF)

License

MIT License.