LC Chinese Project
Version: 3.0.0
中文说明
LC Chinese Project 是面向 Lethal Company V81 测试环境维护的简体中文本地化模组。项目提供运行时文本汉化、中文 TextMeshPro 字体 fallback、部分 UI 贴图本地化、动态文本后处理，以及常见 UI 与图标类模组的兼容处理。
本项目不依赖既有第三方汉化或字体修补运行时。文本、字体、贴图与兼容逻辑均由本插件独立处理。
功能范围
- 汉化游戏内 UI、HUD、终端、商店、扫描提示、飞船显示屏、星球信息、结算界面、大厅提示和部分场景文本。
- 覆盖终端订单、星球天气、扫描价值、聊天系统消息、投票、剩余天数、重量单位、服装切换提示、载具交互提示和观战状态等动态文本。
- 优化主菜单、房间创建、加入游戏、游戏设置、控制器绑定、退出确认和大厅状态弹窗等界面的中文显示。
- 提供中文 TextMeshPro fallback，降低缺字、透明字、黑色字、裁切和动态文本渲染异常。
- 包含自制本地化文本与本地化 UI 贴图资源。
- 兼容 RuntimeIcons、RuntimeIcons_BetterRotations 和 HoneeItemIcons，保留原版英文物品 key 供图标匹配使用，仅在显示层处理中文。
- 支持自定义本地化与可选自动翻译。自动翻译默认关闭，开启后通过异步请求和本地缓存处理非原版英文文本。
安装
使用 Thunderstore 或 r2modman 安装时，请先安装 BepInExPack，再安装本模组。
手动安装时，将发布包根目录中的 BepInEx 文件夹合并到游戏或 profile 根目录。正确安装后应存在：
BepInEx/plugins/V81TestChn/V81TestChn.dll
BepInEx/plugins/V81TestChn/translations-clean/
BepInEx/plugins/V81TestChn/fonts/
BepInEx/plugins/V81TestChn/textures/
不要把整个包解压成 BepInEx/plugins/package，也不要在压缩包外额外套一层 package/ 目录。
自定义本地化
推荐将个人规则或其他英文模组的补充规则放在：
BepInEx/config/V81TestChn/custom-localization/
插件也会读取：
BepInEx/plugins/V81TestChn/custom-localization/
BepInEx/config/V81TestChn/custom-translations/
规则示例：
exact:Company Cruiser=公司巡航车
ignorecase:Pull switch=拉动开关
regex:^(\d+) lb$=$1 磅
style:exact:WARNING|color=#FF4D4D|fontSize=28|richText=true
常用配置：
[01 基础 - 自定义本地化]
Enabled = true
PreferCustomTranslations = false
EnableRegex = false
MaxLoadedFiles = 32
MaxConfigFileBytes = 262144
MaxExactRules = 4096
MaxIgnoreCaseRules = 4096
MaxRegexRules = 64
MaxStyleRules = 64
建议优先使用 exact 或 ignore-case 规则。regex 默认关闭，只在确认规则可靠且性能可控时启用。
自动翻译
自动翻译用于补充非原版英文文本，默认关闭，不影响常规游戏性能。开启后，插件只在未命中已知词条、文本长度与并发数量均满足限制时，向配置的 HTTP provider 发起后台请求。
[02 Performance - Automatic Translation]
EnableAutomaticTranslation = false
ProviderEndpoint =
ProviderTimeoutMilliseconds = 2500
MaxTextLength = 300
MaxCacheEntries = 2000
MaxPendingRequests = 32
LogAutomaticTranslation = false
HTTP provider 接收 JSON：{ text, source, target }。返回值可以是纯文本，也可以是包含翻译字段的 JSON。主线程文本钩子不会等待 provider 响应；可用结果会写入本地缓存并在后续显示中使用。
排查
- 如果日志显示
TranslationService loaded 0 exact + 0 regex entries from 0 source(s).，通常说明插件 DLL 已加载，但 translations-clean 资源目录未被找到。
- 如果输入文本被错误翻译，请优先检查终端输入、聊天输入、玩家名和大厅动态文本保护逻辑。
- 如果图标类模组依赖原版英文物品名，本模组会尽量保留图标匹配 key，只在显示层翻译中文。
- 如果自定义本地化规则导致卡顿，请先禁用 regex，再逐步缩小规则范围。
- 如果自动翻译 provider 不可用，插件会保留原文并跳过本次结果，不会阻塞 UI。
许可与致谢
本项目以 MIT 协议发布，并分发基于 OFL 字体生成的 TextMeshPro 字体资源。详细归属与分发说明见 THIRD_PARTY_LICENSES.md。
English
LC Chinese Project is a Simplified Chinese localization mod maintained for the Lethal Company V81 test environment. It provides runtime text localization, Chinese TextMeshPro fallback, selected localized UI textures, dynamic text post-processing, and compatibility handling for common UI and icon-related mods.
This project does not require existing third-party translation or font-patching runtimes. Text, font, texture, and compatibility logic are handled by this plugin.
Scope
- Localizes in-game UI, HUD, terminal pages, store pages, scan prompts, ship monitor text, planet information, endgame screens, lobby warnings, and selected scene text.
- Covers dynamic text such as terminal orders, planet weather, scanner values, chat system messages, votes, days left, weight units, suit-change prompts, vehicle prompts, and spectate status.
- Improves Chinese display for the main menu, lobby creation, game joining, settings, controller binding, leave-game confirmation, and lobby status popups.
- Provides Chinese TextMeshPro fallback to reduce missing glyphs, transparent glyphs, black glyphs, clipping, and dynamic text rendering issues.
- Includes self-authored localization text and selected localized UI texture resources.
- Keeps RuntimeIcons, RuntimeIcons_BetterRotations, and HoneeItemIcons compatible by preserving vanilla English item keys for icon matching while translating display text separately.
- Supports custom localization and optional automatic translation. Automatic translation is disabled by default and uses asynchronous requests plus a local cache for non-vanilla English text.
Installation
When using Thunderstore or r2modman, install BepInExPack first, then install this mod.
For manual installation, merge the package BepInEx folder into the game or profile root. A correct install contains:
BepInEx/plugins/V81TestChn/V81TestChn.dll
BepInEx/plugins/V81TestChn/translations-clean/
BepInEx/plugins/V81TestChn/fonts/
BepInEx/plugins/V81TestChn/textures/
Do not install the package as BepInEx/plugins/package, and do not create a zip with an extra top-level package/ directory.
Custom Localization
The recommended directory for personal rules and additional English-mod rules is:
BepInEx/config/V81TestChn/custom-localization/
The plugin also reads:
BepInEx/plugins/V81TestChn/custom-localization/
BepInEx/config/V81TestChn/custom-translations/
Example:
exact:Company Cruiser=公司巡航车
ignorecase:Pull switch=拉动开关
regex:^(\d+) lb$=$1 磅
style:exact:WARNING|color=#FF4D4D|fontSize=28|richText=true
Prefer exact or ignore-case rules. Regex is disabled by default and should only be enabled for verified, bounded rules.
Automatic Translation
Automatic translation is intended for non-vanilla English text. It is disabled by default and does not affect normal runtime performance. When enabled, the plugin queues background HTTP provider requests only after known translations miss and length/concurrency limits pass.
[02 Performance - Automatic Translation]
EnableAutomaticTranslation = false
ProviderEndpoint =
ProviderTimeoutMilliseconds = 2500
MaxTextLength = 300
MaxCacheEntries = 2000
MaxPendingRequests = 32
LogAutomaticTranslation = false
The HTTP provider receives JSON: { text, source, target }. It may return plain text or JSON containing a translation field. Main-thread text hooks never wait for provider responses; usable results are cached locally and used on later displays.
Troubleshooting
- If the log shows
TranslationService loaded 0 exact + 0 regex entries from 0 source(s)., the plugin DLL loaded but the translations-clean resource directory was not found.
- If input text is translated incorrectly, check terminal input, chat input, player names, and lobby dynamic text protection first.
- If an icon mod depends on vanilla English item names, this mod preserves icon-matching keys where possible and translates display text separately.
- If custom localization rules cause stutter, disable regex first and reduce rule scope.
- If the automatic translation provider is unavailable, the plugin keeps the original text and skips that result without blocking UI.
License
This project is released under the MIT license and distributes TextMeshPro font resources generated from OFL-licensed font material. See THIRD_PARTY_LICENSES.md for attribution and redistribution notes.
