How bbepis/xunity.autotranslator works
XUnity Auto Translator is a Unity-game localization plugin. Game text is intercepted by framework-specific hooks, parsed and filtered, then queued for a configured translation endpoint; translated text is cached and applied back to the game. Users can also maintain manual translation files, and the repository documents texture translation and multiple plugin-loader integrations. The source index supports the endpoint/job and asset-redirection relationships shown here; several broader feature links are documented only at README level or left unverified because their implementation excerpts were not provided.
Main entry points: TranslationManager.cs Translation Manager · TranslationEndpointManager.cs Endpoint Scheduler · XUnity.ResourceRedirector Asset Redirection · AutoTranslationPlugin.cs Plugin Startup
Components 26
Game Text Capture
- Plugin Startup
src/XUnity.AutoTranslator.Plugin.Core/AutoTranslationPlugin.cs - Text Hooks
src/XUnity.AutoTranslator.Plugin.Core/Hooks - Text Parsing
src/XUnity.AutoTranslator.Plugin.Core/Parsing - Configuration
src/XUnity.AutoTranslator.Plugin.Core/Configuration/Settings.cs
Translation Runtime
- Translation API
src/XUnity.AutoTranslator.Plugin.Core/AutoTranslator.cs - Translation Manager
src/XUnity.AutoTranslator.Plugin.Core/TranslationManager.cs - Endpoint Scheduler
src/XUnity.AutoTranslator.Plugin.Core/Endpoints/TranslationEndpointManager.cs - Untranslated Text
src/XUnity.AutoTranslator.Plugin.Core/UntranslatedText.cs - Translation Jobs
src/XUnity.AutoTranslator.Plugin.Core/TranslationJob.cs - Translation Cache
src/XUnity.AutoTranslator.Plugin.Core/TextTranslationCache.cs
Translation Providers
- Endpoint Interface
src/XUnity.AutoTranslator.Plugin.Core/Endpoints/ITranslateEndpoint.cs - HTTP Translation
src/XUnity.AutoTranslator.Plugin.Core/Endpoints/Http/HttpEndpoint.cs - Service Translators
src/Translators - External Protocol
src/XUnity.AutoTranslator.Plugin.ExtProtocol/ProtocolMessage.cs - Translation Request
src/XUnity.AutoTranslator.Plugin.ExtProtocol/TranslationRequest.cs - Translation Response
src/XUnity.AutoTranslator.Plugin.ExtProtocol/TranslationResponse.cs - Protocol Executor
src/Translators/Common.ExtProtocol.Executor/ExtProtocolHandler.cs
Assets And Manual Data
- Manual Translation Files
src/XUnity.AutoTranslator.Plugin.Core/TranslationFileLoadingContext.cs - Asset Redirection
src/XUnity.ResourceRedirector - Asset Translation
src/XUnity.AutoTranslator.Plugin.Core/AssetRedirection - Texture Translation
src/XUnity.AutoTranslator.Plugin.Core/TextureTranslationCache.cs
Unity Compatibility
- Unity Asset APIs
src/UnityEngine/AssetBundle.cs - Unity Resources
src/UnityEngine/Resources.cs - Loader Adapters
src/XUnity.AutoTranslator.Plugin.BepInEx/AutoTranslatorPlugin.cs
Other components
- Game User
- Plugin Loader
Connections 22
- Plugin Loader → Plugin Startup: loads plugin
README.md - Plugin Startup → Text Hooks: enables hooks
- Text Hooks → Text Parsing: parses text
- Text Parsing → Untranslated Text: creates input
- Configuration → Translation Manager: configures endpoints
src/XUnity.AutoTranslator.Plugin.Core/TranslationManager.cs - Translation Manager → Endpoint Scheduler: registers endpoints
src/XUnity.AutoTranslator.Plugin.Core/TranslationManager.cs - Endpoint Scheduler → Translation Jobs: queues jobs
src/XUnity.AutoTranslator.Plugin.Core/Endpoints/TranslationEndpointManager.cs - Endpoint Scheduler → Untranslated Text: batches input
src/XUnity.AutoTranslator.Plugin.Core/Endpoints/TranslationEndpointManager.cs - Endpoint Scheduler → Translation Cache: stores translations
- Translation Manager → Endpoint Interface: initializes endpoint
src/XUnity.AutoTranslator.Plugin.Core/TranslationManager.cs - Endpoint Interface → HTTP Translation: uses HTTP endpoint
- Translation Manager → Service Translators: loads providers
src/XUnity.AutoTranslator.Plugin.Core/TranslationManager.cs - External Protocol → Translation Request: encodes request
src/XUnity.AutoTranslator.Plugin.ExtProtocol/TranslationRequest.cs - Protocol Executor → Translation Request: handles request
src/Translators/Common.ExtProtocol.Executor/ExtProtocolHandler.cs - Protocol Executor → Translation Response: writes response
src/Translators/Common.ExtProtocol.Executor/ExtProtocolHandler.cs - Manual Translation Files → Translation Cache: loads translations
README.md - Asset Redirection → Asset Translation: redirects loaded assets
src/XUnity.AutoTranslator.Plugin.Core/AssetRedirection/AssetLoadedHandlerBase.cs - Asset Redirection → Unity Asset APIs: intercepts asset loads
src/XUnity.ResourceRedirector/AssetLoadedContext.cs - Asset Redirection → Unity Resources: intercepts resource loads
src/XUnity.ResourceRedirector/ResourceRedirection.cs - Asset Translation → Texture Translation: supports texture translation
README.md - Game User → Text Hooks: encounters game text
README.md - Loader Adapters → Plugin Startup: integrates loader
README.md