Agent skill

Unreal Plugin Localization

by Italink in Italink/UnrealClientProtocol

翻译 UE 插件本地化 PO 文件。当用户要求本地化、翻译或国际化 Unreal Engine 插件时使用. An agent skill from Italink/UnrealClientProtocol.

MITAuto-check passedGame Development

Install Unreal Plugin Localization

skills CLI
$ npx skills add Italink/UnrealClientProtocol --skill unreal-plugin-localization -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Italink/UnrealClientProtocol unreal-plugin-localization --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Italink/UnrealClientProtocol.git skills-src && mkdir -p .claude/skills && cp -r skills-src/Skills/unreal-plugin-localization .claude/skills/unreal-plugin-localization && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
unreal-plugin-localization
GitHub stars
127
Token cost
~939 tokens
SKILL.md length
223 words
Files
2 (incl. scripts)
Skills in repo
24
Repo updated
First seen
Licence
MIT

At a glance

翻译 UE 插件本地化 PO 文件。当用户要求本地化、翻译或国际化 Unreal Engine 插件时使用. An agent skill from Italink/UnrealClientProtocol.

  • Works in 2 steps: 翻译每个 src 值,遵循下方翻译规范。 → 在 pending 文件同目录下写入 translated.json
  • Tasks that involve Game development
  • SKILL.md covers 脚本路径, 工作流, 完整示例 and 补充说明
  • Runs Python scripts from its folder; calls python

What it does

Unreal Plugin Localization is an agent skill from Italink/UnrealClientProtocol. 翻译 UE 插件本地化 PO 文件。当用户要求本地化、翻译或国际化 Unreal Engine 插件时使用。 处理 GatherText 采集、PO 导出、AI 翻译、PO 导入和 locres 编译的完整流程。

