# 【Maya】PolyKeeper Lite (v0.1.0) ### 押し出しミス・トポロジー自動監視＆チェックツール【検出専用版】 --- ## ■ 概要 **PolyKeeper Lite（ポリキーパー ライト）** は、Mayaでのモデリング作業中に頻発する「押し出しのキャンセル放置（厚みゼロの重複面）」や「ノンマニホールド（非多様体）」、「五角形以上の多角形（Nゴン）」をバックグラウンドで監視・検出するアシスタントツールです。 「うっかり押し出しをEscでキャンセルして面が重なっていた」 「気づかないうちにNゴンやT字結合ができていた」 といった初学者のセルフチェック漏れ防止から、提出前・次工程前のデータ品質検証まで、クリーンなトポロジーの維持を自動でサポートします。 --- ## ■ 主な機能 * **1. 押し出し放置・重複面のリアルタイム警告** * `Ctrl + E` 実行後に移動やオフセットを行わず、選択解除や別ツール（W/E/Rキー）へ切り替えた瞬間、ビューポート上部に赤いバナーで即座に注意喚起します。 * 「Esc ではなく Ctrl+Z で取り消す」習慣づけをサポートします。 * **2. ノンマニホールド（非多様体）発生のリアルタイム警告** * T字結合エッジや蝶ネクタイ状の頂点など、非多様体ジオメトリが生成された瞬間に警告バナーを表示します。 * **3. 多角形（五角形以上 / Nゴン）発生のリアルタイム警告** * エッジ削除時の消し残し（Deleteキーによる頂点残存）やマルチカット等で、五角形以上の面が生まれた瞬間に警告バナーを表示します。 * **4. エラー箇所の全体スキャン＆面ハイライト表示** * シェルフボタンを1クリックするだけで、シーン全体のメッシュを高速走査。 * 潰れた側面だけでなく、重なっている押し出し天面や二重シェルをビューポート上で分かりやすくオレンジ色の「面塗りつぶし」でハイライト表示します。 * **5. シーン保存時（Ctrl + S）の自動全走査** * ファイル保存時にバックグラウンドでシーン全体を自動チェック。ミスを含んだまま保存してしまう事故を防ぎます。 --- ## ■ 動作環境 * **対応ソフトウェア:** Autodesk Maya 2022 / 2023 / 2024 / 2025 以降 * **対応OS:** Windows / macOS * **Pythonバージョン:** Python 3 対応環境 --- ## ■ インストール方法（3秒で完了） 複雑なスクリプトエディタへのコピペやフォルダ配置は不要です。 1. Mayaを起動します。 2. 解凍したフォルダ内にある **`install_PolyKeeper_Lite.mel`** を、Mayaの作業画面（ビューポート）内にそのまま **ドラッグ＆ドロップ** してください。 3. 自動的にスクリプトが配備され、現在開いているシェルフに **「PKLite」** ボタンが追加されます。 4. 「インストール完了」のダイアログが表示されればセットアップ完了です（即座にバックグラウンド監視が開始されます）。 --- ## ■ 使い方 ### 【基本操作】 * **シェルフの「PKLite」アイコンを【左クリック】** * 現在のシーン全体をスキャンし、結果を表示します。 * エラーがある場合は該当箇所が面ハイライトされ、ダイアログに手動修正のヒントが表示されます。 * また、バックグラウンドでの自動監視（保存時チェック・リアルタイム警告等）も同時に有効化されます。 ### 【シェルフの右クリックメニュー】 * **自動監視を再開 (Start Monitoring)**：バックグラウンド監視を有効化します。 * **自動監視を停止 (Stop Monitoring)**：一時的に保存時チェックや警告表示を止めたい場合に使用します。 * **クレジット・バージョン情報 (About)**：バージョン情報やショップURLを確認できます。 --- ## ■ トラブルシューティング / アンインストール * **Q. Mayaを再起動したら監視が動いていない** * **A.** シェルフの「PKLite」ボタンを1回クリックしてください。そのセッションでの監視が再び有効になります。 * **Q. アンインストールしたい** * **A.** 1. シェルフ上の「PKLite」アイコンを右クリックして削除（Delete）してください。 2. 下記のフォルダ内にある `poly_keeper_lite.py` を手動で削除してください。 * **Windows:** `C:\Users\<ユーザー名>\Documents\maya\<バージョン>\scripts\` * **macOS:** `/Users/<ユーザー名>/Library/Preferences/Autodesk/maya/<バージョン>/scripts/` --- ## ■ 利用規約・ライセンス 本ツールを購入・ダウンロードした時点で、以下の規約に同意したものとみなします。 1. **利用許諾** * 本ツールは、購入者・ダウンロード者本人の端末に限り、複数端末（自宅PC・職場PC等）にインストールしてご利用いただけます。 * 本ツールを用いて制作された3Dモデル・成果物（商用・非商用問わず）に制限はありません。クレジット表記も不要です。 2. **禁止事項** * 本ツール本体（スクリプト、インストーラー）の二次配布、転売、貸与、公開アップロードを禁じます。 * 本ツールを改変したものを自身の著作物として再配布・販売する行為を禁じます。 3. **免責事項** * 本ツールの利用により生じた直接的・間接的な損害（データ破損、作業遅延等）について、制作者は一切の責任を負いかねます。重要な作業データは定期的にバックアップを取った上でご利用ください。 --- ## ■ 制作者・連絡先 * **製作者:** mashitaya * **BOOTHショップ:** [https://yworks.booth.pm/](https://yworks.booth.pm/) * **サポート・お問い合わせ:** 不具合の報告やご要望は、BOOTHのメッセージ機能よりご連絡ください。 ``` Copyright (c) 2026 mashitaya. All rights reserved. ```