[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7CMK63VYM0EYDA4H9FDW056":3,"skill-same:01M7CMK63VYM0EYDA4H9FDW056":74},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":27,"repositoryHtmlUrl":28,"repositoryHomepageUrl":6,"ownerHtmlUrl":29,"ownerBlogUrl":30,"ownerDescription":6,"updatedAt":31,"install":32,"resources":45},"01M7CMK63VYM0EYDA4H9FDW056","unity-localization",null,"Localize a Unity game: string tables, language switch, CJK fonts and tofu, TMP fallbacks, long text.","tipoLi5890\u002Funity-dev-skills","tipoLi5890","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F177803612?v=4","01M7CMD7DHGZ09CB53CRFHAA34","Li, ching yu","01M7CMD7E70K5RAHWWZVYX9YMG",2,"MIT","https:\u002F\u002Fgithub.com\u002FtipoLi5890\u002Funity-dev-skills\u002Fblob\u002Fmain\u002Fskills\u002Funity-localization\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: unity-localization\ndescription: >-\n  Localize a Unity game: string tables, language switch, CJK fonts and tofu,\n  TMP fallbacks, long text.\n---\n\n# unity-localization — the asset pipeline, and the CJK part that bites\n\n> **Adding a language is easy; adding a script is not.** Latin locales mostly work by\n> substitution. The moment a CJK locale ships, font assets, atlas modes, Addressables and\n> layout all have to be right *together* — and the failure mode is a screen of empty boxes that\n> looks like a rendering bug rather than a missing asset.\n>\n> The failures that survive review are the quiet ones: text that renders in the **wrong region's\n> glyph shapes**, a **raw key** that reads as deliberate English, a button that fits Chinese and\n> splits in Japanese. None of them tofu. None of them fail an assertion.\n\n## Symptom → where to look\n\n| Symptom | Go to |\n|---|---|\n| Adding languages, translating UI, from nothing | §1, then `reference\u002Fstring-tables.md` |\n| Boxes \u002F tofu instead of Chinese, Japanese or Korean | §2, then `reference\u002Ffont-pipeline.md` §4 |\n| Text renders fine, but one locale shows the wrong regional glyph shapes | §1 |\n| Deciding how CJK fonts should be wired at all | §1 |\n| Building font assets from a script; a NullReferenceException with no message | `reference\u002Ffont-pipeline.md` §1 |\n| The font worked, then went blank after a reimport | §3 |\n| `Failed to load sub-asset` at runtime | §3 Addressables |\n| Font assets modified in `git status` after every Editor or test run | §3, then `reference\u002Ffont-pipeline.md` §5 |\n| A raw key on screen; a key that exists in one table only | §5, then `reference\u002Fstring-tables.md` |\n| Whether the Localization package is actually usable in this project | `reference\u002Fstring-tables.md` §6.1 |\n| A `LocalizeStringEvent` is wired and the label never updates while authoring | §5, then `reference\u002Fstring-tables.md` §6.6 |\n| A script wrote table entries and the Localization window still shows the old ones | `reference\u002Fstring-tables.md` §6.4 |\n| A locale switch moves some labels and leaves others behind | `reference\u002Fstring-tables.md` §6.5 |\n| Localising an existing project: which labels and which strings the pass missed | §5, then `reference\u002Fstring-tables.md` §6.9 |\n| Which language a fresh install picks; \"follow system\" looks broken | `reference\u002Fstring-tables.md` §3 |\n| The language switch appears to do nothing | §4 |\n| A translated string overflows or clips its box | §4, then `reference\u002Fper-locale-layout.md` |\n| How big the text should be, and whether it is readable | skill `unity-game-ui` |\n\n## 1. The two standard answers for CJK contradict each other. Pick deliberately.\n\n| Approach | Argument for | Choose it when |\n|---|---|---|\n| **TMP fallback chain** (the TMP-optimisation answer) | Bounded, predictable atlas memory; one font asset stack for all languages | Memory is the binding constraint; text is mostly UI chrome; the language set is fixed and small |\n| **Per-locale font swap via Asset Table** (the Localization-package answer) | Predictable and debuggable — a missing glyph points at one locale's asset, not into a chain | Languages ship independently; you need per-language typography; a designer must be able to change one language's font without touching the others |\n\n**Write down which one the project uses**, because the debugging paths diverge completely.\nDefault when nobody has decided: **per-locale swap.** Tofu is then a one-asset question.\n\n> **A per-locale primary and a fallback chain combine fine.** A common belief is that the\n> combination gives both failure modes; it is wrong, provided you are explicit about **which layer\n> decides the language**: the per-locale primary decides regional glyph shapes, and the chain only\n> catches a glyph the primary genuinely lacks. Letting the *chain* answer \"which language is this\"\n> stays incompatible, because it silently succeeds: e.g. all 335 distinct characters of a Traditional\n> Chinese UI table can exist in Noto Sans SC, so an SC-primary build with a TC fallback shows **no\n> tofu at all** and renders every Traditional string in Simplified shapes.\n\nSo: **\"no tofu\" is not evidence the font wiring is right.** Coverage was never the question.\nCharacter-coverage numbers, the mutual-fallback registration, and the same trap in font metadata\n(a CJK font advertising `ja` is not a Japanese font) are in `reference\u002Ffont-pipeline.md` §3.\n\n## 2. CJK font assets — two flags, and they are not optional\n\n```csharp\nfontAsset.atlasPopulationMode        = AtlasPopulationMode.Dynamic;\nfontAsset.isMultiAtlasTexturesEnabled = true;\n```\n\n`AtlasPopulationMode` has `Static`, `Dynamic` and, from TMP 3.2.0-pre.3, `DynamicOS`;\n`GlyphRenderMode` has `SDF8`\u002F`SDF16`\u002F`SDF32` (SDF16: `unity-game-ui` → `reference\u002Ftext-and-cjk.md`).\nA CJK set will not fit a static atlas, and one atlas texture overflows almost immediately. Both\nflags, every time.\n\n> **Never substitute a Western font when a CJK font is missing** — Arial and Liberation Sans have\n> no CJK glyphs. If copying a system font fails, **stop and report it**; a silent fallback turns a\n> one-line failure into a visual mystery. A **null** font reference falls back to the built-in\n> Liberation Sans too: solid tofu for CJK.\n\nBefore suspecting the atlas, check the two cheapest causes: **the source font file is a Git LFS\npointer** (empty font assets, no error anywhere), and **one label built outside the factory that\nassigns the per-locale font** (one tofu box, everything else correct). Full ladder:\n`reference\u002Ffont-pipeline.md` §4.\n\nNamed system fonts are a development stopgap: **shipping one is a licensing question** (PingFang,\nHiragino and the Windows faces are not redistributable) — ship an open-licensed family and credit\nit (`reference\u002Ffont-pipeline.md` §6). Sizing numbers per script: `unity-game-ui` →\n`reference\u002Ftext-and-cjk.md`.\n\n## 3. Three ways the pipeline loses work silently\n\n> **A generated font asset's atlas and material must be stored as sub-assets or they vanish on\n> reimport.**\n\nAdd **every** texture in `fontAsset.atlasTextures` (not just `atlasTexture` — with multi-atlas on\nit is only the first) and the material with `AssetDatabase.AddObjectToAsset`, wire\n`material.mainTexture`, mark dirty, save, and confirm with `AssetDatabase.LoadAllAssetsAtPath` —\nin-memory references stay non-null whether or not anything was written. The code:\n`reference\u002Ffont-pipeline.md` §2.\n\n> **Addressables: everything an Asset Table references must be marked Addressable, and must not\n> live in `Resources\u002F`.**\n\nA `Resources\u002F` asset raises `OperationException: Failed to load sub-asset` at runtime — copy it\ninto `Assets\u002FFonts\u002F` first. A rebuilt font asset gets a new **GUID**: repoint the Asset Table and\nre-add it to Addressables, then `AddressableAssetSettings.BuildPlayerContent()`. So whatever writes\nfont references into a theme runs *after* the fonts exist, or it writes nulls.\n\n> **A dynamic atlas rewrites its own `.asset` on every Editor run, and that lands in the\n> diffable half of the repo.**\n\nEvery batch or PlayMode run that renders a new CJK glyph bakes it in — text YAML, not LFS, growing\nto megabytes. Revert the assets as a pre-commit step, or bake a static atlas; `Clear Dynamic Data\nOn Build` does **not** help (it acts at build time). Both options: `reference\u002Ffont-pipeline.md` §5.\n\n## 4. Layout survives a longer translation, or it does not\n\nGerman and Finnish run long; CJK runs short but tall. uGUI text that absorbs both: a\n`VerticalLayoutGroup` with one `ContentSizeFitter` per label (Preferred Size), wrapping on, and\n`LayoutRebuilder.ForceRebuildLayoutImmediate(parent)` after setting text in code.\n\n- **Size fixed-width controls from measured text** (`label.GetPreferredValues(text).x`), never the\n  source language; a fixed width is sized for the **longest** locale, with `NoWrap` + `Ellipsis`.\n- **A per-locale font bound at construction ignores a locale change until the UI is rebuilt** —\n  expose one \"rebuild and re-enter the current screen\" entry point.\n\nThe settings in full, worked numbers, the two-line-row remedy and the per-locale screenshot sweep:\n`reference\u002Fper-locale-layout.md`.\n\nUse the public `LocalizeStringEvent`, never reflection into the Editor-side TMP convenience\ncomponent: it is `internal` and breaks on a package upgrade with no deprecation warning. Wiring\nand read-backs: `reference\u002Fstring-tables.md` §6.6, §6.7.\n\n## 5. Keys, and the register each table is written in\n\nThree failures that no font work prevents:\n\n- **A key present in one table only renders as the raw key** — which reads as intentional English\n  debug text, not as a bug. Pin key-set parity with an EditMode test that iterates the **locale\n  list** (not a hardcoded pair) and prints the first few missing keys on each side. A `grep -c`\n  pre-flight over the table files catches the common case before Unity even starts.\n- **zh-Hans and zh-Hant are different vocabularies, not a character conversion.** Never\n  machine-convert one into the other: Traditional *wording* written in simplified characters is\n  the entry no converter can catch — every character is already correct. Same rule for any\n  per-locale text the game sends to a service.\n- **A string composed in code is invisible to every component scan.** `label.text = $\"EXP {value}\"`\n  sits on no component at edit time, so it survives the pass that declared localisation finished.\n  Grep the C# as a separate sweep: `reference\u002Fstring-tables.md` §6.9.\n\nThe test shape, the JSON table format that survives a later migration to String Tables (including\nthe `GetLocalizedString` miss contract — a documented **non-null** \"No translation found\" string),\nsystem-language detection with its three Chinese values, and the wording table:\n`reference\u002Fstring-tables.md`.\n\n**Once `com.unity.localization` is resolved**, the Editor-side half — presence checks, populating\nby `Locale.Identifier.Code`, preview versus runtime locale, the listener `AddPersistentListener`\nleaves asleep at `RuntimeOnly`, a completeness check with an `INCONCLUSIVE` state — is\n`reference\u002Fstring-tables.md` §6.\n\nTwo runnable pieces: `resources\u002FEditor\u002FL10nBatchProcessor.cs` wires `Text` and `TMP_Text` across every\nscene and returns the labels it could not match (longest key first); `resources\u002FLocalizedFontAsset.cs`\nis §1's per-locale swap. **The batch processor saves every scene it changed — report the scene list\nand the mapping, then wait for a yes.** Details: `reference\u002Fbatch-tools.md`.\n\nReport gaps rather than closing them with the source language; some are decisions —\n`reference\u002Fstring-tables.md` §6.8.\n\n## 6. Acceptance — the tofu check, and what it misses\n\nNot \"localisation added\". Per release:\n\n1. Switch to **each** locale in turn and look at the screens. **Any tofu box is a failure.**\n2. Confirm each CJK locale's table entry points at that locale's own font asset, not at another\n   region's — the check that \"no tofu\" cannot make for you (§1).\n3. Confirm `isMultiAtlasTexturesEnabled == true` on those assets.\n4. Confirm no screen shows a raw key, and that the key-parity test is green (§5).\n5. Confirm no button, chip or list row has wrapped or clipped in the longest locale (§4).\n6. Before committing: check `git status --short` for dynamic font assets the run modified (§3).\n\nAutomate 1, 4 and 5 as a screenshot sweep — set locale, rebuild, capture, restore — and **read\nthe images** (capture: `unity-debug`); assertions see neither tofu nor a two-line button.\n\n## Scope — what this skill does NOT do\n\n| Not here | Go to |\n|---|---|\n| Type size, contrast, HUD placement, per-frame text cost | `unity-game-ui` → `reference\u002Ftext-and-cjk.md` |\n| Canvas layout that must absorb a longer string | `unity-ui-ugui` §3 |\n| Whether font assets belong in LFS at all, and how fast they grow | `unity-new-project` → `reference\u002Fversion-control-setup.md` |\n| Driving the Editor to take the per-locale screenshots | `unity-debug` |\n| Producing the translations | A translator. Machine output ships as a draft, not as a release |\n| Right-to-left scripts | A different layout problem, and not covered here — say so rather than guessing |\n","# unity-localization — the asset pipeline, and the CJK part that bites\n\n> **Adding a language is easy; adding a script is not.** Latin locales mostly work by\n> substitution. The moment a CJK locale ships, font assets, atlas modes, Addressables and\n> layout all have to be right *together* — and the failure mode is a screen of empty boxes that\n> looks like a rendering bug rather than a missing asset.\n>\n> The failures that survive review are the quiet ones: text that renders in the **wrong region's\n> glyph shapes**, a **raw key** that reads as deliberate English, a button that fits Chinese and\n> splits in Japanese. None of them tofu. None of them fail an assertion.\n\n## Symptom → where to look\n\n| Symptom | Go to |\n|---|---|\n| Adding languages, translating UI, from nothing | §1, then `reference\u002Fstring-tables.md` |\n| Boxes \u002F tofu instead of Chinese, Japanese or Korean | §2, then `reference\u002Ffont-pipeline.md` §4 |\n| Text renders fine, but one locale shows the wrong regional glyph shapes | §1 |\n| Deciding how CJK fonts should be wired at all | §1 |\n| Building font assets from a script; a NullReferenceException with no message | `reference\u002Ffont-pipeline.md` §1 |\n| The font worked, then went blank after a reimport | §3 |\n| `Failed to load sub-asset` at runtime | §3 Addressables |\n| Font assets modified in `git status` after every Editor or test run | §3, then `reference\u002Ffont-pipeline.md` §5 |\n| A raw key on screen; a key that exists in one table only | §5, then `reference\u002Fstring-tables.md` |\n| Whether the Localization package is actually usable in this project | `reference\u002Fstring-tables.md` §6.1 |\n| A `LocalizeStringEvent` is wired and the label never updates while authoring | §5, then `reference\u002Fstring-tables.md` §6.6 |\n| A script wrote table entries and the Localization window still shows the old ones | `reference\u002Fstring-tables.md` §6.4 |\n| A locale switch moves some labels and leaves others behind | `reference\u002Fstring-tables.md` §6.5 |\n| Localising an existing project: which labels and which strings the pass missed | §5, then `reference\u002Fstring-tables.md` §6.9 |\n| Which language a fresh install picks; \"follow system\" looks broken | `reference\u002Fstring-tables.md` §3 |\n| The language switch appears to do nothing | §4 |\n| A translated string overflows or clips its box | §4, then `reference\u002Fper-locale-layout.md` |\n| How big the text should be, and whether it is readable | skill `unity-game-ui` |\n\n## 1. The two standard answers for CJK contradict each other. Pick deliberately.\n\n| Approach | Argument for | Choose it when |\n|---|---|---|\n| **TMP fallback chain** (the TMP-optimisation answer) | Bounded, predictable atlas memory; one font asset stack for all languages | Memory is the binding constraint; text is mostly UI chrome; the language set is fixed and small |\n| **Per-locale font swap via Asset Table** (the Localization-package answer) | Predictable and debuggable — a missing glyph points at one locale's asset, not into a chain | Languages ship independently; you need per-language typography; a designer must be able to change one language's font without touching the others |\n\n**Write down which one the project uses**, because the debugging paths diverge completely.\nDefault when nobody has decided: **per-locale swap.** Tofu is then a one-asset question.\n\n> **A per-locale primary and a fallback chain combine fine.** A common belief is that the\n> combination gives both failure modes; it is wrong, provided you are explicit about **which layer\n> decides the language**: the per-locale primary decides regional glyph shapes, and the chain only\n> catches a glyph the primary genuinely lacks. Letting the *chain* answer \"which language is this\"\n> stays incompatible, because it silently succeeds: e.g. all 335 distinct characters of a Traditional\n> Chinese UI table can exist in Noto Sans SC, so an SC-primary build with a TC fallback shows **no\n> tofu at all** and renders every Traditional string in Simplified shapes.\n\nSo: **\"no tofu\" is not evidence the font wiring is right.** Coverage was never the question.\nCharacter-coverage numbers, the mutual-fallback registration, and the same trap in font metadata\n(a CJK font advertising `ja` is not a Japanese font) are in `reference\u002Ffont-pipeline.md` §3.\n\n## 2. CJK font assets — two flags, and they are not optional\n\n```csharp\nfontAsset.atlasPopulationMode        = AtlasPopulationMode.Dynamic;\nfontAsset.isMultiAtlasTexturesEnabled = true;\n```\n\n`AtlasPopulationMode` has `Static`, `Dynamic` and, from TMP 3.2.0-pre.3, `DynamicOS`;\n`GlyphRenderMode` has `SDF8`\u002F`SDF16`\u002F`SDF32` (SDF16: `unity-game-ui` → `reference\u002Ftext-and-cjk.md`).\nA CJK set will not fit a static atlas, and one atlas texture overflows almost immediately. Both\nflags, every time.\n\n> **Never substitute a Western font when a CJK font is missing** — Arial and Liberation Sans have\n> no CJK glyphs. If copying a system font fails, **stop and report it**; a silent fallback turns a\n> one-line failure into a visual mystery. A **null** font reference falls back to the built-in\n> Liberation Sans too: solid tofu for CJK.\n\nBefore suspecting the atlas, check the two cheapest causes: **the source font file is a Git LFS\npointer** (empty font assets, no error anywhere), and **one label built outside the factory that\nassigns the per-locale font** (one tofu box, everything else correct). Full ladder:\n`reference\u002Ffont-pipeline.md` §4.\n\nNamed system fonts are a development stopgap: **shipping one is a licensing question** (PingFang,\nHiragino and the Windows faces are not redistributable) — ship an open-licensed family and credit\nit (`reference\u002Ffont-pipeline.md` §6). Sizing numbers per script: `unity-game-ui` →\n`reference\u002Ftext-and-cjk.md`.\n\n## 3. Three ways the pipeline loses work silently\n\n> **A generated font asset's atlas and material must be stored as sub-assets or they vanish on\n> reimport.**\n\nAdd **every** texture in `fontAsset.atlasTextures` (not just `atlasTexture` — with multi-atlas on\nit is only the first) and the material with `AssetDatabase.AddObjectToAsset`, wire\n`material.mainTexture`, mark dirty, save, and confirm with `AssetDatabase.LoadAllAssetsAtPath` —\nin-memory references stay non-null whether or not anything was written. The code:\n`reference\u002Ffont-pipeline.md` §2.\n\n> **Addressables: everything an Asset Table references must be marked Addressable, and must not\n> live in `Resources\u002F`.**\n\nA `Resources\u002F` asset raises `OperationException: Failed to load sub-asset` at runtime — copy it\ninto `Assets\u002FFonts\u002F` first. A rebuilt font asset gets a new **GUID**: repoint the Asset Table and\nre-add it to Addressables, then `AddressableAssetSettings.BuildPlayerContent()`. So whatever writes\nfont references into a theme runs *after* the fonts exist, or it writes nulls.\n\n> **A dynamic atlas rewrites its own `.asset` on every Editor run, and that lands in the\n> diffable half of the repo.**\n\nEvery batch or PlayMode run that renders a new CJK glyph bakes it in — text YAML, not LFS, growing\nto megabytes. Revert the assets as a pre-commit step, or bake a static atlas; `Clear Dynamic Data\nOn Build` does **not** help (it acts at build time). Both options: `reference\u002Ffont-pipeline.md` §5.\n\n## 4. Layout survives a longer translation, or it does not\n\nGerman and Finnish run long; CJK runs short but tall. uGUI text that absorbs both: a\n`VerticalLayoutGroup` with one `ContentSizeFitter` per label (Preferred Size), wrapping on, and\n`LayoutRebuilder.ForceRebuildLayoutImmediate(parent)` after setting text in code.\n\n- **Size fixed-width controls from measured text** (`label.GetPreferredValues(text).x`), never the\n  source language; a fixed width is sized for the **longest** locale, with `NoWrap` + `Ellipsis`.\n- **A per-locale font bound at construction ignores a locale change until the UI is rebuilt** —\n  expose one \"rebuild and re-enter the current screen\" entry point.\n\nThe settings in full, worked numbers, the two-line-row remedy and the per-locale screenshot sweep:\n`reference\u002Fper-locale-layout.md`.\n\nUse the public `LocalizeStringEvent`, never reflection into the Editor-side TMP convenience\ncomponent: it is `internal` and breaks on a package upgrade with no deprecation warning. Wiring\nand read-backs: `reference\u002Fstring-tables.md` §6.6, §6.7.\n\n## 5. Keys, and the register each table is written in\n\nThree failures that no font work prevents:\n\n- **A key present in one table only renders as the raw key** — which reads as intentional English\n  debug text, not as a bug. Pin key-set parity with an EditMode test that iterates the **locale\n  list** (not a hardcoded pair) and prints the first few missing keys on each side. A `grep -c`\n  pre-flight over the table files catches the common case before Unity even starts.\n- **zh-Hans and zh-Hant are different vocabularies, not a character conversion.** Never\n  machine-convert one into the other: Traditional *wording* written in simplified characters is\n  the entry no converter can catch — every character is already correct. Same rule for any\n  per-locale text the game sends to a service.\n- **A string composed in code is invisible to every component scan.** `label.text = $\"EXP {value}\"`\n  sits on no component at edit time, so it survives the pass that declared localisation finished.\n  Grep the C# as a separate sweep: `reference\u002Fstring-tables.md` §6.9.\n\nThe test shape, the JSON table format that survives a later migration to String Tables (including\nthe `GetLocalizedString` miss contract — a documented **non-null** \"No translation found\" string),\nsystem-language detection with its three Chinese values, and the wording table:\n`reference\u002Fstring-tables.md`.\n\n**Once `com.unity.localization` is resolved**, the Editor-side half — presence checks, populating\nby `Locale.Identifier.Code`, preview versus runtime locale, the listener `AddPersistentListener`\nleaves asleep at `RuntimeOnly`, a completeness check with an `INCONCLUSIVE` state — is\n`reference\u002Fstring-tables.md` §6.\n\nTwo runnable pieces: `resources\u002FEditor\u002FL10nBatchProcessor.cs` wires `Text` and `TMP_Text` across every\nscene and returns the labels it could not match (longest key first); `resources\u002FLocalizedFontAsset.cs`\nis §1's per-locale swap. **The batch processor saves every scene it changed — report the scene list\nand the mapping, then wait for a yes.** Details: `reference\u002Fbatch-tools.md`.\n\nReport gaps rather than closing them with the source language; some are decisions —\n`reference\u002Fstring-tables.md` §6.8.\n\n## 6. Acceptance — the tofu check, and what it misses\n\nNot \"localisation added\". Per release:\n\n1. Switch to **each** locale in turn and look at the screens. **Any tofu box is a failure.**\n2. Confirm each CJK locale's table entry points at that locale's own font asset, not at another\n   region's — the check that \"no tofu\" cannot make for you (§1).\n3. Confirm `isMultiAtlasTexturesEnabled == true` on those assets.\n4. Confirm no screen shows a raw key, and that the key-parity test is green (§5).\n5. Confirm no button, chip or list row has wrapped or clipped in the longest locale (§4).\n6. Before committing: check `git status --short` for dynamic font assets the run modified (§3).\n\nAutomate 1, 4 and 5 as a screenshot sweep — set locale, rebuild, capture, restore — and **read\nthe images** (capture: `unity-debug`); assertions see neither tofu nor a two-line button.\n\n## Scope — what this skill does NOT do\n\n| Not here | Go to |\n|---|---|\n| Type size, contrast, HUD placement, per-frame text cost | `unity-game-ui` → `reference\u002Ftext-and-cjk.md` |\n| Canvas layout that must absorb a longer string | `unity-ui-ugui` §3 |\n| Whether font assets belong in LFS at all, and how fast they grow | `unity-new-project` → `reference\u002Fversion-control-setup.md` |\n| Driving the Editor to take the per-locale screenshots | `unity-debug` |\n| Producing the translations | A translator. Machine output ships as a draft, not as a release |\n| Right-to-left scripts | A different layout problem, and not covered here — say so rather than guessing |\n",{"name":5,"description":7},"main","b7459aa49fb881c5abb764223674ec8f397a02b1","skills\u002Funity-localization",0,"https:\u002F\u002Fgithub.com\u002FtipoLi5890\u002Funity-dev-skills","https:\u002F\u002Fgithub.com\u002FtipoLi5890","https:\u002F\u002Ftipoli5890.github.io\u002F","2026-11-10 09:16:41",{"source":8,"skillName":5,"commands":33,"prompt":43,"zipAvailable":44},[34,37,40],{"tool":35,"command":36},"npx","npx skills add tipoLi5890\u002Funity-dev-skills --skill unity-localization",{"tool":38,"command":39},"bunx","bunx skills add tipoLi5890\u002Funity-dev-skills --skill unity-localization",{"tool":41,"command":42},"pnpm","pnpm dlx skills add tipoLi5890\u002Funity-dev-skills --skill unity-localization","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FtipoLi5890\u002Funity-dev-skills\u002Fblob\u002Fmain\u002Fskills\u002Funity-localization\u002FSKILL.md",true,[46,52,56,60,64,70],{"path":47,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":50,"sourceHtmlUrl":51},"reference\u002Fbatch-tools.md","REFERENCE","参考文档",903,"https:\u002F\u002Fgithub.com\u002FtipoLi5890\u002Funity-dev-skills\u002Fblob\u002Fmain\u002Fskills\u002Funity-localization\u002Freference\u002Fbatch-tools.md",{"path":53,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":54,"sourceHtmlUrl":55},"reference\u002Ffont-pipeline.md",14539,"https:\u002F\u002Fgithub.com\u002FtipoLi5890\u002Funity-dev-skills\u002Fblob\u002Fmain\u002Fskills\u002Funity-localization\u002Freference\u002Ffont-pipeline.md",{"path":57,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":58,"sourceHtmlUrl":59},"reference\u002Fper-locale-layout.md",5601,"https:\u002F\u002Fgithub.com\u002FtipoLi5890\u002Funity-dev-skills\u002Fblob\u002Fmain\u002Fskills\u002Funity-localization\u002Freference\u002Fper-locale-layout.md",{"path":61,"resourceType":48,"resourceTypeDesc":49,"sizeBytes":62,"sourceHtmlUrl":63},"reference\u002Fstring-tables.md",20622,"https:\u002F\u002Fgithub.com\u002FtipoLi5890\u002Funity-dev-skills\u002Fblob\u002Fmain\u002Fskills\u002Funity-localization\u002Freference\u002Fstring-tables.md",{"path":65,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":68,"sourceHtmlUrl":69},"resources\u002FEditor\u002FL10nBatchProcessor.cs","OTHER","其他",7653,"https:\u002F\u002Fgithub.com\u002FtipoLi5890\u002Funity-dev-skills\u002Fblob\u002Fmain\u002Fskills\u002Funity-localization\u002Fresources\u002FEditor\u002FL10nBatchProcessor.cs",{"path":71,"resourceType":66,"resourceTypeDesc":67,"sizeBytes":72,"sourceHtmlUrl":73},"resources\u002FLocalizedFontAsset.cs",1400,"https:\u002F\u002Fgithub.com\u002FtipoLi5890\u002Funity-dev-skills\u002Fblob\u002Fmain\u002Fskills\u002Funity-localization\u002Fresources\u002FLocalizedFontAsset.cs",[75,82,89,96,103,110],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":19},"01M7CMNYXQNW14ST64EYEEZ5V5","unity-web-release","Ship a WebGL\u002FWebGPU build: shrink the download, Brotli server headers, Safari and iPhone memory.","https:\u002F\u002Fgithub.com\u002FtipoLi5890\u002Funity-dev-skills\u002Fblob\u002Fmain\u002Fskills\u002Funity-web-release\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":19},"01M7CMNTHD1EA70CCJ2F9FN3HT","unity-vivox","Vivox voice and text chat: channels, positional voice, mute and push-to-talk, mic permission.","https:\u002F\u002Fgithub.com\u002FtipoLi5890\u002Funity-dev-skills\u002Fblob\u002Fmain\u002Fskills\u002Funity-vivox\u002FSKILL.md",[],[],{"skillNo":90,"name":91,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":93,"categories":94,"keywords":95,"publishedAt":19},"01M7CMNPHPRQZ7K1FES2953DRQ","unity-urp-migration","Migrate a Built-in project to URP, or fix a half-moved one: pink materials, PPv2, old shaders.","https:\u002F\u002Fgithub.com\u002FtipoLi5890\u002Funity-dev-skills\u002Fblob\u002Fmain\u002Fskills\u002Funity-urp-migration\u002FSKILL.md",[],[],{"skillNo":97,"name":98,"nameZh":6,"description":99,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":100,"categories":101,"keywords":102,"publishedAt":19},"01M7CMNJ756DK4V0D50HMAZYQW","unity-ui-ugui","Canvas UI (uGUI): CanvasScaler, RectTransform anchors, Layout Groups, ScrollView, UI built from C#.","https:\u002F\u002Fgithub.com\u002FtipoLi5890\u002Funity-dev-skills\u002Fblob\u002Fmain\u002Fskills\u002Funity-ui-ugui\u002FSKILL.md",[],[],{"skillNo":104,"name":105,"nameZh":6,"description":106,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":107,"categories":108,"keywords":109,"publishedAt":19},"01M7CMNDESZN79EK5FRDXCA2WA","unity-ui-toolkit","UI Toolkit (UXML, USS, UIDocument): flex layout, binding, custom elements, editor windows.","https:\u002F\u002Fgithub.com\u002FtipoLi5890\u002Funity-dev-skills\u002Fblob\u002Fmain\u002Fskills\u002Funity-ui-toolkit\u002FSKILL.md",[],[],{"skillNo":111,"name":112,"nameZh":6,"description":113,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":114,"categories":115,"keywords":116,"publishedAt":19},"01M7CMN8GBV07K0YCY07BJ6A1W","unity-ugs","Unity Gaming Services API: which package, init and sign-in order, Cloud Save, Cloud Code, Remote Config.","https:\u002F\u002Fgithub.com\u002FtipoLi5890\u002Funity-dev-skills\u002Fblob\u002Fmain\u002Fskills\u002Funity-ugs\u002FSKILL.md",[],[]]