#author("2025-08-26T17:13:15+09:00;2025-08-21T17:53:50+09:00","default:admin","admin")
#author("2025-08-27T10:12:42+09:00;2025-08-21T17:53:50+09:00","default:admin","admin")
*Localization Toolkit [#z4064be5]

[[''&size(20){日本語ページはこちら};'':https://rpgbakin.com/pukiwiki/?Localization+Toolkit#hf7046ad]]
#contents

*Introduction: Overview of Localization Toolkit [#j5557103]
This tool is an expansion (DLC) to allow language switching during gameplay and the associated change of resources used.

''Purpose and Function of this Tool''
-''Text Localization: ''
--Supported languages can be added on the editor, and in-game text can be registered and edited.
--Duplicate texts are automatically grouped together for efficient management.
--You can also export all strings in the game to an .xlsx file and import the edited data after external translation work.

-''Resource Localization:''
--You can replace the resources used in the game, such as images and sounds, with different files depending on the language setting.

---------------------------------------------
''Supported Platforms and Prerequisites''
-RPG Developer Bakin
- Version: 2.0.0  or later
---------------------------------------------

***''How to Get Started'' [#o756588a]
- Please purchase “RPG Developer Bakin Localization Toolkit” from the Steam store.
-- [[''&size(20){Steam Store Localization Toolkit};'':https://store.steampowered.com/app/3920860/RPG_Developer_Bakin_Localization_Toolkit]]
- Please check that the download is in progress on the Steam Client.
- Launch BAKIN, and if “Localize” has been added to the master menu, it is ready to use.

** ''Overview of the Localization Workflow'' [#yf16c6db]
+Set the base language and fallback language
+Add supported languages for text localization
+Enter translation data for each supported language
+Perform test play after applying localization
+Export the game project by outputting the published build

**Basic Settings [#ub9d13dc]
***Selecting the ''Base Language'' [#fa5b2336]
Set the base language for the project. This will be the reference language for all localized text.
+ Click the box to the right of "Base Language."
+ From the displayed "Local List," select the desired language and click "OK."
- ''Note:'' If there is no text in the fallback language, the base language will be used.

---------------------------------------------
''Selecting the Fallback Language''
The ''fallback language'' is used as a substitute when a translation is missing for the player's selected language, or ''&color(red){when certain text has not been translated.};''
+ Click the box to the right of "Fallback Language."
+ Select the desired language from the dropdown menu.
---------------------------------------------

**''Adding and Removing Supported Languages'' [#s943fb36]
By adding or removing supported languages, you define which languages can be switched in-game.

-''To Add a Supported Language:''
--Click the "Add Supported Language" button.
--From the displayed "Local List," select the language you want to add and click "OK."
---''Note:'' 
---You can jump to matching entries by entering the initial letters of the locale in half-width characters using the keyboard in “Local List”.
---If you select a language that has already been added, no changes will be made.

- ''To Remove a Supported Language:''
--Click the "Remove Supported Language" button.
--From the displayed "Local List," select the language you want to remove and click "OK."
- ''&color(red){Important:};''''You cannot add or remove multiple languages at once.'' Please add or remove them one at a time.

**''Text Localization'' [#s2830479]
The text localization feature allows you to efficiently manage in-game text and implement multilingual support.

***Core Features [#mfe68e34]
-''Import/Export Data:''
--  By selecting the ''Import or Export'' button at the top of the screen, you can export the localization target text data to an Excel (.xlsx) file, or import data that has been translated or edited externally.

-''Merge Identical Text Entries:''
When the "Merge Identical Texts" checkbox is selected, identical text entries that appear in multiple places within the game will be consolidated into a single row in the list.

-''Filtering:''
By entering a keyword in the filter input field, you can narrow down the displayed text entries.

-''Sorting:''
By clicking on the header of each column in the list, you can sort the text data in ascending or descending order based on the values in that column.

***Fields [#fb8bdff9]
-''Type:''
--Display the type of the text entry.

-''Usage Location:''
--Show where the text is used within the game.

-''Base Language:''
--Display the text in the base language.
-- ''&color(red){You can modify the text shown in the base language by editing this field.};''

-''Added Languages:''
--You can enter text corresponding to the base language.

**''Import/Export Function'' [#r9ac672b]
By selecting the Import or Export button, you can export localization target text data to an Excel (.xlsx) file or import data that has been translated or edited externally.

***''Import'' [#m5e41cae]
+ Select the Excel (.xlsx) file to import from Explorer.
+ In the Local List, check the locales you want to add, then click "OK."
- ''Note:'' If additional locales were added while editing the ''Excel (.xlsx) file'', they can also be imported.

***''Export'' [#ea6cc2de]
+ Select Save in Explorer to output (export) an Excel (.xlsx) file.

** ''Resource Localization'' [#xdbbf23a]
You can replace in-game resources such as images and audio files with alternatives that correspond to the selected language.

**Localizable Resource Types [#v9d4f3b0]
BGM, sound effects (SE), environmental sounds, terrain, materials, textures, models, particles, motions, slice animations, 3D stamps, physics settings, movies, sprites, 2D stamps, images, blend shapes, and decals.

***Core Features [#p93557ca]
-''Add/Remove Resources:''
Use the Add and Remove buttons at the top of the screen to manage the resources targeted for localization.

-''Adding Base Language Resources:''
Click the Add button, select the resource type in the Asset Picker, and choose the resource to localize.
--''Note:'' You can select and add multiple resources at once, as long as they are of the same type.

-''Selecting Alternate Resources:''
For each language, you can assign an alternative resource to be used in place of the base one.
-- ''Note:'' Once added, the resource type cannot be changed. If needed, delete the entry and add the correct resource again from the base language resource selection.

*** ''Important Notes for Each Resource:'' [#l8487034]
- ''3D Stamps:''
-- Subgraphics will also be replaced.
- ''Models:''
-- If you replace the same model with one that only differs in terms of materials, the appearance will not change. Please replace the 3D stamp.
- ''Motions:''
-- The motion names must match.
- ''Blend Shapes:''
-- The clip names must match.
- ''Materials:''
-- This also affects decals placed on maps.
- ''Textures:''
-- Simply changing the textures of 3D stamps, decals, and blend shapes placed on maps will not result in any changes. You can ensure that replacements are made by replacing the stamps.
- ''Sprites:''
-- If the motion names do not match, they will not be displayed.
- ''Fonts:''
-- Special characters will be displayed as long as the font supports them, and will appear as blank spaces if not supported.
-- You can select fonts for each language.
- ''Other:''
--If the size is scaled when placing maps, the replacement resource will also be changed to the scaled size.


** ''Test Play with Localization Applied'' [#f83da1b6]
Test play allows you to actually see the language switching during gameplay and the resulting changes in resources used, as set up in the localization tool.

*** ''How to Use'' [#le001406]
+ In the Map Editor, click the "…" button next to "Test Play" in the top menu.
+ From the displayed menu, select "Test Play with Localization".
+ Choose the language you want to test. The game will launch in that language setting.
- ''&color(red){Important Note:};'' ''The project will be saved in the same way as when testing with an external player. Please keep this in mind.''

** ''Language Switching in the Exported Game'' [#radd2b27]
''&color(red){In the exported game, the initial language is automatically selected based on the Windows system language.};''
To switch languages manually, select the language you wish to change by going to the “Language Switching” menu (restart required) in the upper menu settings after starting the game. The game will restart.

Front page   Edit Diff History Attach Copy Rename Reload   New Page list Search Recent changes   Help   RSS of recent changes