Miku 3.0.0

License

Blender

Unity

Miku는 Blender 5.x EEVEE 재질을 target-neutral MaterialIR 2.0으로 변환한 다음, 결정론적이고 편집 가능한 Standard PBR Shader Graph 에셋을 Unity 6 URP로 가져옵니다. Blender는 하나의 Standard PBR 경로를 노출하며; 네 개의 번들된 Game Toon Shader/HLSL 프리셋 패밀리는 Unity Editor에서 작성되었습니다.

공식 문서 언어는 영어입니다. Simplified Chinese README 또는 전체 English Manual / Chinese Manual를 참조하십시오.

주요 특징 (Highlights)

• 선언된 근사치, 격리된 텍스처 베이킹, 결정론적 번들, 시간 입력 사전 검사(time-input preflight)가 적용된 하나의 가시적인 Blender Standard PBR 내보내기 경로.
• 편집 가능한 Unity Shader Graph 래퍼, Miku 소유의 생성된 Sub Graphs, 안정적인 ID, 구조화된 진단 도구, 그리고 역사적 Bundle 1.0 호환성.
• 명시적 텍스처 필드, 필수 필드 유효성 검사(required-field validation), 에셋 덮어쓰기 없음, 자동 Renderer, FBX 또는 Prefab 바인딩이 없는 Miku > Game Toon > Materials > Create Material 위치의 Unity 재질 생성기.
• 선택적 Endfield 튜토리얼 조명, 탄젠트 공간 스킨 아웃라인(tangent-space skinned outlines), 그리고 프로젝트 소유의 사전-후처리 게임 LUT 설치 프로그램. Endfield 2.3.0 가이드를 참조하십시오.
• 실제 탄젠트 공간 노멀 맵, 명시적 UV1 백페이스/UV7 아웃라인 드로우, 다섯 개의 아웃라인 영역, 공유 알파 커버리지, 그리고 결합된 Geometry/Screen Rim 렌더러 설정이 적용된 클린룸 Genshin 튜토리얼 구현. 이는 비공개 2.4.0 후보 버전에서 처음 개발되어 3.0.0에 포함되었으며, Genshin 렌더링 가이드를 참조하십시오.
• WuWa 3.0 튜토리얼 PBR/GI, 패킹된 노멀-메탈릭-러프니스(normal-metallic-roughness) 텍스처, 클론 전용 마이그레이션, 전용 아웃라인, 그리고 튜토리얼 Screen Rim.

See the
WuWa 3.0 가이드.

• 사용자 설정에서 Miku > Settings를 통해 영어 또는 간체 중국어 Miku Editor UI 선택.

번들된 게임 투톤 셰이더/HLSL 프리셋

Unity 패키지는 네 가지 실험적 프리셋 계열에 대한 최초의, 오리지널 Miku Shader/HLSL 코드를 제공합니다. 이들은 단순한 필드 이름 템플릿이 아니라 작동하는 셰이더 구현체입니다.

제작자는 총 22개의 유효한 머티리얼 파트를 노출합니다. 이 프리셋들은 실험적 호환성 구현체이며 어떤 게임과도 픽셀 단위의 정확성을 보장하지 않습니다. Miku는 추출된 게임 Shader 소스, 모델, 텍스처, 로고 또는 기타 게임 에셋을 포함하지 않습니다. 모든 텍스처 규칙, 예시 갤러리 및 Unity Editor 도구 가이드는 매뉴얼을 참조하십시오.

릴리스 설치하기

1. v3.0.0 릴리스에서 miku_shader_converter-3.0.0.zip, com.miku.shaderconverter-3.0.0.tgz, 및 SHA256SUMS.txt를 다운로드합니다.
2. 설치하기 전에, ZIP과 TGZ에 대해 Get-FileHash -Algorithm SHA256을 실행하고 두 값을 SHA256SUMS.txt와 비교합니다.
3. Blender 5.0-5.2에서 Edit > Preferences > Extensions를 열고, Install from Disk를 선택한 다음 ZIP 파일을 지정하여 Miku를 활성화합니다.
4. Unity 6000.0-6000.5에서 Window > Package Manager > + > Add package from tarball을 연 다음 단일 TGZ 파일을 선택합니다.
5. Blender에서 머티리얼 번들을 내보내고, 그 전체 디렉토리를 Unity 프로젝트의 Assets/ 폴더 아래에 복사합니다.

소스 체크아웃의 경우, 디스크에서 unity/Packages/com.miku.shaderconverter/package.json을 추가합니다. 전체 설치, 소유권, 진단 및 업그레이드 지침은 매뉴얼에 있습니다.

5분 워크플로우

1. Blender의 Shader Editor에서 재질이 적용된 오브젝트를 선택합니다.
2. Miku 사이드바를 열고, 출력 디렉토리를 선택한 후 Standard PBR을 확인합니다.
3. 현재 재질을 내보냅니다. 도달 가능한 Input.Time.* 의존성은 출력 또는 베이크 요청이 기록되기 전에 중지되며, 연결되지 않은 시간 노드는 무해합니다.
4. 전체 .mikubundle 디렉토리를 Unity의 Assets/로 복사하고 임포터가 편집 가능한 그래프 및 리포트 에셋을 생성하도록 합니다.
5. Game Toon 재질의 경우, Unity 크리에이터를 열고 프리셋과 파트를 선택한 후 표시할 텍스처를 할당하고 사용자 소유의 .mat 파일을 저장합니다.

호환성 및 라이선싱

검증된 참조 튜플은 Blender 5.2.0, Unity 6000.4.5f1, URP 17.4.0, 그리고 Windows Direct3D 12의 Shader Graph 17.4.0입니다. Blender 5.0-5.2 및 일치하는 Unity/URP/Shader Graph 기술 라인 6000.0/17.0부터 6000.5/17.5까지는 허용됩니다. 기록된 검증 세트 외부의 안정 패치는 전체 기능 사전 점검을 실행하고 미검증 경고를 발생시킵니다. Blender 5.3+, Unity 6000.6+, 패키지 17.6+, 그리고 프리릴리스 빌드는 생성된 에셋이 기록되기 전에 거부됩니다. Miku는 현재 **실험적(Experimental)**입니다. MaterialIR 2.0, Bundle 1.0, conversion-plan, bake-result, 및 공개 Shader 속성/참조 이름은 3.0.0에서도 호환됩니다. 호환성 매트릭스를 참조하십시오.

저장소의 MIT 라이선스 코드는 MIT License 하에 유지됩니다. Blender Bake Worker를 포함하여 별도의 SPDX 약관을 가진 파일들은 해당 약관을 유지합니다. 매뉴얼에 표시된 다섯 글자 렌더링 이미지는 별도의 문서 자산입니다. 이는 비상업적 학습 및 문서 참고용으로만 제공되며, 상업적 사용은 금지됩니다. 관련 캐릭터, 디자인 및 지적 재산권은 각자의 권리 보유자에게 속하며, Miku는 게임 자산에 대한 어떠한 권리도 부여하지 않습니다. PNG 파일들은 소스 문서와 함께 관리되며, Miku의 MIT 라이선스에서 제외되고 설치 가능한 ZIP/TGZ에서는 생략됩니다. Third-party notices 및 documentation image provenance를 참조하십시오.

개발

py -3.13 -m unittest discover -s tests -p "test_*.py"
py -3.13 tools/ci/run_checks.py --profile pr
py -3.13 tools/release/build_release.py --output-dir artifacts

기여하거나 빌드를 배포하기 전에 CONTRIBUTING.md, SECURITY.md 및 SUPPORT.md를 읽어보십시오.