English | Русский
Advanced asynchronous translator for Minecraft FTB Quests files (.snbt) with support for multiple local and cloud translation engines, featuring a 4-tab GUI and intelligent SQLite caching system.
| Platform | Command |
|---|---|
| Windows | winget install org.mineai.snbt-tr (Recommended) |
| Arch Linux AUR | yay -S snbt-tr |
| Flatpak | flatpak install org.mineai.snbt-tr |
| pipx | pipx install snbt-tr |
| PyPI | pip install snbt-tr |
git clone https://github.com/ronnikols/SNBT-AI-Localizer.git
cd SNBT-AI-Localizer
pip install -r requirements.txtsnbt-tr- Launches the interactive CLI setup wizardsnbt-tr --gui- Launches the PyQt6 GUI with dual-tab interfacesnbt-tr [options]- Unattended batch execution
snbt-tr --list-models -p groq
snbt-tr -d /path/to/quests -p groq -k YOUR_API_KEY
snbt-tr --mix -d /path/to/quests
snbt-tr --clear-cache
snbt-tr --fastdir- Workspace Tab: Primary translation interface with provider/model selection, API key pool management (up to 10 keys), custom context input, target language dropdown, batch processing controls (Start/Pause/Stop), and live logging output
- Translation Memory Tab: Visual cache manager with:
- Real-time search across original and translated text with 300ms debounce
- Modpack combobox filter for isolating translations by modpack
- Target language filter synchronized with Workspace tab
- 4-column QTableWidget (Original, Translation, Modpack, Added) with auto-stretch column width layout
- Inline editing of translations directly in the table
- Bulk operations: Load More (pagination), Delete Selected, Save Changes, Clear Cache
- Settings Tab: Configuration management for providers, models, API keys, and application settings
- Credits Tab: Displays project credits and acknowledgments
- Non-blocking I/O with
asyncioandhttpx.AsyncClient - Configurable concurrency (1-10 threads)
- Adaptive chunking:
- 5 items per chunk for Ollama (local inference)
- Configurable batch size (default: 50) for cloud providers
- Automatic delays between chunks to prevent rate limiting
- Round-Robin multi-key pool with automatic load balancing
- Invalid keys (HTTP 401/403) are permanently removed from the pool
- Rate-limited keys (HTTP 429) enter exponential backoff (0.2s to 64s)
- Fallback to single-item translation on chunk failure
- Mixed Provider Mode: Auto-detects provider from key prefix and uses saved defaults
- Binary split fallback for parse errors with recursive chunk splitting
- SQLite-based cache with WAL mode for concurrent access
- Per-language tables (
cache_{lang_code}) to prevent cross-contamination - Modpack isolation: Translations can be filtered and managed by modpack
- Thread-safe operations with locking
- Real-time persistence between chunks
- Defensive sanitization: Automatic cleanup of nested dictionaries in SNBT and protection against malformed JSON in responses
Prevents redundant API calls for highly similar strings with a 90% similarity threshold
The Pluralization Guard is a sophisticated fuzzy-matching system that automatically detects and reuses translations for similar phrases, preventing duplicate API calls and saving costs. It works by:
- Exact Match Check: First attempts to find an exact match in the cache
- Length Filtering: Searches for candidates within ±15% length of the input text
- Number Preservation: Ensures strings with different numbers (e.g., "item 1" vs "item 2") are NOT matched
- Fuzzy Matching: Uses
difflib.SequenceMatcherwith a 90% similarity threshold - Tail Preservation: Maintains Minecraft formatting codes at the end of strings (e.g., "hello§a" → cached "привет" + "§a")
Example:
- Input:
"Get 5 diamonds"→ Cache miss - Input:
"Get 6 diamonds"→ Cache hit! (90%+ similarity, same structure) - Input:
"Get diamond"→ Cache miss (different number count) - Input:
"Get 5 diamonds§a"→ Cache hit! (matches "Get 5 diamonds" + preserves "§a")
This prevents charging for translations of:
- Plural variations: "apple" → "apples"
- Number variations: "item 1" → "item 2" (if structure matches)
- Minor formatting differences: "text" → "text§a"
- Regex shielding for namespace tags (
#c:ender_pearl_dusts), UUIDs, and entity IDs - Temporary placeholder substitution (
__TAG_N__) during translation - Preserves all Minecraft-specific formatting codes
| Provider | Default Model | Free Tier | Notes |
|---|---|---|---|
| Groq Cloud (Fast) | llama-3.3-70b-versatile | Yes | Low-latency inference |
| NVIDIA NIM | nvidia/nemotron-4-340b-instruct | Yes | Enterprise-grade models |
| OpenRouter (Cloud AI) | google/gemma-4-31b:free | Yes | 100+ free models |
| Google Gemini (Free API) | models/gemini-3.1-flash-lite | Yes | Google's latest free model |
| Sambanova | DeepSeek-V3.1 | No | High-performance inference |
| OpenAI | gpt-4o-mini | No | Optimized for speed |
| Mistral AI | mistral-large-latest | Yes | Open-source frontier models |
| Anthropic (Claude) | claude-3-5-sonnet-20241022 | No | High-quality responses |
| Cohere | command-r-plus | No | Production-ready |
| Ollama (Local / Free) | qwen2.5:7b | Yes | Self-hosted, no API key |
| Google Translate (Free) | N/A | Yes | Traditional MT, no API key |
| Local LLM / Custom | (Custom) | Yes | Custom local models |
For feedback, suggestions, and bug reports, please contact us via:
- Telegram: https://t.me/ronnikols
MIT License - see LICENSE for details.