انتقل إلى المحتوى الرئيسي

Advanced Features

The AI Localization Automator includes several advanced features designed to streamline your localization workflow and provide maximum flexibility for complex projects.

Translation Table and Session Management​

Translation Status Tracking​

The main translation table provides comprehensive status information for every text entry:

  • Pending: Text awaiting translation
  • In Progress: Currently being translated
  • Completed: Successfully translated (shown in green)
  • Failed: Translation failed after all retry attempts (shown in red)
  • Cancelled: Translation was interrupted

Context Menu Actions​

Right-click on any text entry to access quick actions:

For Source Text:

  • Copy Source Text: Copy the original text to clipboard

For Translation Entries:

  • Copy Translation: Copy the translated text to clipboard
  • Delete Translation: Remove session translations (only available for text translated in current session)

Preset System​

Save and load complete configuration presets to quickly switch between different project setups or share configurations across your team.

Managing Presets​

The preset system allows you to save and restore your complete configuration with a single click:

Saving Presets captures all your current settings:

  • Selected translation provider
  • Provider-specific configuration (API keys, models, parameters)
  • Translation settings (concurrency, retries, timeouts)
  • Custom prompt template

Loading Presets instantly applies all saved settings, making it easy to:

  • Switch between different AI providers
  • Apply team-standard configurations
  • Set up new projects quickly
  • Test different parameter combinations

Preset File Format​

Presets are saved as JSON files in your project's Saved/TranslationPresets/ directory:

  • Human-readable format for version control
  • Includes metadata like creation date and UE version
  • Can be shared between team members
  • Safely excludes sensitive data when appropriate

Batch Processing Controls​

Concurrency Management​

Control how many translations run simultaneously:

  • Low Concurrency (1-5): Conservative approach, reduces API load
  • Medium Concurrency (6-15): Balanced performance and reliability for cloud providers
  • High Concurrency (16-50): Maximum speed for cloud providers, requires stable connection

Provider-Specific Recommendations:

  • Ollama (Local): Use Low Concurrency (around 4) to avoid overwhelming local resources
  • Cloud Providers (OpenAI, Anthropic, etc.): Medium to High Concurrency based on your network stability and API rate limits

Retry Logic​

Sophisticated retry system handles temporary failures:

Per-Translation Retries: Each text entry can be retried up to the configured limit before being marked as failed.

Global Failure Protection: If too many consecutive failures occur across all translations, the entire process stops to prevent wasting API calls on a systemic issue.

Pause and Resume​

  • Pause Translation: Temporarily halt processing without losing progress
  • Resume Translation: Continue from where you left off
  • Cancel Translation: Stop completely and mark in-progress items as cancelled

Custom Prompt Templates​

Template Variables​

The prompt template supports several context-aware variables:

  • {SourceLanguage_EnglishName}: Source language in English (e.g., "German")
  • {SourceLanguage_NativeLanguage}: Source language in native script (e.g., "Deutsch")
  • {TargetLanguage_EnglishName}: Target language in English (e.g., "Spanish")
  • {TargetLanguage_NativeLanguage}: Target language in native script (e.g., "español")
  • {SourceText}: The actual text to translate
  • {ProviderName}: Current AI provider name

Template Best Practices​

Effective prompts should:

  • Clearly state the translation task
  • Emphasize preserving format specifiers (%s, {0}, etc.)
  • Instruct the AI to output only the translation
  • Provide context about the content type (game UI, dialogue, etc.)
  • Specify any style requirements (formal, casual, technical)

Example for game UI:

Translate this game user interface text from {SourceLanguage_EnglishName} to {TargetLanguage_EnglishName}.

IMPORTANT:
- Output ONLY the translated text
- Preserve all format specifiers like %s, %d, {0}, {1}
- Keep UI text concise and clear
- Use appropriate formality for game interface

Text to translate: {SourceText}

Data Management​

Clear Translations​

The "Clear Translations" function removes all session translations and reloads from saved archive files:

  • Only affects translations made in the current session
  • Preserves previously saved translations
  • Useful for testing different providers or settings
  • Cannot be undone once confirmed

Save Translations​

Commits completed translations to UE's localization archive files:

  • Updates .archive files for each target culture
  • Integrates with UE's localization system
  • Preserves existing translations not modified in this session
  • Updates localization target statistics

Progress Monitoring​

Real-time Progress Updates​

The progress system provides detailed feedback:

  • Progress Bar: Visual indication of completion percentage
  • Numerical Progress: "X/Y completed" counter
  • Status Messages: Current operation and provider information
  • Active Request Count: How many translations are currently processing

Persistent Progress Tracking​

During long translation sessions:

  • Progress persists if you pause and resume
  • Session translations are tracked separately from saved translations
  • Translation status is maintained until explicitly cleared
  • You can safely close and reopen the AI Translation Manager

Integration with Localization Dashboard​

Seamless Workflow​

The plugin integrates directly with UE's localization system:

  • Automatically discovers gathered text entries
  • Reads existing translations from archive files
  • Saves results in UE's standard format
  • Updates localization target statistics
  • Maintains compatibility with other localization tools

Multi-Target Support​

While the UI focuses on one target at a time:

  • Each localization target maintains its own translation state
  • Provider settings are shared across targets
  • You can work with multiple targets in sequence
  • Session tracking is per-target

Performance Optimization​

Memory Management​

The plugin is designed for efficient memory usage:

  • Streams translation data rather than loading everything at once
  • Automatically cleans up completed requests
  • Manages UI updates efficiently for large translation tables
  • Handles thousands of entries without performance degradation

Network Optimization​

For cloud providers:

  • Configurable request timeouts prevent hanging
  • Automatic retry with exponential backoff
  • Connection pooling for better throughput
  • Request batching where supported by providers

Error Recovery​

Robust error handling ensures reliable operation:

  • Automatic retry for transient network issues
  • Graceful degradation when providers are unavailable
  • Detailed error logging for troubleshooting
  • Safe handling of malformed API responses