Toon Color Assistant
- FreeDigital0 JPY
- Support (same content)Digital500 JPY
Unity エディターで VRChat アバターのトゥーンカラーを合わせるツールです。Scene ビューで表面をクリックするとテクスチャ色を読み、影・リム・アウトラインなどの色を提案します。 アバターに Toon Color Assistant コンポーネントを付けると、ビルド時に複製したマテリアルへ色を適用します。元のマテリアルは変更しません（NDMF が必要です）。 ==================== A Unity Editor tool that sets toon colours on a VRChat avatar. Click a surface in the Scene view to sample the texture colour, then get proposed shadow, rim, and outline colours. Add the Toon Color Assistant component to an avatar, and it applies the colours to copied materials at build time. The original materials stay unchanged (requires NDMF). ==================== Unity 에디터에서 VRChat 아바타의 툰 스타일 색상을 맞추는 도구입니다. Scene 뷰에서 표면을 클릭하면 텍스처 색을 읽고, 그림자·림·외곽선 색을 제안합니다. 아바타에 Toon Color Assistant 컴포넌트를 붙이면 빌드할 때 복제한 재질에 색을 적용합니다. 원본 재질은 바뀌지 않습니다 (NDMF 필요).
ドキュメント / Documentation
https://kamyu1537.github.io/toon-color-assistant/
動作環境 / Requirements
- Unity 2022.3 LTS - lilToon / Poiyomi は任意（無くてもウィンドウは開き、色の提案はできます。プロジェクトにあるときだけ、そのシェーダーのプロパティへ書き込みます） - NDMF 1.14.8 以上は任意（アバターコンポーネントのビルド適用と Scene プレビューに必要です。メインウィンドウだけなら不要です） ※ ツール本体の表示言語は韓国語と英語です（日本語 UI はありません）。 ※ VCC / ALCOM で追加することもできます。 ==================== - Unity 2022.3 LTS - lilToon / Poiyomi are optional (the window still opens and still proposes colours without them; it writes those shaders' properties only when they are in the project) - NDMF 1.14.8 or later is optional (needed for the avatar component's build step and Scene preview; the main window works without it) ※ The tool UI language is Korean and English (no Japanese UI). ※ You can also add it with VCC / ALCOM. ==================== - Unity 2022.3 LTS - lilToon / Poiyomi는 선택 사항입니다 (없어도 창은 열리고 색 제안은 됩니다. 프로젝트에 있을 때만 그 셰이더 속성에 기록합니다) - NDMF 1.14.8 이상은 선택 사항입니다 (아바타 컴포넌트의 빌드 적용과 Scene 미리보기에 필요합니다. 메인 창만 쓴다면 없어도 됩니다) ※ 도구 UI 언어는 한국어와 영어입니다 (일본어 UI 없음). ※ VCC / ALCOM으로도 추가할 수 있습니다.
導入方法 / How to install
【VCC / ALCOM（推奨）】 1. ToonColorAssistant-1.25.0.zip を解凍し、中の .url ファイルを開くか、下記のリンクから VCC にリポジトリを追加します。 vcc://vpm/addRepo?url=https%3A%2F%2Fkamyu1537.github.io%2Fvcc-listing%2Findex.json 2. アバタープロジェクトの Manage Project から Toon Color Assistant を追加します。 【unitypackage】 1. Unity でアバターのプロジェクトを開きます（Unity 2022.3 LTS）。 2. Assets > Import Package > Custom Package から me.kamyu.tooncolorassistant-1.25.0.unitypackage を選び、Import します。 3. Packages/me.kamyu.tooncolorassistant に入ります。上部メニューに Tools > Toon Color Assistant が出ればインストール完了です。 ※ 追加の DLL や NuGet パッケージは不要です。 ※ 詳しくはドキュメントをご確認ください。 ==================== [VCC / ALCOM (recommended)] 1. Unzip ToonColorAssistant-1.25.0.zip and open the .url file inside, or add the repository to VCC from the link below. vcc://vpm/addRepo?url=https%3A%2F%2Fkamyu1537.github.io%2Fvcc-listing%2Findex.json 2. Open Manage Project for your avatar project and add Toon Color Assistant. [unitypackage] 1. Open the avatar project in Unity (Unity 2022.3 LTS). 2. Choose Assets > Import Package > Custom Package, select me.kamyu.tooncolorassistant-1.25.0.unitypackage, and click Import. 3. It lands in Packages/me.kamyu.tooncolorassistant. Tools > Toon Color Assistant in the top menu means it is installed. ※ No extra DLL or NuGet package is required. ※ See the documentation for details. ==================== 【VCC / ALCOM (권장)】 1. ToonColorAssistant-1.25.0.zip 압축을 풀고 안의 .url 파일을 열거나, 아래 링크로 VCC에 저장소를 추가합니다. vcc://vpm/addRepo?url=https%3A%2F%2Fkamyu1537.github.io%2Fvcc-listing%2Findex.json 2. 아바타 프로젝트의 Manage Project에서 Toon Color Assistant를 추가합니다. 【unitypackage】 1. Unity에서 아바타 프로젝트를 엽니다 (Unity 2022.3 LTS). 2. Assets > Import Package > Custom Package에서 me.kamyu.tooncolorassistant-1.25.0.unitypackage를 고르고 Import합니다. 3. Packages/me.kamyu.tooncolorassistant에 들어갑니다. 상단 메뉴에 Tools > Toon Color Assistant가 보이면 설치 완료입니다. ※ 따로 받을 DLL이나 NuGet 패키지는 없습니다. ※ 자세한 내용은 문서를 확인해주세요.
使い方 / How to use
1. Tools > Toon Color Assistant を開きます。 2. Pick From Scene を押し、Scene ビューでアバターの表面をクリックします。（やめるときは Esc） 3. ウィンドウ上部でマテリアル・シェーダー・読んだ色・マテリアルタイプを確認します。必要ならタイプを変更します。 4. Colour タブでサンプル色と提案パレットを確認します。 5. Shading タブでスタイルと影・リム・逆光・アウトライン・ハイライトを調整します。 6. プレビューで結果を確認し、Apply でマテリアルに書き込みます。Write to original / Write to a copy と書き込むチャンネルを選べます。 ※ lilToon / Poiyomi 以外のシェーダーでは色の提案とコピーのみで、マテリアルへは書き込みません。 ※ Surface タブでは shadow mask / normal / matcap / occlusion / ramp などのテクスチャ生成もできます。 ※ アバターや衣装のルートに Add Component > Toon Color Assistant/Toon Color Assistant でコンポーネントを付けると、マテリアルを書き換えずにビルド時に適用できます。Groups で複数のレンダラーの影色をそろえることもできます（NDMF が必要です）。 ※ 詳しくはドキュメントのクイックスタートとアバターコンポーネントをご確認ください。 ==================== 1. Open Tools > Toon Color Assistant. 2. Click Pick From Scene, then click the avatar surface in the Scene view. (Esc leaves pick mode.) 3. Check the material, shader, sampled colour, and material type at the top of the window. Change the type if needed. 4. On the Colour tab, review the sample and the proposed palette. 5. On the Shading tab, pick a style and adjust shadow, rim, backlight, outline, and highlight. 6. Preview the result, then click Apply to write to the material. Choose Write to original / Write to a copy and which channels to write. ※ For shaders other than lilToon / Poiyomi, you get colour suggestions and copying only; nothing is written to the material. ※ The Surface tab can generate textures such as shadow mask / normal / matcap / occlusion / ramp. ※ Add the component to an avatar or outfit root with Add Component > Toon Color Assistant/Toon Color Assistant to apply colours at build time without changing your materials. Groups give several renderers the same shadow colours (requires NDMF). ※ See the documentation Quick start and Avatar component pages for details. ==================== 1. Tools > Toon Color Assistant를 엽니다. 2. 장면에서 표면 선택을 누른 뒤 Scene 뷰에서 아바타 표면을 클릭합니다. (그만두려면 Esc) 3. 창 위에서 재질·셰이더·읽어 온 색·재질 유형을 확인합니다. 필요하면 유형을 바꿉니다. 4. 색상 탭에서 샘플 색과 제안 팔레트를 확인합니다. 5. 셰이딩 탭에서 스타일과 그림자·림·역광·외곽선·하이라이트를 조절합니다. 6. 미리보기로 결과를 보고, 적용으로 재질에 기록합니다. 원본에 기록 / 복제본에 기록과 기록할 채널을 고를 수 있습니다. ※ lilToon / Poiyomi 이외 셰이더에서는 색 제안과 복사만 되며, 재질에는 기록하지 않습니다. ※ Surface 탭에서는 shadow mask / normal / matcap / occlusion / ramp 등의 텍스처 생성도 할 수 있습니다. ※ 아바타나 의상 루트에 Add Component > Toon Color Assistant/Toon Color Assistant로 컴포넌트를 붙이면, 재질을 바꾸지 않고 빌드할 때 적용할 수 있습니다. 그룹으로 여러 렌더러의 그림자 색을 맞출 수도 있습니다 (NDMF 필요). ※ 자세한 내용은 문서의 빠른 시작과 아바타 컴포넌트를 확인해주세요.
バリエーション / Options
※ 支援版は無料版と内容は同じです。応援していただける方向けです。 ==================== ※ The Support option has the same content as the Free option. It's for those who'd like to support me. ==================== ※ 서포트 옵션은 무료 옵션과 내용이 같으며, 후원을 원하시는 분을 위한 옵션입니다.
ライセンス / License
本ソフトウェアは MIT License でライセンスされています。 ライセンス: https://opensource.org/license/mit ご質問は BOOTH のメッセージ、または X（@kamyu1537）の DM でご連絡ください。 ==================== This software is licensed under the MIT License. License: https://opensource.org/license/mit For questions, contact me via BOOTH message or X (@kamyu1537) DM. ==================== 본 소프트웨어는 MIT License로 라이선스됩니다. 라이선스: https://opensource.org/license/mit 문의는 BOOTH 메시지 또는 X(@kamyu1537) DM으로 연락해주세요.
更新履歴 / Changelog
2026-10-20 v1.25.0 - 追加: アバター・衣装のルートに付ける非破壊の Toon Color Assistant コンポーネント（NDMF 1.14.8 以上で、ビルド時に複製したマテリアルへ色と表面テクスチャを適用。元のマテリアルは変更しません） - 追加: コンポーネントの結果を NDMF プレビューで Scene ビューに表示（初期状態でオン、アバターごとにオフにできます） - 追加: 複数のレンダラーで影色パレットを共有する Groups、レンダラー / マテリアルごとの設定、フォルダー表示と検索付きのレンダラー一覧 - 変更: Skin のハイライトを光に沿うやわらかいものに変更し、Specular Mode をマテリアルタイプに合わせて設定 - 修正: Poiyomi のハイライト強度、Lighting Type のキーワード、Lighting Ramp / Shadow Mask、逆光、影の中の光沢 MatCap、アルベドから作るノーマルの UV などを修正 - 修正: Revert / Revert All Targets で警告の修正ボタンによる変更も元に戻すように修正 - 変更: ToonColorAssistantWindow の名前空間を ToonColorAssistant.Editor.Window に変更（スクリプトから開く場合のみ影響） 詳細: https://kamyu1537.github.io/toon-color-assistant/ja/release-notes/1-25 2026-10-09 v1.24.2 - 追加: ウィンドウのツールバーの Menu の横に小さな Sponsor ボタン（GitHub Sponsors を開きます） - 修正: Poiyomi の色サンプリングに色調整・デカール・マスク・頂点カラーが再び含まれるように修正（1.24.1 以前と同じ） - 修正: lilToon で Use Outline がオフのまま適用すると、アウトラインなしのシェーダーに切り替え、アウトラインの色 / 幅 / テクスチャは変更しないように修正 - 修正: 読み込んだプリセットの設定がリコンパイルや再起動の後も保存されるように修正 - 修正: Write to a copy / Generate & Assign / Detail Normal / MatCap / Glitter / AO Map / リムの表示に関する不具合を修正 詳細: https://kamyu1537.github.io/toon-color-assistant/ja/release-notes/1-24 ==================== 2026-10-20 v1.25.0 - Added: a non-destructive Toon Color Assistant component for avatar and outfit roots. With NDMF 1.14.8 or later it applies colours and surface textures to copied materials at build time; original materials stay unchanged - Added: Scene preview of the component through NDMF preview (on by default, can be turned off per avatar) - Added: Groups that share one shadow palette across renderers, per-renderer and per-material settings, and a renderer list with folders and search - Changed: Skin gets a soft highlight that follows the light, and Specular Mode is set to match the material type - Fixed: Poiyomi highlight strength, Lighting Type keywords, Lighting Ramp / Shadow Mask, backlight, gloss matcap inside shadows, and UVs of normals generated from albedo - Fixed: Revert / Revert All Targets also undo what a warning's fix button changed - Changed: ToonColorAssistantWindow moved to the ToonColorAssistant.Editor.Window namespace (matters only to scripts that open the window by type) Full notes: https://kamyu1537.github.io/toon-color-assistant/en/release-notes/1-25 2026-10-09 v1.24.2 - Added: a small Sponsor button next to Menu on the window's toolbar (opens GitHub Sponsors) - Fixed: Poiyomi colour sampling again includes colour adjustments, decals, masks and vertex colours (as before 1.24.1) - Fixed: on lilToon, applying with Use Outline off switches to the shader without an outline and leaves outline colour / width / texture unchanged - Fixed: loaded preset settings are saved to the project across recompile / reopen - Fixed: several Write to a copy / Generate & Assign / Detail Normal / MatCap / Glitter / AO Map / rim reporting issues Full notes: https://kamyu1537.github.io/toon-color-assistant/en/release-notes/1-24 ==================== 2026-10-20 v1.25.0 - 추가: 아바타나 의상 루트에 붙이는 비파괴 Toon Color Assistant 컴포넌트 (NDMF 1.14.8 이상에서 빌드할 때 복제한 재질에 색과 표면 텍스처를 적용합니다. 원본 재질은 바뀌지 않습니다) - 추가: 컴포넌트 결과를 NDMF 미리보기로 Scene 뷰에 표시 (기본으로 켜져 있고, 아바타마다 끌 수 있습니다) - 추가: 여러 렌더러가 그림자 팔레트를 함께 쓰는 그룹, 렌더러와 재질별 설정, 폴더 구조와 검색이 있는 렌더러 목록 - 변경: Skin 하이라이트를 빛을 따라가는 부드러운 하이라이트로 바꾸고, Specular Mode를 재질 유형에 맞게 설정 - 수정: Poiyomi의 하이라이트 강도, Lighting Type 키워드, Lighting Ramp / Shadow Mask, 역광, 그림자 속 광택 매트캡, 알베도로 만든 노멀의 UV 문제 수정 - 수정: Revert / Revert All Targets가 경고의 수정 버튼으로 바뀐 값도 되돌리도록 수정 - 변경: ToonColorAssistantWindow 네임스페이스를 ToonColorAssistant.Editor.Window로 변경 (스크립트에서 창을 여는 경우에만 해당) 자세히: https://kamyu1537.github.io/toon-color-assistant/release-notes/1-25 2026-10-09 v1.24.2 - 추가: 창 툴바의 Menu 옆에 작은 Sponsor 버튼 (GitHub Sponsors를 엽니다) - 수정: Poiyomi 색 샘플링에 색 보정, 데칼, 마스크, 정점 색이 다시 포함되도록 수정 (1.24.1 이전과 같음) - 수정: lilToon에서 Use Outline을 끈 채 적용하면 외곽선 없는 셰이더로 바꾸고 외곽선 색 / 두께 / 텍스처는 그대로 두도록 수정 - 수정: 불러온 프리셋 설정이 리컴파일이나 다시 열기 후에도 저장되도록 수정 - 수정: Write to a copy / Generate & Assign / Detail Normal / MatCap / Glitter / AO Map / 림 표시 관련 문제 수정 자세히: https://kamyu1537.github.io/toon-color-assistant/release-notes/1-24