cn_pmx_convert

中国語PMXファイル（MikuMikuDance用3Dモデル）を日本語Windows環境（cp932/Shift-JIS）で正常に表示・動作するよう変換するCLIツールです。

概要

中国のMMDモデル制作者が作成するPMXファイルには、日本語Windowsのcp932（Shift-JIS）で表示できない簡体字が含まれていることがあります。特にテクスチャパスに問題文字があると、モデルのテクスチャが読み込めなくなります。

このツールは以下を自動で行います：

• PMXファイル内の簡体字テキストを日本語漢字・日本語表現に変換
• テクスチャファイル名のリネーム（PMX内パスとディスク上の実ファイルの両方）
• 元ファイルは変更せず、別ディレクトリに変換済みコピーを出力

対応フォーマット

• PMX 2.0 / 2.1
• テキストエンコーディング: UTF-16LE / UTF-8

ビルド

cargo build --release

使い方

# モデルディレクトリを変換（出力先は自動で Aria_converted に）
cn_pmx_convert E:\models\Aria

# 出力先を指定
cn_pmx_convert E:\models\Aria -o E:\converted

# プレビュー（変更内容を表示するだけ）
cn_pmx_convert E:\models\Aria --dry-run

# テクスチャファイルのリネームをしない
cn_pmx_convert E:\models\Aria --no-rename

オプション

オプション	説明
-o, --output <DIR>	出力ディレクトリを指定
--no-rename	テクスチャファイルのリネームを行わない
--dry-run	変更内容を表示するだけで実行しない
-v, --verbose	詳細情報を表示

変換例

変換前（中国語）	変換後（日本語）
tex\颜.png	tex\顔.png
裙饰	スカート飾
蝴蝶结	リボン
项链	ネックレス
齿	歯
口线	口線

詳細な変換辞書の一覧は USAGE.md を参照してください。

仕組み

1. 入力ディレクトリ全体を出力先にコピー
2. PMXバイナリを「テキスト」と「それ以外」のセグメントに分解
3. テキストセグメントに3レイヤーの辞書（語彙→単字→コメント用）を適用
4. セグメント列からPMXバイナリを再構築（非テキスト部分はバイト完全一致）
5. テクスチャファイルをリネーム

ライセンス

MIT License