# bbepis/xunity.autotranslator architecture

> Architecture diagram of the GitHub repository bbepis/xunity.autotranslator, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bbepis/xunity.autotranslator
- Repository: https://github.com/bbepis/xunity.autotranslator

## Overview

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: [`src/XUnity.AutoTranslator.Plugin.Core/TranslationManager.cs`](https://github.com/bbepis/xunity.autotranslator/blob/master/src/XUnity.AutoTranslator.Plugin.Core/TranslationManager.cs) (Translation Manager), [`src/XUnity.AutoTranslator.Plugin.Core/Endpoints/TranslationEndpointManager.cs`](https://github.com/bbepis/xunity.autotranslator/blob/master/src/XUnity.AutoTranslator.Plugin.Core/Endpoints/TranslationEndpointManager.cs) (Endpoint Scheduler), [`src/XUnity.ResourceRedirector`](https://github.com/bbepis/xunity.autotranslator/tree/master/src/XUnity.ResourceRedirector) (Asset Redirection), [`src/XUnity.AutoTranslator.Plugin.Core/AutoTranslationPlugin.cs`](https://github.com/bbepis/xunity.autotranslator/blob/master/src/XUnity.AutoTranslator.Plugin.Core/AutoTranslationPlugin.cs) (Plugin Startup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_capture["Game Text Capture"]
  node_plugin["Plugin Startup"]
  node_hooks["Text Hooks<br/>[Hooks]"]
  node_parser["Text Parsing<br/>[Parsing]"]
  node_settings["Configuration<br/>[Settings.cs]"]
end

subgraph group_translation["Translation Runtime"]
  node_autotranslator["Translation API<br/>[AutoTranslator.cs]"]
  node_translationmgr["Translation Manager"]
  node_endpointmgr["Endpoint Scheduler"]
  node_text["Untranslated Text"]
  node_jobs["Translation Jobs<br/>[TranslationJob.cs]"]
  node_cache[("Translation Cache")]
end

subgraph group_providers["Translation Providers"]
  node_endpoint["Endpoint Interface"]
  node_web["HTTP Translation<br/>[HttpEndpoint.cs]"]
  node_translators["Service Translators"]
  node_protocol["External Protocol<br/>[ProtocolMessage.cs]"]
  node_request["Translation Request"]
  node_response["Translation Response"]
  node_executor["Protocol Executor"]
end

subgraph group_assets["Assets And Manual Data"]
  node_manual["Manual Translation Files"]
  node_assetredirect["Asset Redirection"]
  node_assettranslation["Asset Translation<br/>[AssetRedirection]"]
  node_texture["Texture Translation"]
end

subgraph group_platform["Unity Compatibility"]
  node_unityassets["Unity Asset APIs<br/>[AssetBundle.cs]"]
  node_unityresources["Unity Resources<br/>[Resources.cs]"]
  node_frameworks["Loader Adapters"]
end

node_player(("Game User"))
node_loader(("Plugin Loader"))

node_loader -.->|"loads plugin"| node_plugin
node_plugin -.->|"enables hooks"| node_hooks
node_hooks -.->|"parses text"| node_parser
node_parser -.->|"creates input"| node_text
node_settings -->|"configures endpoints"| node_translationmgr
node_translationmgr -->|"registers endpoints"| node_endpointmgr
node_endpointmgr -->|"queues jobs"| node_jobs
node_endpointmgr -->|"batches input"| node_text
node_endpointmgr -->|"stores translations"| node_cache
node_translationmgr -->|"initializes endpoint"| node_endpoint
node_endpoint -.->|"uses HTTP endpoint"| node_web
node_translationmgr -.->|"loads providers"| node_translators
node_protocol -.->|"encodes request"| node_request
node_executor -->|"handles request"| node_request
node_executor -->|"writes response"| node_response
node_manual -.->|"loads translations"| node_cache
node_assetredirect -->|"redirects loaded assets"| node_assettranslation
node_assetredirect -->|"intercepts asset loads"| node_unityassets
node_assetredirect -.->|"intercepts resource loads"| node_unityresources
node_assettranslation -.->|"supports texture translation"| node_texture
node_player -.->|"encounters game text"| node_hooks
node_frameworks -.->|"integrates loader"| node_plugin

click node_plugin "https://github.com/bbepis/xunity.autotranslator/blob/master/src/XUnity.AutoTranslator.Plugin.Core/AutoTranslationPlugin.cs"
click node_hooks "https://github.com/bbepis/xunity.autotranslator/tree/master/src/XUnity.AutoTranslator.Plugin.Core/Hooks"
click node_parser "https://github.com/bbepis/xunity.autotranslator/tree/master/src/XUnity.AutoTranslator.Plugin.Core/Parsing"
click node_settings "https://github.com/bbepis/xunity.autotranslator/blob/master/src/XUnity.AutoTranslator.Plugin.Core/Configuration/Settings.cs"
click node_autotranslator "https://github.com/bbepis/xunity.autotranslator/blob/master/src/XUnity.AutoTranslator.Plugin.Core/AutoTranslator.cs"
click node_translationmgr "https://github.com/bbepis/xunity.autotranslator/blob/master/src/XUnity.AutoTranslator.Plugin.Core/TranslationManager.cs"
click node_endpointmgr "https://github.com/bbepis/xunity.autotranslator/blob/master/src/XUnity.AutoTranslator.Plugin.Core/Endpoints/TranslationEndpointManager.cs"
click node_text "https://github.com/bbepis/xunity.autotranslator/blob/master/src/XUnity.AutoTranslator.Plugin.Core/UntranslatedText.cs"
click node_jobs "https://github.com/bbepis/xunity.autotranslator/blob/master/src/XUnity.AutoTranslator.Plugin.Core/TranslationJob.cs"
click node_cache "https://github.com/bbepis/xunity.autotranslator/blob/master/src/XUnity.AutoTranslator.Plugin.Core/TextTranslationCache.cs"
click node_endpoint "https://github.com/bbepis/xunity.autotranslator/blob/master/src/XUnity.AutoTranslator.Plugin.Core/Endpoints/ITranslateEndpoint.cs"
click node_web "https://github.com/bbepis/xunity.autotranslator/blob/master/src/XUnity.AutoTranslator.Plugin.Core/Endpoints/Http/HttpEndpoint.cs"
click node_translators "https://github.com/bbepis/xunity.autotranslator/tree/master/src/Translators"
click node_protocol "https://github.com/bbepis/xunity.autotranslator/blob/master/src/XUnity.AutoTranslator.Plugin.ExtProtocol/ProtocolMessage.cs"
click node_request "https://github.com/bbepis/xunity.autotranslator/blob/master/src/XUnity.AutoTranslator.Plugin.ExtProtocol/TranslationRequest.cs"
click node_response "https://github.com/bbepis/xunity.autotranslator/blob/master/src/XUnity.AutoTranslator.Plugin.ExtProtocol/TranslationResponse.cs"
click node_executor "https://github.com/bbepis/xunity.autotranslator/blob/master/src/Translators/Common.ExtProtocol.Executor/ExtProtocolHandler.cs"
click node_manual "https://github.com/bbepis/xunity.autotranslator/blob/master/src/XUnity.AutoTranslator.Plugin.Core/TranslationFileLoadingContext.cs"
click node_assetredirect "https://github.com/bbepis/xunity.autotranslator/tree/master/src/XUnity.ResourceRedirector"
click node_assettranslation "https://github.com/bbepis/xunity.autotranslator/tree/master/src/XUnity.AutoTranslator.Plugin.Core/AssetRedirection"
click node_texture "https://github.com/bbepis/xunity.autotranslator/blob/master/src/XUnity.AutoTranslator.Plugin.Core/TextureTranslationCache.cs"
click node_unityassets "https://github.com/bbepis/xunity.autotranslator/blob/master/src/UnityEngine/AssetBundle.cs"
click node_unityresources "https://github.com/bbepis/xunity.autotranslator/blob/master/src/UnityEngine/Resources.cs"
click node_frameworks "https://github.com/bbepis/xunity.autotranslator/blob/master/src/XUnity.AutoTranslator.Plugin.BepInEx/AutoTranslatorPlugin.cs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_plugin,node_hooks,node_parser,node_settings,node_player toneBlue
class node_autotranslator,node_translationmgr,node_endpointmgr,node_text,node_jobs,node_cache toneAmber
class node_endpoint,node_web,node_translators,node_protocol,node_request,node_response,node_executor toneMint
class node_manual,node_assetredirect,node_assettranslation,node_texture toneRose
class node_unityassets,node_unityresources,node_frameworks,node_loader toneIndigo
```

## Components

### Game Text Capture

- [Plugin Startup](https://github.com/bbepis/xunity.autotranslator/blob/master/src/XUnity.AutoTranslator.Plugin.Core/AutoTranslationPlugin.cs): `src/XUnity.AutoTranslator.Plugin.Core/AutoTranslationPlugin.cs`
- [Text Hooks](https://github.com/bbepis/xunity.autotranslator/tree/master/src/XUnity.AutoTranslator.Plugin.Core/Hooks): `src/XUnity.AutoTranslator.Plugin.Core/Hooks`
- [Text Parsing](https://github.com/bbepis/xunity.autotranslator/tree/master/src/XUnity.AutoTranslator.Plugin.Core/Parsing): `src/XUnity.AutoTranslator.Plugin.Core/Parsing`
- [Configuration](https://github.com/bbepis/xunity.autotranslator/blob/master/src/XUnity.AutoTranslator.Plugin.Core/Configuration/Settings.cs): `src/XUnity.AutoTranslator.Plugin.Core/Configuration/Settings.cs`

### Translation Runtime

- [Translation API](https://github.com/bbepis/xunity.autotranslator/blob/master/src/XUnity.AutoTranslator.Plugin.Core/AutoTranslator.cs): `src/XUnity.AutoTranslator.Plugin.Core/AutoTranslator.cs`
- [Translation Manager](https://github.com/bbepis/xunity.autotranslator/blob/master/src/XUnity.AutoTranslator.Plugin.Core/TranslationManager.cs): `src/XUnity.AutoTranslator.Plugin.Core/TranslationManager.cs`
- [Endpoint Scheduler](https://github.com/bbepis/xunity.autotranslator/blob/master/src/XUnity.AutoTranslator.Plugin.Core/Endpoints/TranslationEndpointManager.cs): `src/XUnity.AutoTranslator.Plugin.Core/Endpoints/TranslationEndpointManager.cs`
- [Untranslated Text](https://github.com/bbepis/xunity.autotranslator/blob/master/src/XUnity.AutoTranslator.Plugin.Core/UntranslatedText.cs): `src/XUnity.AutoTranslator.Plugin.Core/UntranslatedText.cs`
- [Translation Jobs](https://github.com/bbepis/xunity.autotranslator/blob/master/src/XUnity.AutoTranslator.Plugin.Core/TranslationJob.cs): `src/XUnity.AutoTranslator.Plugin.Core/TranslationJob.cs`
- [Translation Cache](https://github.com/bbepis/xunity.autotranslator/blob/master/src/XUnity.AutoTranslator.Plugin.Core/TextTranslationCache.cs): `src/XUnity.AutoTranslator.Plugin.Core/TextTranslationCache.cs`

### Translation Providers

- [Endpoint Interface](https://github.com/bbepis/xunity.autotranslator/blob/master/src/XUnity.AutoTranslator.Plugin.Core/Endpoints/ITranslateEndpoint.cs): `src/XUnity.AutoTranslator.Plugin.Core/Endpoints/ITranslateEndpoint.cs`
- [HTTP Translation](https://github.com/bbepis/xunity.autotranslator/blob/master/src/XUnity.AutoTranslator.Plugin.Core/Endpoints/Http/HttpEndpoint.cs): `src/XUnity.AutoTranslator.Plugin.Core/Endpoints/Http/HttpEndpoint.cs`
- [Service Translators](https://github.com/bbepis/xunity.autotranslator/tree/master/src/Translators): `src/Translators`
- [External Protocol](https://github.com/bbepis/xunity.autotranslator/blob/master/src/XUnity.AutoTranslator.Plugin.ExtProtocol/ProtocolMessage.cs): `src/XUnity.AutoTranslator.Plugin.ExtProtocol/ProtocolMessage.cs`
- [Translation Request](https://github.com/bbepis/xunity.autotranslator/blob/master/src/XUnity.AutoTranslator.Plugin.ExtProtocol/TranslationRequest.cs): `src/XUnity.AutoTranslator.Plugin.ExtProtocol/TranslationRequest.cs`
- [Translation Response](https://github.com/bbepis/xunity.autotranslator/blob/master/src/XUnity.AutoTranslator.Plugin.ExtProtocol/TranslationResponse.cs): `src/XUnity.AutoTranslator.Plugin.ExtProtocol/TranslationResponse.cs`
- [Protocol Executor](https://github.com/bbepis/xunity.autotranslator/blob/master/src/Translators/Common.ExtProtocol.Executor/ExtProtocolHandler.cs): `src/Translators/Common.ExtProtocol.Executor/ExtProtocolHandler.cs`

### Assets And Manual Data

- [Manual Translation Files](https://github.com/bbepis/xunity.autotranslator/blob/master/src/XUnity.AutoTranslator.Plugin.Core/TranslationFileLoadingContext.cs): `src/XUnity.AutoTranslator.Plugin.Core/TranslationFileLoadingContext.cs`
- [Asset Redirection](https://github.com/bbepis/xunity.autotranslator/tree/master/src/XUnity.ResourceRedirector): `src/XUnity.ResourceRedirector`
- [Asset Translation](https://github.com/bbepis/xunity.autotranslator/tree/master/src/XUnity.AutoTranslator.Plugin.Core/AssetRedirection): `src/XUnity.AutoTranslator.Plugin.Core/AssetRedirection`
- [Texture Translation](https://github.com/bbepis/xunity.autotranslator/blob/master/src/XUnity.AutoTranslator.Plugin.Core/TextureTranslationCache.cs): `src/XUnity.AutoTranslator.Plugin.Core/TextureTranslationCache.cs`

### Unity Compatibility

- [Unity Asset APIs](https://github.com/bbepis/xunity.autotranslator/blob/master/src/UnityEngine/AssetBundle.cs): `src/UnityEngine/AssetBundle.cs`
- [Unity Resources](https://github.com/bbepis/xunity.autotranslator/blob/master/src/UnityEngine/Resources.cs): `src/UnityEngine/Resources.cs`
- [Loader Adapters](https://github.com/bbepis/xunity.autotranslator/blob/master/src/XUnity.AutoTranslator.Plugin.BepInEx/AutoTranslatorPlugin.cs): `src/XUnity.AutoTranslator.Plugin.BepInEx/AutoTranslatorPlugin.cs`

### Other components

- **Game User**
- **Plugin Loader**

## Connections

- Plugin Loader → Plugin Startup: loads plugin (evidence: `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 (evidence: `src/XUnity.AutoTranslator.Plugin.Core/TranslationManager.cs`)
- Translation Manager → Endpoint Scheduler: registers endpoints (evidence: `src/XUnity.AutoTranslator.Plugin.Core/TranslationManager.cs`)
- Endpoint Scheduler → Translation Jobs: queues jobs (evidence: `src/XUnity.AutoTranslator.Plugin.Core/Endpoints/TranslationEndpointManager.cs`)
- Endpoint Scheduler → Untranslated Text: batches input (evidence: `src/XUnity.AutoTranslator.Plugin.Core/Endpoints/TranslationEndpointManager.cs`)
- Endpoint Scheduler → Translation Cache: stores translations
- Translation Manager → Endpoint Interface: initializes endpoint (evidence: `src/XUnity.AutoTranslator.Plugin.Core/TranslationManager.cs`)
- Endpoint Interface → HTTP Translation: uses HTTP endpoint
- Translation Manager → Service Translators: loads providers (evidence: `src/XUnity.AutoTranslator.Plugin.Core/TranslationManager.cs`)
- External Protocol → Translation Request: encodes request (evidence: `src/XUnity.AutoTranslator.Plugin.ExtProtocol/TranslationRequest.cs`)
- Protocol Executor → Translation Request: handles request (evidence: `src/Translators/Common.ExtProtocol.Executor/ExtProtocolHandler.cs`)
- Protocol Executor → Translation Response: writes response (evidence: `src/Translators/Common.ExtProtocol.Executor/ExtProtocolHandler.cs`)
- Manual Translation Files → Translation Cache: loads translations (evidence: `README.md`)
- Asset Redirection → Asset Translation: redirects loaded assets (evidence: `src/XUnity.AutoTranslator.Plugin.Core/AssetRedirection/AssetLoadedHandlerBase.cs`)
- Asset Redirection → Unity Asset APIs: intercepts asset loads (evidence: `src/XUnity.ResourceRedirector/AssetLoadedContext.cs`)
- Asset Redirection → Unity Resources: intercepts resource loads (evidence: `src/XUnity.ResourceRedirector/ResourceRedirection.cs`)
- Asset Translation → Texture Translation: supports texture translation (evidence: `README.md`)
- Game User → Text Hooks: encounters game text (evidence: `README.md`)
- Loader Adapters → Plugin Startup: integrates loader (evidence: `README.md`)
