How to translate Japanese names

You can automatically mass add English names to an MMD model using the MMD Tools Blender add-on (UuuNyaa fork).
Here are the instructions:

1. Import a `.pmd` or `.pmx` model into Blender. Click File, Import, `MikuMikuDance model (.pmd .pmx)`.
2. In the MMD panel (whose tab is on the left side of the 3D view), click on the Translation button. This causes a popup dialog box to appear.
3. In the Dictionary list menu, select `translations.csv` as the translation dictionary.
4. MMD Tools translation gives you the option to not translate a section of your model, but there is no advantage to that unless a section of your model is already well-translated. You can select or deselect a translation Type (Bones, Morphs, Materials, Display, Physics, Information) using Shift + LMB.
	* Leave the MMD Names option enabled. Otherwise you won't see any translated names in your model after you export it from Blender. The Blender Names option only translates names for viewing the translated names in Blender.
	* If you enable the "Use Morph Prefix" option, prefixes will be added to the English names of the morphs which are not vertex morphs (M\_ for material morphs, B\_ for bone pose morphs, UV\_ for UV morphs, G\_ for group morphs). This will allow you to easily see the morph type of a morph when you load the model into MMD.
	* If you enable "Overwrite", existing English names in the model may be overwritten with a new translation. Otherwise existing English names in the model will be preserved.
	* Enable "Allow Fails". This causes names to be partially translated, even if the translations.csv dictionary is not able to completely translate a name. The only reason to disallow incomplete translations would be for diagnostic purposes. If you do not enable "Allow Fails", a list of all of the untranslated names will be printed to a text file called `mmd_tools.translations.fails`, which you can then find and view in the Blender text editor.
	* Click OK. English names will then be mass added onto your imported MMD model within several seconds or within a fraction of a second. Only the active model wil be translated. MMD Tools does not translated more than one model at a time.
5. You can then export this model from Blender with MMD Tools with all of its new English names of morphs, bones, display panel groups, physics, materials and model information. Click File, Export, `MikuMikuDance model (.pmx)` to export the model.

## Use custom dictionary

1. After you have already installed the MMD Tools (UuuNyaa fork) Blender add-on. download this MMD translations dictionary file: https://github.com/Hogarth-MMD/mmd\_tools\_translation/archive/master.zip
2. After unzipping this file (with 7-zip or Bandizip, for example), copy the `translations.csv` file into the Dictionary Folder
3. In addition to following the instructions above, you also have an option to choose a custom folder in which to store an MMD Tools translation dictionary .csv file. Click User Preferences, Add-ons, Object, mmd\_tools to see the MMD Tools Preferences panel. There you can choose your own custom Dictionary Folder where you translations csv file is located, instead of using the default folder.
4. If you use your own custom translations .csv dictionary file, it must have the unicode utf-8 text encoding.

### Available dictionaries

* Google online spreadsheet by @ptrthomas
https://docs.google.com/spreadsheets/d/1RsKmQGo8JKezrEZ3wQPPJlA6SspzFOkmTuj6lSxAzxo/edit?usp=sharing
* translations.csv file by @Hogarth-MMD
https://github.com/Hogarth-MMD/mmd\_tools\_translation