How do I register language files in Foundry VTT?

Language files must be declared in the 'languages' array within your module.json or system.json manifest file, specifying the ISO language code, display name, and file path.

How do I handle plurals in Foundry VTT localization?

Foundry does not have a native pluralization engine. The best practice is to define separate keys (e.g., KeyOne and KeyMany) and use logic to select the appropriate key based on count.

What is the difference between localize() and format()?

game.i18n.localize() is used for simple static string lookups, while game.i18n.format() is used when you need to inject variables into a string using placeholders like {name}.

Why should I namespace my localization keys?

Namespacing (e.g., MYMODULE.Title) prevents conflicts with other modules or the Foundry core software, ensuring your translations are loaded and displayed correctly.

Can I use localization directly in Handlebars templates?

Yes, you can use the {{localize 'KEY'}} helper for simple strings or {{localize 'KEY' var=value}} for strings requiring data interpolation.

Foundry VTT Localization

Name: Foundry VTT Localization
Author: ImproperSubset

byImproperSubset

게임 개발

Streamlines the implementation of internationalization and localization for Foundry VTT modules and systems using standardized API patterns.

소개

The Foundry VTT Localization skill provides expert guidance for implementing internationalization (i18n) within the Foundry Virtual Tabletop ecosystem. It assists developers in creating structured JSON language files, utilizing the game.i18n JavaScript API for string lookups and interpolation, and applying Handlebars helpers for template-based localization. By following these established patterns, developers can ensure their modules are translation-ready, avoid common pitfalls like hardcoded strings, and maintain consistent naming conventions across complex system architectures.

주요 기능

Namespacing best practices to prevent module and system conflicts
JSON language file structure and manifest registration patterns
0 GitHub stars
JavaScript API guidance for game.i18n.localize and game.i18n.format
Manual pluralization and locale-aware list formatting techniques
Handlebars template helper implementation for dynamic UI text

사용 사례

Refactoring existing hardcoded UI strings into a maintainable localization architecture
Preparing a Foundry VTT module for global distribution and community translation
Implementing complex string interpolation for dynamic game mechanics and chat messages

소개

주요 기능

Namespacing best practices to prevent module and system conflicts
JSON language file structure and manifest registration patterns
0 GitHub stars
JavaScript API guidance for game.i18n.localize and game.i18n.format
Manual pluralization and locale-aware list formatting techniques
Handlebars template helper implementation for dynamic UI text

사용 사례

Refactoring existing hardcoded UI strings into a maintainable localization architecture
Preparing a Foundry VTT module for global distribution and community translation
Implementing complex string interpolation for dynamic game mechanics and chat messages