マニュアル: カスタムアクションプラグイン

カスタムアクションプラグインの翻訳

v1.3.3より、カスタムアクションに翻訳ファイルを添付することで翻訳ができるようになりました。

翻訳可能な部分について

• プロパティ名やプロパティ用のツールチップを翻訳することができます。
• クラス名(リストに表示される名前)やグループ名は翻訳できませんが、そのツールチップは翻訳できます。

翻訳の実装方法

所定のフォーマットに沿って作成されたcsvファイルをプラグイン内のeditor_translationsフォルダ直下に配置することで翻訳データが読み込まれます。

【フォルダ構成例】

res://addons/
└── custom_action_plugin/
├── custom_action.gd
└── editor_translations
└── custom_action.csv

• カスタムアクションのgdスクリプトと同階層にあるeditor_translationsの直下にあることが条件であり、addonsフォルダやcustom_action_pluginフォルダ以外のどの場所においても動作します。
• gdスクリプトの名称とcsvファイルの名称が一致している必要はありません。
• 複数のgdスクリプトに対して1つのcsvファイルを用意しても動作します。

CSVファイルのサンプル

context,key,ja,en,ko,zh_CN,zh_TW,pt_BR,es_AR,de,ru
"CustomAction","説明内容","カスタムアクション：ツールチップ","Custom Action: Tooltip","커스텀 액션: 툴팁","自定义动作：工具提示","自訂動作：工具提示","Ação personalizada: dica de ferramenta","Acción personalizada: descripción emergente","Benutzerdefinierte Aktion: Tooltip","Пользовательское действие: подсказка"
"CustomAction","group","グループ","Group","그룹","组","群組","Grupo","Grupo","Gruppe","Группа"
"CustomAction:test_num","test_num(数字ツールチップ)","数値のツールチップ","Number tooltip","숫자 툴팁","数值工具提示","數值工具提示","Dica de ferramenta do número","Descripción emergente del número","Zahlen-Tooltip","Подсказка для числа"
"CustomAction:test_num","test_num","数値","Number","숫자","数值","數值","Número","Número","Zahl","Число"
"CustomAction:test_elements","test_elements(属性ツールチップ)","属性のツールチップ","Element tooltip","속성 툴팁","属性工具提示","屬性工具提示","Dica de ferramenta do elemento","Descripción emergente del elemento","Element-Tooltip","Подсказка для элемента"
"CustomAction:test_elements","test_elements","属性","Element","속성","属性","屬性","Elemento","Elemento","Element","Элемент"
"CustomAction:test_elements","Fire","火","Fire","불","火","火","Fogo","Fuego","Feuer","Огонь"
"CustomAction:test_elements","Water","水","Water","물","水","水","Água","Agua","Wasser","Вода"
"CustomAction:test_elements","Earth","土","Earth","땅","土","土","Terra","Tierra","Erde","Земля"

*csvのみ
custom_action.csv (1.7 KB)
*本体を含むサンプル構成例
custom_action_translation_sample.zip (2.2 KB)

列の詳細について

- `context`はそのクラスのどのプロパティに紐づくかを指定します。ただ`export_group`と`get_description()`にて返る説明は紐づくプロパティが存在しないので省きます
- `key`はスクリプト内で定義されている識別子を指定します
- 以降の列は言語設定に応じたテキストを定義します

CSVの記述のコツ

1. ヘッダー (context,key,...) はクォートなし
2. 2行目以降は全項目をダブルクォートで囲む
3. UTF-8 BOM
4. CRLF改行