【Unity Editor Tool】TMP to Static Mesh Tool

📌 【Unity Editor Tool】TMP to Static Mesh Tool

📄 概要 / Summary

【ZH】 这是一个专为 Unity 开发者和 VRChat 3D 建模师设计的编辑器工具。它可以一键将 TextMeshPro (TMP) 文字物体转换为普通的静态网格（Static Mesh），并自动生成 .asset 网格文件。

【JA】 Unity 開発者および VRChat 3D モデラー向けに設計されたエディターツールです。TextMeshPro (TMP) 形式のテキストオブジェクトを、ワンクリックで通常の静的メッシュ（Static Mesh）に変換し、.asset メッシュファイルを自動生成します。

【KO】 Unity 개발자 및 VRChat 3D 모델러를 위해 설계된 에디터 툴입니다. TextMeshPro (TMP) 형식의 텍스트 오브젝트를 원클릭으로 일반 정적 메쉬(Static Mesh)로 변환하고, .asset 메쉬 파일을 자동으로 생성합니다。

💡 适用场景 / 💡 このような方におすすめ / 💡 이런 분들께 추천합니다

【ZH】 * 想在 VRChat Avatar（化身）或 Worlds（世界）中加入文字，但因为平台限制/性能优化而不希望使用动态 TMP 组件。

想要将文字作为 3D 模型的固有网格（Mesh）进行打包发布。

【JA】 * VRChat のアバターやワールドに文字を入れたいけれど、プラットフォームの制限や軽量化（最適化）のために動的な TMP コンポーネントを使いたくない方。

文字を 3D モデル固有のメッシュ（Mesh）として一体化し、パッケージ化して配布したい方。

【KO】 * VRChat 아바타나 월드에 글자를 넣고 싶지만, 플랫폼 제한 및 최적화를 위해 동적 TMP 컴포넌트를 사용하고 싶지 않은 분.

글자를 3D 모델 고유의 메쉬(Mesh)로 일체화하여 패키지로 배포하고 싶은 분.

🛠️ 功能特点 / 主な機能 / 주요 기능

1. 批量一键转化 / 一括ワンクリック変換 / 일괄 원클릭 변환

【ZH】 支持在 Hierarchy 中同时选中多个 TMP 物体进行批量转化，大幅节省重复操作的时间。

【JA】 ヒエラルキー上で複数の TMP オブジェクトを同時に選択し、一括変換することが可能です。作業時間を大幅に短縮します。

【KO】 계층 구조(Hierarchy)에서 여러 TMP 오브젝트를 동시에 선택하여 일괄 변환할 수 있어 작업 시간을 크게 단축합니다.

2. 材质与属性自动保留 / マテリアルと属性の自動保持 / 머티리얼 및 속성 자동 유지

【ZH】 转换后会自动移除 TextMeshPro 和 CanvasRenderer，并自动添加 MeshFilter 与 MeshRenderer。文字原有的字体材质（Font Material）将完美保留。

【JA】 変換後、TextMeshPro と CanvasRenderer は自動的に削除され、MeshFilter と MeshRenderer が追加されます。テキストが元々使用していたフォントマテリアルはそのまま維持されます。

【KO】 변환 후 TextMeshPro 및 CanvasRenderer는 자동으로 제거되고 MeshFilter 및 MeshRenderer가 추가됩니다. 텍스트가 원래 사용하던 폰트 머티리얼이 완벽하게 유지됩니다.

3. 网格资产自动管理 / メッシュアセットの自動管理 / 메쉬 에셋 자동 관리

【ZH】 生成的 Mesh 独立网格文件会自动保存在 Assets/GeneratedMeshes/ 目录下，命名清晰，避免覆盖。

【JA】 生成された独立したメッシュファイルは、Assets/GeneratedMeshes/ ディレクトリ内に明確な名前で自動保存され、上書きを防止します。

【KO】 생성된 독립 메ッシュ 파일은 Assets/GeneratedMeshes/ 디렉토리에 명확한 이름으로 자동 저장되어 덮어쓰기를 방지합니다.

