Localization, Voice Over, and Character Modding Documentation

Steam Build ver. 1.61++ (Ep. 1) / 1.22++ (Ep. 2)

1. MANUAL MODDING INSTRUCTION

There are 2 ways of modding: Manually and through Workshop. This section focuses on manual modding guidelines, where you manually prepare the mod folders, set up config files (json), and the contents. This will help you to have an understanding of the basic/default structure of the mod folders and setting up the configuration files that manage the mods. You are required to manually copy the mod folders to a specific mod path of the game’s Steam app folder.

Game App Install Location

The modding files must be placed inside Coffee Talk’s installation folder directory, here represented as “%APP INSTALL LOCATION%”. If you are using Steam, this usually means something like this C:\Steam\steamapps\common\Coffee Talk Episode 2 Hibiscus & Butterfly (Windows).

Mod Folder Structure

The structure of folders used for modding must follow the rule (shown as image below) so that the game can properly read and load the mod package into the game.

{mod_package_name}

This is the main folder of your mod package. It can be named anything as you please, e.g. Complete African Languages Set or Gala Special Voice Pack. Under this folder are 3 default folders, Characters, Localization and VO. Your mod package may include three, or one of them, depending on your mod contents.

• You can have multiple active mods with different contents.
• We provide a zipped mod folder that you can use as the default mod folder structure template for preparing the mod package.
  • https://drive.google.com/file/d/1zfrUKNZaYGVDIY0E5YX6qv9K2eGh6OpV/view?usp=sharing

1.1 Characters Mod

Characters Mod folder location:

Windows: %APP INSTALL LOCATION%\CTHB_Data\Mods\{mod_package_name}\Characters

Mac: %APP INSTALL LOCATION%\CTHB.app\Contents\Resources\Data\Mods{mod_package_name}\Characters

Note: For Coffee Talk, go to \CoffeeTalk_Data\ (Windows) or \CoffeeTalk(dot)app\ (Mac).

• Characters Mod folders

  Folder “Characters” contains default structure as follow:

  \Characters\[character_name]\[character files]

  • [character_name] is all folders for each character (folder Jorji, Riona, Lucas, etc). Folder naming must follow the default name.

  Agent	Freya	Lucas	Tofu
  Amanda	Gala	Myrtle	Neil
  Aqua	Hendry	McQueen	-
  Baileys	Hyde	Rachel	-
  Dooley	Jorji	Riona	-
  Fahmi	Lua	Silver	-

• Characters Mod file

  For the character mod you can edit with Spine ver. 3.8.99 for CT Ep. 2 (For CT, use Spine ver. 3.6.53).

  • Atlas file text (.txt) for mapping texture
  • Texture (.png)
  • Animation file (.json) for animation

  We provide the file templates here:

  CT: https://drive.google.com/file/d/1Mx2p8oOZFVjLxxZ03xXGaj6wM8Itbak8/view?usp=sharing

  CT Ep. 2: https://drive.google.com/file/d/1Mx2p8oOZFVjLxxZ03xXGaj6wM8Itbak8/view?usp=sharing

• Note: Photoshop Texture Export/Save setting

  While using Photoshop, there’s a slight problem where white borders in transparent texture PNG will appear after you edit the texture file. It should be fine using other image software/editors, such as Clip Studio Paint or GIMP.

  • For the problem info and solution, you can check the article here:

    https://forum.unity.com/threads/white-borders-around-transparent-png.212972/#post-1430907

    

  • This will help solve the unintended white borders that can damage the PNG.

  If the problem using Photoshop persists, try exporting the PNG from other image software. Or if you still export using Photoshop, try open it using other software, do small edit (e.g. putting filter with 0 value), and re-save it.