Its SKILL.md is about 940 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/ue_localization.py`).

It sits in Game Development, covering Game development and Internationalization. It works with Unreal Engine. The repository describes itself as: Lightweight UE5 plugin that exposes Unreal Engine's reflection system over TCP+JSON — let AI agents call UFunctions, read/write UProperties, and inspect any UObject in a running… The licence is MIT.

When your agent uses it

  • Tasks that involve Game development
  • Tasks that involve Internationalization

Example prompts

  • “/unreal-plugin-localization”

Requirements

  • Python 3

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. 翻译每个 src 值,遵循下方翻译规范。
  2. 在 pending 文件同目录下写入 translated.json

What it can do on your machine

Read from SKILL.md and the folder at commit 7f0a56e. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Unreal Plugin Localization loads about 939 tokens when it runs. Until then it costs about 33 tokens; SKILL.md has 223 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~33
When it runs · the whole SKILL.md, loaded when a task matches
~939

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from Italink/UnrealClientProtocol at commit 7f0a56e, republished under its MIT licence (© Italink). 223 words, ~939 tokens.

Download SKILL.mdSave it as .claude/skills/unreal-plugin-localization/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
unreal-plugin-localization
description
翻译 UE 插件本地化 PO 文件。当用户要求本地化、翻译或国际化 Unreal Engine 插件时使用。 处理 GatherText 采集、PO 导出、AI 翻译、PO 导入和 locres 编译的完整流程。

插件本地化

将 Unreal Engine 插件的编辑器 UI 文本翻译为目标语言。工作流使用 Python 辅助脚本完成所有重活(PO 解析、commandlet 调用),Agent 只负责翻译精简 JSON。

脚本路径

读取本 SKILL.md 时你已知其绝对路径,将文件名替换为 scripts/ue_localization.py 即为脚本路径。不要搜索或 glob 查找。

工作流

用户提供 .uplugin 路径和目标语言。在执行之前,先询问用户是否启用「语境增强模式」:

是否启用语境增强模式?该模式会扫描插件源码和蓝图资产,为每个待翻译条目附加代码上下文(所在文件、行号、周围注释、蓝图变量/函数的 DisplayName 和 Tooltip),帮助产出更准确的翻译。启用后需要更多时间和Token。

用户确认后,按以下三个阶段依次执行。

阶段 1 — 采集与导出

运行 gather 子命令。脚本自动从 .uplugin 向上查找 .uproject,通过 EngineAssociation + Windows 注册表推断引擎路径,确保 .uplugin 中存在 LocalizationTargets,然后一次 commandlet 调用完成采集 + 导出 PO,最后将可翻译条目提取为精简 JSON。

powershell
# 标准模式
python "<脚本路径>" gather --uplugin "<路径>.uplugin" --cultures zh-Hans

# 语境增强模式(加 --context)
python "<脚本路径>" gather --uplugin "<路径>.uplugin" --cultures zh-Hans --context

用户选择启用语境增强模式时,加上 --context 标志。

脚本通过 stdout 输出 JSON 结果:

  • status: "ok" 或 "error"
  • pending_files: pending_translation.json 路径列表(每个目标语言一个)
  • context_enhanced: (仅语境增强模式)true
  • context_entries: (仅语境增强模式)成功提取到上下文的条目总数(C++ + 蓝图)
  • context_blueprint_entries: (仅语境增强模式且 UCP 可用)从蓝图资产中提取到上下文的条目数量

脚本支持增量翻译:PO 文件中已有 msgstr(非空翻译)的条目不会出现在 pending 列表中,同时已有翻译会保存到同目录的 existing_translations.json。因此 pending_translation.json 中的 total 可能为 0(表示无需翻译)。

阶段 2 — 翻译

先检查 pending_translation.json 的 total 字段:

  • 若 total 为 0,跳过该文件的翻译,直接进入阶段 3
  • 若 total > 0,对每个条目执行翻译

对每个需要翻译的 pending_translation.json:

  1. 读取该文件,内容为精简条目数组:
json
{
  "source_lang": "en",
  "target_lang": "zh-Hans",
  "total": 42,
  "entries": [
    {"id": 0, "ctx": "Namespace.Key", "src": "Static Mesh"},
    {"id": 1, "ctx": "Namespace.Key2", "src": "Check resource usage",
     "hint": "[Utils/MeshValidator.cpp:45] | Validates static mesh LOD count"}
  ]
}

若启用了语境增强模式,部分条目会包含 hint 字段。hint 来源有两种:

  • C++ 源码:格式为 [文件:行号] | 周围注释/代码摘要
  • 蓝图资产(需 UCP 可用):格式为 [BP_MyActor.Variable:Health] | ToolTip: Current health points

翻译时务必参考 hint 来判断术语在具体场景中的含义,从而选用更恰当的译法。例如同一个 "Instance" 在不同上下文中可能译为 "实例"(对象实例)或 "副本"(场景实例化)。

  1. 翻译每个 src 值,遵循下方翻译规范。

  2. 在 pending 文件同目录下写入 translated.json:

json
{
  "translations": [
    {"id": 0, "dst": "静态网格体"},
    {"id": 1, "dst": "检查资源使用情况"}
  ]
}

pending 文件中的每个 id 都必须出现在输出中,不可遗漏。

翻译规范
  • 保留 UE 专有名词不翻译:Actor、Blueprint、Widget、Texture2D、StaticMesh、SkeletalMesh、Material、Level、World、HLOD、LOD、Nanite、Lumen、Niagara、PCG 等
  • 保留格式占位符原样:{0}、{1}、{Arg}、%s、%d 等
  • 保留文件路径、资产路径、类名原样
  • 使用 UE 中文编辑器标准术语(如 "Static Mesh" -> "静态网格体")
  • 简洁 — UI 标签应尽量简短
  • 若 src 为空,dst 也设为空字符串
阶段 3 — 注入与编译

运行 compile 子命令。脚本自动合并 existing_translations.json(已有翻译)和 translated.json(新翻译),新翻译优先覆盖已有翻译,然后将合并结果写回 PO 文件的 msgstr 字段,最后一次 commandlet 调用完成导入 + 编译 .locres。

powershell
python "<脚本路径>" compile --uplugin "<路径>.uplugin" --cultures zh-Hans

脚本通过 stdout 输出 JSON 结果,包含 status 和详情。

完整示例

powershell
# 阶段 1:采集源文本并导出 PO(语境增强模式加 --context)
python "<脚本路径>" gather --uplugin "C:/Project/Plugins/MyPlugin/MyPlugin.uplugin" --cultures zh-Hans --context

# 阶段 2:Agent 读取 pending_translation.json(含 hint 字段),参考上下文翻译后写入 translated.json

# 阶段 3:注入翻译并编译 locres
python "<脚本路径>" compile --uplugin "C:/Project/Plugins/MyPlugin/MyPlugin.uplugin" --cultures zh-Hans

补充说明

  • 脚本从 .uplugin 目录向上遍历自动查找 .uproject
  • 引擎路径通过 .uproject 的 EngineAssociation 经 Windows 注册表解析
  • 可指定多个目标语言:--cultures zh-Hans ja ko
  • 源语言默认为 en,可通过 --native en 覆盖
  • INI 配置由脚本内置模板生成,无需外部模板目录
  • 标准模式独立运行,不依赖 UCP 或其他 Unreal Skill
  • 语境增强模式(--context)会额外通过 UCP 读取蓝图资产中的变量/函数 DisplayName 和 Tooltip;UCP 不可用时自动跳过蓝图扫描,仅使用 C++ 上下文

© Italink, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (scripts) in Skills/unreal-plugin-localization of Italink/UnrealClientProtocol.

  • SKILL.md
  • scripts/ue_localization.py

Open the folder on GitHubat commit 7f0a56e

Compare with similar skills

Unreal Plugin Localization next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Unreal Plugin Localization compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Unreal Plugin Localization this skillItalink/UnrealClientProtocol127—~939Automated safety check: PassMIT
Unreal BridgeTornLux/UnrealBridge305—~8.4kAutomated safety check: NotesMIT
Unreal Blueprint Authoringflopperam/unreal-engine-mcp1.1k—~1.6kAutomated safety check: PassNone
UMG Material MCPwinyunq/UnrealMotionGraphicsMCP210—~913Automated safety check: PassMIT
Unreal Animation Bone Editorkevinpbuckley/VibeUE726—~1.3kAutomated safety check: PassMIT
Unreal Engine MCPEpicGames/unreal-engine-skills-for-claude-code-plugin332—~1.8kAutomated safety check: PassMIT

Similar skills

  • Unreal Bridge

    TornLux/UnrealBridge

    Execute Python scripts inside a running Unreal Engine 5.3+ editor via TCP bridge.

    305 GitHub stars~8.4k tokensUpdated 8 days ago
    Game DevelopmentAuto-check: notes
  • Unreal Blueprint Authoring

    flopperam/unreal-engine-mcp

    Walks an agent through creating and editing Unreal Engine Blueprints with the Flopperam MCP's bp_* tools, from inspection to commit and verification.

    1.1k GitHub stars~1.6k tokensUpdated 3 mo ago
    Game DevelopmentAuto-check passed
  • UMG Material MCP

    winyunq/UnrealMotionGraphicsMCP

    Creates, edits and compiles Unreal Engine 5.8 material assets as one HLSL Custom node through the UMG MCP bridge, instead of editing .uasset files directly.

    210 GitHub stars~913 tokensUpdated 2 mo ago
    Game DevelopmentAuto-check passed
  • Unreal Animation Bone Editor

    kevinpbuckley/VibeUE

    Previews, validates and bakes bone-rotation edits on Unreal Engine AnimSequences, enforcing a coordinate space and a constraint-checked preview-validate-bake loop.

    726 GitHub stars~1.3k tokensUpdated 2 days ago
    Game DevelopmentAuto-check passed
  • Unreal Engine MCP

    EpicGames/unreal-engine-skills-for-claude-code-plugin

    Drives a live Unreal Editor through the unreal-mcp server: spawn actors, edit Blueprints, materials and sequences, change properties and trigger Live Coding.

    332 GitHub stars~1.8k tokensUpdated 22 days ago
    Game DevelopmentAuto-check passed
  • Unreal Scene Building

    flopperam/unreal-engine-mcp

    Guides scene and world building in Unreal Engine through the Flopperam MCP: placing actors, sculpting landscapes, scattering foliage, editing materials and verifying the level.

    1.1k GitHub stars~1.4k tokensUpdated 3 mo ago
    Game DevelopmentAuto-check passed

More from Italink/UnrealClientProtocol

All 24 skills in this repo
  • Unreal Client Protocol

    Italink/UnrealClientProtocol

    Interact with the running Unreal Engine editor via TCP bridge.

    127 GitHub stars~1.7k tokensUpdated 1 mo ago
    Auto-check passed
  • Unreal Actor Editing

    Italink/UnrealClientProtocol

    Manage actors in UE levels via UCP. An agent skill from Italink/UnrealClientProtocol.

    127 GitHub stars~3.4k tokensUpdated 1 mo ago
    Auto-check passed
  • Unreal Asset Operation

    Italink/UnrealClientProtocol

    Query and manage UE assets via UCP. An agent skill from Italink/UnrealClientProtocol.

    127 GitHub stars~4.4k tokensUpdated 1 mo ago
    Auto-check passed
  • Unreal Blueprint Editing

    Italink/UnrealClientProtocol

    Edit UE Blueprint node graphs via text (ReadGraph/WriteGraph).

    127 GitHub stars~1.7k tokensUpdated 1 mo ago
    Auto-check passed
  • Unreal Large Blueprint Analysis

    Italink/UnrealClientProtocol

    Systematically analyze and translate large UE Blueprints (10+ functions) into C++ or other targets.

    127 GitHub stars~2.6k tokensUpdated 1 mo ago
    Auto-check passed
  • Unreal Live Coding

    Italink/UnrealClientProtocol

    Trigger Live Coding compilation via UCP. An agent skill from Italink/UnrealClientProtocol.

    127 GitHub stars~1k tokensUpdated 1 mo ago
    Auto-check passed

Works with

Questions about Unreal Plugin Localization

What does Unreal Plugin Localization do?

翻译 UE 插件本地化 PO 文件。当用户要求本地化、翻译或国际化 Unreal Engine 插件时使用. An agent skill from Italink/UnrealClientProtocol. Unreal Plugin Localization is an agent skill from Italink/UnrealClientProtocol.

When should I use Unreal Plugin Localization?

Unreal Plugin Localization fits situations like: tasks that involve Game development; tasks that involve Internationalization.

How do I install Unreal Plugin Localization in Claude Code?

Run `npx skills add Italink/UnrealClientProtocol --skill unreal-plugin-localization -a claude-code`. Or copy the skill folder (Skills/unreal-plugin-localization in Italink/UnrealClientProtocol) into .claude/skills/unreal-plugin-localization in your project. Claude Code loads it when a task matches its description.

How do I install Unreal Plugin Localization in Codex?

Run `npx skills add Italink/UnrealClientProtocol --skill unreal-plugin-localization -a codex`. Or copy the skill folder (Skills/unreal-plugin-localization in Italink/UnrealClientProtocol) into .agents/skills/unreal-plugin-localization in your project. Codex loads it when a task matches its description.

Can I use Unreal Plugin Localization in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Italink/UnrealClientProtocol --skill unreal-plugin-localization -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/unreal-plugin-localization, .gemini/skills/unreal-plugin-localization, .github/skills/unreal-plugin-localization and .opencode/skills/unreal-plugin-localization in your project.

What does Unreal Plugin Localization need to run?

Going by SKILL.md and its folder, Unreal Plugin Localization needs Python for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Unreal Plugin Localization access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Unreal Plugin Localization safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Unreal Plugin Localization use?

Unreal Plugin Localization is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Unreal Plugin Localization use?

About 939 tokens (SKILL.md is roughly 3.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Unreal Plugin Localization?

Skills that share tags, products or a category with Unreal Plugin Localization: Unreal Bridge (TornLux/UnrealBridge, 305 stars), Unreal Blueprint Authoring (flopperam/unreal-engine-mcp, 1.1k stars), UMG Material MCP (winyunq/UnrealMotionGraphicsMCP, 210 stars) and Unreal Animation Bone Editor (kevinpbuckley/VibeUE, 726 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Unreal Plugin Localization?

Italink (a GitHub user) maintains it in Italink/UnrealClientProtocol, which has 127 GitHub stars. The repository holds 24 skills in this directory. The repository was last updated on August 28, 2026.

Source: Italink/UnrealClientProtocol on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.