4. 支持撤销系统 / Undo機能のサポート / Undo 기능 지원

【ZH】 完美的 Undo 注册，转化后不满意可直接通过快捷键 Ctrl + Z 撤销操作。

【JA】 安心の Undo 登録。変換後の結果に満足できない場合は、ショートカットキー Ctrl + Z で直接元に戻すことができます。

【KO】 완벽한 Undo 기능 지원. 변환 후 결과가 만족스럽지 않다면 단축키 Ctrl + Z로 즉시 되돌릴 수 있습니다.

📖 使用教程 / 使い方 / 사용 방법

【ZH】

将 TMPToStaticMeshTool.cs 脚本放入 Unity 项目的 Assets/Editor 文件夹中（如果没有 Editor 文件夹可自行新建）。

在 Unity 顶部菜单栏找到并点击：Tools > TMPToStaticMeshTool 打开工具窗口。

在场景中选中需要转化的 TextMeshPro 物体。

点击窗口中的 [开始转化] 按钮，大功告成！

【JA】

TMPToStaticMeshTool.cs スクリプトを、Unity プロジェクトの Assets/Editor フォルダ内に入れます（Editor フォルダがない場合は新規作成してください）。

Unity 上部メニューから Tools > TMPToStaticMeshTool をクリックしてウィンドウを開きます。

ヒエラルキー上で変換したい TextMeshPro オブジェクトを選択します。

ウィンドウ内の [开始转化 (変換開始)] ボタンをクリックすれば完了です！

【KO】

TMPToStaticMeshTool.cs 스크립트를 Unity 프로젝트의 Assets/Editor 폴더에 넣습니다 (Editor 폴더가 없다면 새로 생성해 주세요).

Unity 상단 메뉴 바에서 Tools > TMPToStaticMeshTool을 클릭하여 도구 창을 엽니다.

씬(Scene)에서 변환하려는 TextMeshPro 오브젝트를 선택합니다.

창에 있는 [开始转化 (변환 시작)] 버튼을 클릭하면 완료됩니다!

⚠️ 注意事项与免责声明 / 注意事項・免責事項 / 주의 사항 및 면책 조항

🛑 【ZH】注意事项

操作不可逆：转化后动态的文本将变成固定的三维网格，无法再修改文字内容。强烈建议在操作前备份您的物体或场景！

材质依赖：转换后的网格仍旧依赖原 TMP 字体资产生成的材质（Material），请勿删除原字体资产。

🛑 【JA】注意事項

取り消し不可の操作：変換後、動的なテキストは固定の3Dメッシュとなり、テキスト内容の再編集はできなくなります。操作前に必ずオブジェクトやシーンのバックアップを取ることを強く推奨します！

マテリアルへの依存：変換後のメッシュは、元の TMP フォントアセットから生成されたマテリアルに依存します。元のフォントアセットを削除しないでください。

🛑 【KO】주의 사항

되돌릴 수 없는 작업：변환 후 동적 텍스트는 고정된 3D 메쉬로 변경되므로 텍스트 내용을 다시 수정할 수 없습니다. 작업 전에 반드시 오브젝트나 씬을 백업해 두는 것을 강력히 권장합니다!

머티리얼 의존성：변환된 메쉬는 기존 TMP 폰트 에셋에서 생성된 머티리얼에 의존합니다. 원본 폰트 에셋을 삭제하지 마십시오.

【ZH】免责声明：因使用本工具导致的任何数据丢失或工程损坏，作者概不负责。

【JA】免責事項：本ツールの使用によって生じたデータの紛失やプロジェクトの破損等について、制作者は一切の責任を負いかねます。

【KO】면책 조항：본 툴의 사용으로 인해 발생한 데이터 손실 및 프로젝트 손상 등에 대해 제작자는 어떠한 책임도 지지 않습니다.

✉️ 利用規約 & お問い合わせ / Support

如有任何疑问或Bug反馈，欢迎通过 BOOTH 消息功能联系。

不具合の報告やご質問がございましたら、BOOTHのメッセージ機能からお気軽にお問い合わせください。