setup-localization

setup-localization is a skill for Claude Code from Simone-Tarantino/godot-superpowers. It costs 70 tokens per session (2,067 once invoked), scanned A, original, MIT.

A setup guide for localization, the process of adapting a Godot 4 game for multiple languages. It covers translation files, language switching, saved language choices, and fonts for non-Latin writing systems.

In plain words
What is it for?
It is for adding translated menus and interface text, translating longer dialogue, switching languages while the game runs, remembering the selected language, and supporting scripts such as Japanese.
Why use it?
It provides a defined way to store and display translations without rebuilding language support for each project.

Skill for Claude Code

Written for Claude Code: allowed-tools in frontmatter.

Part of the godot-superpowers plugin — 33 skills, 15 agents, 4 hooks, 5 MCP servers shipped together

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/simone-tarantino/godot-superpowers/setup-localization
Any agent
npx skills add Simone-Tarantino/godot-superpowers --skill setup-localization
Clone the repo
git clone --depth 1 https://github.com/Simone-Tarantino/godot-superpowers

Made for: Claude Code.

Or install godot-superpowers, the plugin that ships this one along with the rest of its 33 skills, 15 agents, 4 hooks, 5 MCP servers.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for setup-localization

README.md
[![agentmods](https://agentmods.dev/badge/skills/simone-tarantino/godot-superpowers/setup-localization.svg)](https://agentmods.dev/skills/simone-tarantino/godot-superpowers/setup-localization)
Your own site
<a href="https://agentmods.dev/skills/simone-tarantino/godot-superpowers/setup-localization"><img src="https://agentmods.dev/badge/skills/simone-tarantino/godot-superpowers/setup-localization.svg" alt="Measured on agentmods" height="20"></a>
Per session 70 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 2,067 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00070 $0.02067
Opus 5 $0.00035 $0.01033
Sonnet 5 $0.00014 $0.00413
Haiku 4.5 $0.00007 $0.00207

Measured 6d ago against content hash 2ec6843f918f, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade A, and why

setup-localization scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 6d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/setup-localization/SKILL.md · 175 lines

How it starts

The opening of the file, as written. The whole thing — 175 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Setup Localization

Wires the full i18n pipeline in Godot 4.x: CSV-based translations (best for short UI strings), optional .po/gettext for long-form text, runtime language switcher, locale persistence in user://settings.cfg, and font fallback for scripts the default font does not cover.

Reference: Internationalizing games, Locales, Importing translations.

Decision: CSV vs gettext (.po)

Use CSV when Use .po (gettext) when
Short UI strings (menus, HUD, button labels) Long narrative / dialogue paragraphs
Translators are non-technical (work in spreadsheets) Translators use gettext-aware tooling (Poedit, Crowdin)
Project has < ~500 strings Project has many strings, plurals, contextual variants

Both can coexist: CSV for UI, .po for in-game prose / dialogue.

CSV pipeline

1. Create localization/translations.csv

keys,en,it,fr,ja
ui.menu.start,Start,Inizia,Démarrer,スタート
ui.menu.options,Options,Opzioni,Options,設定
ui.menu.quit,Quit,Esci,Quitter,終了
hud.score,Score: %d,Punteggio: %d,Score : %d,スコア: %d
dialogue.npc.greet,Hello traveler.,Salve viaggiatore.,Bonjour voyageur.,こんにちは、旅人。

Rules:

  • Column 1 header = keys. First row = column header (each cell after keys is a BCP-47 locale code).
  • Keys use namespaced dot.case (area.subarea.name) — never raw English. Switching the source language later then costs nothing.
  • Use %s, %d, %.2f placeholders for runtime substitution: tr("hud.score") % score.

2. Import the CSV

In Project → Project Settings → Localization → Translations, click Add and select localization/translations.csv. Godot generates one .translation file per language under the same folder (these are imported assets — do not edit by hand).

Read the full file on GitHub · 175 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 6d ago First seen · 175 lines · 70 tokens per session scan A 2ec6843f918f

Subscribe to this mod's changes

setup-localization is a skill published in the GitHub repository Simone-Tarantino/godot-superpowers (2 stars, last pushed 4mo ago), licensed MIT. It adds 70 tokens to every session and 2,067 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

game-build-team

Build a Godot 4 / GDScript game feature with a coordinated agent team — a Manager (you), a Creative Director, a Logic Developer, an Animation Developer, and a Tester — that iteratively and autonomously design, build, juice, and verify the feature against the project's design contract to a strict, un-skippable quality…

Varalix-Digitech-Solutions/game-build-team-skill · 248 tokens

hreflang-international

International / multilingual SEO audit focused on hreflang correctness. Detects and diagnoses the most common (and ranking-damaging) hreflang mistakes: missing or broken return tags, wrong language/region codes, missing x-default, self-referencing errors, conflicts between hreflang and canonical, and inconsistent…

nowork-studio/notfair-plugin · 242 tokens

localization

Use when implementing localization (i18n/l10n) — TranslationServer, CSV/PO translation files, locale switching, RTL support, and pluralization in Godot 4.3+.

jame581/GodotPrompter · 42 tokens

game-design-book-translator

用于翻译、润色、整理或质检英文游戏设计、游戏研发、系统设计、UX、Game Studies 与设计理论书籍、章节、PDF、OCR、Markdown、图表、图注和术语表;强调专业术语、中文可读性、图片结构与版权边界。Use for professional game-design translation and QA.

DY-2026/GameDesignOS · 81 tokens

roblox-localization

Use when implementing Roblox multi-language support, translation tables, auto-translation, locale-specific content, or region detection.

TabooHarmony/roblox-brain · 28 tokens

create-kr-patch

Use for Korean (Hangul) fan translations of retro console or PC games, including ROM or disc analysis, text-engine reverse engineering, Hangul fonts and custom encodings, script extraction and reinsertion, code hooks, reproducible product builds, and emulator verification. Apply it to new investigations and follow-up…

mcpads/create-retro-game-kr-patch · 109 tokens