# AutoLang – Automatic Minecraft Chat Translation<\/p>\n
AutoLang is a sophisticated Minecraft plugin designed to break down language barriers by providing real-time, bi-directional chat translation. Built with performance and flexibility in mind, it seamlessly integrates with your existing server setup while providing extensive customization options for server administrators.<\/p>\n
## Table of Contents
\n1. [Core Features](#core-features)
\n2. [Installation Guide](#installation-guide)
\n3. [Configuration Reference](#configuration-reference)
\n4. [Language Support](#language-support)
\n5. [Command Reference](#command-reference)
\n6. [Advanced Usage](#advanced-usage)
\n7. [Troubleshooting](#troubleshooting)
\n8. [Performance Tuning](#performance-tuning)
\n9. [API Integration](#api-integration)
\n10. [Frequently Asked Questions](#frequently-asked-questions)<\/p>\n
## Core Features<\/p>\n
### Intelligent Language Detection
\nAutoLang employs a sophisticated two-tier detection system:
\n1. **Primary Detection**: Uses the Lingua library, a highly accurate language identification system that analyzes character patterns and statistical properties of text
\n2. **Fallback Detection**: Falls back to a lightweight heuristic-based detector if Lingua cannot be initialized or if performance is a concern<\/p>\n
### Translation Architecture
\n– **Asynchronous Processing**: All translation operations are performed asynchronously to prevent server lag
\n– **Smart Caching Layer**: Implements an LRU (Least Recently Used) cache with configurable size and TTL to minimize redundant translations
\n– **Bidirectional Translation**: Maintains message context for accurate bidirectional translations between any supported language pairs<\/p>\n
### Player Experience
\n– **Seamless Integration**: Works with existing chat plugins and permission systems
\n– **Client-Language Awareness**: Detects and respects player client language settings (Paper servers only)
\n– **Non-Intrusive**: Players can opt-out of translation or view original messages
\n– **Context Preservation**: Maintains formatting, colors, and clickable elements in translated messages<\/p>\n
## Installation Guide<\/p>\n
### System Requirements
\n– **Minecraft Server**: Paper\/Spigot 1.21.1 or higher (recommended for full feature support)
\n– **Java**: Java 21 or later
\n– **Memory**: Minimum 4GB RAM (6GB+ recommended for larger servers)
\n– **Storage**: 1GB free space (more if using local translation models)<\/p>\n
### Step-by-Step Installation
\n1. Download the latest AutoLang JAR from the Modrinth releases page
\n2. Place the JAR file in your server’s `plugins\/` directory
\n3. Start your server to generate the default configuration
\n4. Stop the server and edit `plugins\/AutoLang\/config.yml` to your preferences
\n5. Restart your server to apply changes<\/p>\n
### Initial Setup Recommendations
\n1. **For New Servers**:
\n – Start with default settings
\n – Test basic functionality with a few languages
\n – Gradually enable additional features<\/p>\n
2. **For Existing Servers**:
\n – Test in a staging environment first
\n – Consider starting with translation disabled (`autodetect.enabled: false`)
\n – Gradually roll out to staff before enabling for all players<\/p>\n
## Configuration Reference<\/p>\n
### Core Settings
\n“`yaml
\n# Default server language (must be a configured language code)
\ndefault-language: “en”<\/p>\n
# Maximum concurrent translation threads
\nmax-translation-threads: 4<\/p>\n
# Maximum time to wait for a translation (milliseconds)
\ntranslation-timeout-ms: 3000<\/p>\n
# Enable debug logging (verbose)
\ndebug: false<\/p>\n
### Language Configuration<\/p>\n
AutoLang provides flexible language management with support for automatic language discovery and manual overrides. The configuration is structured to be both powerful and easy to use.<\/p>\n
“`yaml
\nlanguages:
\n # Auto-fetch supported languages from LibreTranslate
\n # When enabled, the plugin will query your LibreTranslate instance for available languages
\n auto-from-libretranslate: true<\/p>\n
# Whitelist specific language codes (case-insensitive)
\n # Example: [“en”, “es”, “fr”, “de”, “ja”]
\n # If empty, all languages from the source will be included
\n include: []<\/p>\n
# Blacklist specific language codes
\n # Example: [“zh-tw”, “pt-br”] (to exclude specific regional variants)
\n # These languages will be excluded even if included above or in static
\n exclude: []<\/p>\n
# Static language definitions
\n # These are used in three scenarios:
\n # 1. As fallback if auto-fetching fails
\n # 2. To add languages not provided by your LibreTranslate instance
\n # 3. To override properties of auto-fetched languages
\n static:
\n – code: “en”
\n name: “English”
\n – code: “es”
\n name: “Espa\u00f1ol”<\/p>\n
# Override display names for specific language codes
\n # This only affects how languages are displayed to players
\n # Format: {code: “display name”}
\n overrides:
\n – code: “zh”
\n name: “\u7b80\u4f53\u4e2d\u6587” # Simplified Chinese
\n – code: “zh-tw”
\n name: “\u7e41\u9ad4\u4e2d\u6587” # Traditional Chinese
\n – code: “pt-br”
\n name: “Portugu\u00eas (Brasil)” # Brazilian Portuguese<\/p>\n
# Language detection settings
\ndetection:
\n # Minimum confidence threshold (0.0 to 1.0)
\n # Lower values may increase false positives
\n # Higher values may fail to detect some languages
\n confidence-threshold: 0.75<\/p>\n
# Number of messages to analyze before making a detection
\n # More messages increase accuracy but delay detection
\n min-messages: 3<\/p>\n
# Maximum message length to analyze (characters)
\n # Longer messages provide more context but use more resources
\n max-message-length: 1000<\/p>\n
# Client language integration (Paper servers only)
\nclient-locale:
\n # Enable\/disable client language detection
\n enabled: true<\/p>\n
# Automatically set the detected language
\n auto-accept: true<\/p>\n
# Notify players when their language is auto-detected
\n notify-on-detect: true<\/p>\n
# Message format for language detection notification
\n # Available placeholders: %player%, %lang%, %code%
\n detection-message: “&aYour chat language has been set to %lang%”<\/p>\n
# Formatting options for translated messages
\nformatting:
\n # Format for translated messages
\n # Available placeholders:
\n # %player% – Original message sender
\n # %message% – Translated message
\n # %original% – Original message (if show-original is true)
\n # %lang% – Target language name
\n # %code% – Target language code
\n format: “&7[%lang%] &f%player%&7: &r%message%”<\/p>\n
# Show original message after translation
\n show-original: false<\/p>\n
# Format for original message when show-original is true
\n original-format: ” &7(Original: %original%)”<\/p>\n
# Message cooldown settings
\ncooldown:
\n # Global cooldown between messages (seconds)
\n global: 0.5<\/p>\n
# Per-player cooldown (seconds)
\n per-player: 2.0<\/p>\n
# Message to show when cooldown is active
\n # Available placeholders: %time%
\n message: “&cPlease wait %time% seconds before sending another message.”<\/p>\n
# Anti-spam settings
\nanti-spam:
\n # Enable\/disable anti-spam
\n enabled: true<\/p>\n
# Maximum similar messages allowed within time window
\n max-similar: 3<\/p>\n
# Time window for similar message detection (seconds)
\n time-window: 10<\/p>\n
# Message to show when anti-spam is triggered
\n message: “&cPlease avoid sending similar messages in quick succession.”<\/p>\n
### Translation Engine Configuration<\/p>\n
AutoLang supports multiple translation backends, each with its own configuration options. Choose the one that best fits your server’s needs.<\/p>\n
#### 1. LibreTranslate (Recommended)<\/p>\n
LibreTranslate is an open-source translation API that supports over 100 languages. It can be self-hosted or used against public instances.<\/p>\n
“`yaml
\nlibretranslate:
\n # Enable\/disable the LibreTranslate integration
\n enabled: true<\/p>\n
# Base URL of your LibreTranslate instance
\n # Examples:
\n # – Local: “http:\/\/127.0.0.1:5000”
\n # – Public: “https:\/\/libretranslate.com”
\n base-url: “http:\/\/127.0.0.1:5000”<\/p>\n
# Required when connecting to non-localhost URLs
\n allow-remote: false<\/p>\n
# Disable SSL certificate validation (for self-signed certificates)
\n insecure-tls: false<\/p>\n
# API key if required by your LibreTranslate instance
\n api-key: “”<\/p>\n
# Request timeout in seconds
\n timeout: 30<\/p>\n
# Maximum retry attempts for failed requests
\n max-retries: 3<\/p>\n
# Delay between retry attempts in seconds
\n retry-delay: 2<\/p>\n
# Automatic Language Detection
\n auto-detect: true<\/p>\n
# Preferred language pairs for better quality
\n # Format: “source-target”
\n preferred-pairs:
\n – “en-es”
\n – “es-en”
\n – “fr-en”
\n – “en-fr”<\/p>\n
# Managed LibreTranslate Server (Optional)
\n # Auto-downloads and manages a local LibreTranslate instance
\n managed:
\n enabled: false<\/p>\n
# Command to start LibreTranslate
\n # Examples:
\n # – “libretranslate” (if installed via pip)
\n # – “python -m libretranslate”
\n # – “docker run -p 5000:5000 libretranslate\/libretranslate”
\n command: “libretranslate”<\/p>\n
# Port to run the server on
\n port: 5000<\/p>\n
# Host to bind to (use 0.0.0.0 for network access)
\n host: “127.0.0.1”<\/p>\n
# Limit loaded languages to reduce memory usage
\n # Example: “en,es,fr,de,ru,zh,ja,ko”
\n load-only: “”<\/p>\n
# Automatically download language models on first run
\n download-models: true<\/p>\n
# Path to store models (default: ~\/.local\/share\/libretranslate)
\n models-path: “”<\/p>\n
# Additional command-line arguments
\n # Example: “–load-only en,es –threads 4”
\n extra-args: “”<\/p>\n
# Environment variables
\n env:
\n # Example: “CUDA_VISIBLE_DEVICES=0”
\n # Example: “PUID=1000”<\/p>\n
# Health check settings
\n health-check:
\n # Enable health checks
\n enabled: true<\/p>\n
# Health check interval in seconds
\n interval: 30<\/p>\n
# Timeout for health check requests in seconds
\n timeout: 5<\/p>\n
# Number of consecutive failures before considering the service unhealthy
\n threshold: 3<\/p>\n
# Automatic restart settings
\n auto-restart:
\n # Enable automatic restart on failure
\n enabled: true<\/p>\n
# Maximum restart attempts before giving up
\n max-attempts: 5<\/p>\n
# Delay between restart attempts in seconds
\n delay: 10<\/p>\n
# Maximum uptime in minutes (0 = no limit)
\n max-uptime: 0<\/p>\n
# Alternative Translation Backend
\n# Uncomment and configure if not using LibreTranslate
\n#
\n# local-model:
\n# # Enable local model translation
\n# enabled: false
\n#
\n# # Path to your local translation command\/script
\n# # The command should accept text via STDIN and output translation to STDOUT
\n# command: “\/path\/to\/translator”
\n#
\n# # Working directory for the command
\n# working-directory: “\/path\/to\/working\/directory”
\n#
\n# # Command-line arguments
\n# # Use placeholders: {from} {to} for language codes
\n# args: “–from {from} –to {to}”
\n#
\n# # Environment variables
\n# env:
\n# MODEL_PATH: “\/path\/to\/model”
\n# DEVICE: “cuda” # or “cpu”
\n#
\n# # Timeout in seconds
\n# timeout: 30
\n#
\n# # Maximum concurrent translations
\n# max-concurrent: 2
\n#
\n# # Input\/output encoding (default: UTF-8)
\n# encoding: “UTF-8”
\n#
\n# # Error handling
\n# error-handling:
\n# # Maximum retry attempts
\n# max-retries: 3
\n#
\n# # Delay between retries in seconds
\n# retry-delay: 2
\n#
\n# # Fallback language when translation fails
\n# fallback-language: “en”
\n#
\n# External API (Example for Google Translate)
\n#
\n# google-translate:
\n# enabled: false
\n# api-key: “your-api-key”
\n# project-id: “your-project-id”
\n# location: “global”
\n# model: “projects\/{project-id}\/locations\/{location}\/models\/general\/nmt”<\/p>\n
### Detection Settings
\n“`yaml
\ndetector:
\n # “lingua” (more accurate) or “heuristic” (lighter)
\n type: “lingua”<\/p>\n
# Auto-detection settings
\nautodetect:
\n enabled: true
\n # Minimum messages before attempting detection
\n min-messages-before-detect: 3
\n # Confidence threshold (0.0-1.0)
\n confidence-threshold: 0.80<\/p>\n
# Client language detection (requires Paper)
\nclient-locale:
\n enabled: true
\n # Auto-set language on first join
\n auto-accept: true
\n # Prompt on client language change
\n on-change: true
\n“`<\/p>\n
### Storage
\n“`yaml
\nstorage:
\n # “sqlite” or “yaml”
\n type: “sqlite”
\n # Only for SQLite
\n sqlite-file: “plugins\/AutoLang\/languages.db”<\/p>\n
# Cache settings
\ncache:
\n enabled: true
\n # Maximum cached translations
\n size: 500
\n # Time-to-live in seconds (0 = no expiration)
\n ttl-seconds: 0
\n“`<\/p>\n
## Commands & Permissions<\/p>\n
### Commands ### Permissions ## Language Support<\/p>\n AutoLang supports all languages available in your LibreTranslate instance (100+ languages by default). The plugin automatically fetches and caches the available languages on startup.<\/p>\n ### Common Language Codes ## Installation<\/p>\n 1. Download the latest version from Modrinth ## \ud83d\udd27 Troubleshooting<\/p>\n ### LibreTranslate Connection Issues ### Language Detection ### Performance ## Dependencies ## License ## Support ## Metrics A lightweight plugin that supports up to 100 languages, automatically translating chat messages into each player\u2019s preferred language for seamless communication.<\/p>\n","protected":false},"featured_media":23445,"template":"","meta":{"_minecraft_slug":"autolang","_minecraft_project_id":"ijTgQ2WA","_minecraft_author":"Bobcat","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":1010,"_minecraft_follows":5,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"autolang.zip","_minecraft_size_bytes":574280318,"_minecraft_version_count":4,"_minecraft_updated_at":"2026-05-16T08:35:43.085411Z","_minecraft_date_created":"2025-09-10T18:49:23.813256Z","_minecraft_date_modified":"2025-10-03T02:54:47.206196Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/autolang","_minecraft_icon_attachment_id":23445,"_minecraft_imported_at":"2026-05-31T22:35:33+00:00","_minecraft_import_hash":"5fb0ede1a1d4a14a17bccf7954042128","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,104,127,867,123,92],"mod_loader":[132],"minecraft_version":[36,60,93,94,101,102,62,37,73,74,38,78,79,80,81,82],"class_list":["post-23444","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-forge","mod_category-paper","mod_category-social","mod_category-technology","mod_category-utility","mod_loader-paper","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– `\/lang` – Show current language
\n– `\/lang set ` - Set your language
\n- `\/lang list` - List available languages
\n- `\/lang reload` - Reload configuration
\n- `\/lang health` - Check LibreTranslate status<\/p>\n
\n- `autolang.use` - Allow using language commands (default: true)
\n- `autolang.admin` - Allow admin commands like reload (default: op)
\n- `autolang.bypass` - Bypass translation (see all messages in original language)<\/p>\n
\n- `en` - English
\n- `es` - Spanish
\n- `fr` - French
\n- `de` - German
\n- `ru` - Russian
\n- `zh` - Chinese (Simplified)
\n- `ja` - Japanese
\n- `ar` - Arabic
\n- `pt` - Portuguese
\n- `hi` - Hindi<\/p>\n
\n2. Place the JAR in your server's `plugins\/` folder
\n3. Start your server to generate the config
\n4. Edit `plugins\/AutoLang\/config.yml` to your preferences
\n5. Run `\/reload` or restart your server<\/p>\n
\n- Ensure `allow-remote: true` if using a remote server
\n- For HTTPS with self-signed certs, enable `insecure-tls: true`
\n- Check server logs for connection errors<\/p>\n
\n- Lingua detector requires at least 2 languages configured
\n- More messages improve detection accuracy
\n- Try the heuristic detector if Lingua causes performance issues<\/p>\n
\n- Adjust `max-translation-threads` based on your server's CPU
\n- Enable caching to reduce API calls
\n- Consider a local LibreTranslate instance for better performance<\/p>\n
\n- **Required**: Java 21+
\n- **Recommended**: Paper\/Spigot 1.21.1+ (for full feature support)
\n- **Optional**: LibreTranslate server (local or remote)<\/p>\n
\nAutoLang is licensed under the MIT License.<\/p>\n
\nFound a bug or have a feature request? Open an issue on GitHub.<\/p>\n
\nAutoLang uses bStats for anonymous usage statistics. You can opt out in the `bStats\/config.yml` file.<\/p>\n","protected":false},"excerpt":{"rendered":"