Custom Language Patch Now Live! (PatchNote 0.4.1)

Hello Bingle Bingle players,

Today, we're releasing a patch that includes an update for the language customization feature and some minor bug fixes.

[h2]Language Customization Patch[/h2]

First, we've added French, Russian, Spanish, Korean, Japanese, and Simplified Chinese to Bingle Bingle. We've also refined the existing English translations for clearer expressions!

The added languages were prioritized based on popular demand. However, the current translations are in beta and provided as examples. Since machine translation was used, please understand if the quality is not perfect. Report any problematic text to us, and we'll strive to improve the translations.



[h3]How to Add Translation Files for Unsupported Languages[/h3]

0. Before starting, note the path for the KnittingGames folder as follows:
1) For Windows: "user/appdata/roaming"
2) For Linux: "home - *show hidden files* - .local/share"

1. Create a folder named after the language you want to add (let's call this language "Binglian") in the knittinggames/binglebingle/language directory.

2. Inside knittinggames/binglebingle/language/Binglian, create GameText.json and language.json files, and add a font file [e.g., ttf, otf].

If you create a folder with a name that exactly matches the spelling of officially supported languages in the current live version settings—English, French, Spanish, Korean, Russian, Japanese, Chinese—the embedded fonts in 'bingle bingle' will be used. Therefore, there will be no issues even if the font is not included in the language folder.
However, if you create a folder with a different name, even for the same language (e.g., japanese(0.4.1)), it will be considered a new language, and font files will be required.
So please ensure that you include font information and files if you are not using a folder name that exactly matches the in-game language name. This is essential for proper functionality.

3. Populate the language.json file with character data. (Be sure to refer to the provided link.)


{
"code": "BGN", "name": "Binglian", "huge": { (Each language file must include data for all four sizes: huge, large, medium, and small.)
"name": "Fontname.ttf", "size": 10, "xAdjust": 0, "yAdjust": 0, "widthAdjust": 0, "heightAdjust": 0 }
}

4. Next, fill in the translation contents in the GameText file. (Refer to the provided link.)



English Version
{
"code": "TokenSide.NORMAL",
"version": "0.4.1",
"name": "Normal Ball",
"shortName": "Normal Ball",
"description": "Rolls a ball.",
"activeDescription": "Rolls a ball. Its value increases by {pointColor}5{clearColor} per ability level.\n({pointColor}{levelValue}{clearColor} points)"
}

Korean Version
{
"code": "TokenSide.NORMAL",
"version": "0.4.1",
"name": "일반 볼",
"shortName": "일반 볼",
"description": "볼을 굴립니다.",
"activeDescription": "볼을 굴립니다. 능력 강화 시 가치가 {pointColor}5{clearColor} 증가합니다.\n({pointColor}{levelValue}{clearColor} 포인트)"
}

5. Run the game, change to the newly added Test version in the options, and restart Bingle Bingle.

6. All done! Now you can play Bingle Bingle in the new language!




[h3]How to Modify Already Supported Languages[/h3]

Modifying a supported language follows a similar process to adding a new translation file, but you can easily make changes by applying already translated data from the provided link. Since the font data is embedded in the game, you don’t need to add font files separately for modifications. In the language.json file, you only need to enter the language code and name. Use the translated data from the link for the GameText.json file.

*Important Notes*

*Make sure the folder name in the new path matches the language name in the language.json file*
*Ensure the version data in the GameText file matches the latest version (0.4.1 as of writing)*
*If you want to use a different font from the ones already in use, follow the method for adding a new language.*


We will provide examples of the GameText and language json files separately on the Bingle Bingle Discord channel below. Please check the link for detailed information!

https://discord.gg/XTFVWhUKGk



[h2]Bug Fixes:[/h2]

- Fixed a bug where the Trickster ability would crash when activated in the Portal Pocket.
- Fixed a bug where the Dwindling Rose Drink would not change the bet type even after being modified.
- Fixed a bug where the game would crash upon death in the tutorial.



Due to spending more time than anticipated on the language patch, the update originally scheduled for early August will need to be postponed to the late August. We kindly ask for your patience a little longer.