[VRC/Udon] MMD Optional Station (Add-On)

以下のサンプルワールドで機能を体験できます。

You can try out the feature in the sample world below.

아래 샘플 월드에서 기능을 체험할 수 있습니다.

*************************************************************

https://vrchat.com/home/launch?worldId=wrld_c78157f0-36e4-4f3d-9e86-7d33d997a058

*************************************************************

Requirement

[VRC/Udon] Miku-Miku-Dance Station [v241106_2136 ↑]

https://aparchelabs.booth.pm/items/5363075

この製品は[VRC/Udon] Miku-Miku-Dance Stationのアドオンパッケージです。 [VRC/Udon] Miku-Miku-Dance Station なしで単独で使用することはできません。

This product is an add-on package for [VRC/Udon] Miku-Miku-Dance Station. Cannot be used alone without [VRC/Udon] Miku-Miku-Dance Station.

이 제품은 [VRC/Udon] Miku-Miku-Dance Station의 애드온 패키지입니다. [VRC/Udon] Miku-Miku-Dance Station 없이 단독으로 사용할 수 없습니다.

CAUTION

[VRC/Udon] Miku-Miku-Dance Stationに含まれているコンポーネントのスクリプトを既存のクラス名と異なるようにカスタマイズした場合、正常な動作を保証することはできません。

[VRC/Udon] Miku-Miku-Dance Stationのバージョンが推奨バージョンより低い場合、正常な動作を保証することはできません。

VRC_MikuMikuDanceStationフォルダの位置が[Assets/Aparche Laboratory/VRC_MikuMikuDanceStation]ではない場合、正常な動作を保証できません。

Aparche Laboratoryの製品以外のコンポーネントをターゲットとして使用する場合、正常な動作を保証することはできません。

If the script of a component included in [VRC/Udon] Miku-Miku-Dance Station is customized to be different from the existing class name, correct operation cannot be guaranteed.

If the version of [VRC/Udon] Miku-Miku-Dance Station is lower than the recommended version, correct operation cannot be guaranteed.

If the path to the VRC_MikuMikuDanceStation folder is not [Assets/Aparche Laboratory/VRC_MikuMikuDanceStation], correct operation cannot be guaranteed.

Correct operation cannot be guaranteed if you use components that are not products of Aparche Laboratory.

[VRC/Udon] Miku-Miku-Dance Station에 포함된 컴포넌트의 스크립트를 기존 클래스명과 달라지도록 커스터마이징 한 경우, 정상적인 동작을 보장할 수 없습니다.

[VRC/Udon] Miku-Miku-Dance Station의 버전이 권장 버전보다 낮은 경우 정상적인 동작을 보장할 수 없습니다.

VRC_MikuMikuDanceStation폴더의 경로가 [Assets/Aparche Laboratory/VRC_MikuMikuDanceStation]로 되어있지 않은 경우 정상적인 동작을 보장할수 없습니다.

Aparche Laboratory의 제품이 아닌 컴포넌트를 대상으로 사용하는 경우 정상적인 동작을 보장할 수 없습니다.

Base Environment

- Unity 2022.3.22f1

- VRChat Creator Companion v2.4.0

- VRChat SDK 3.7.4

Recommend

[VRC/Udon] Full Screen System

https://aparchelabs.booth.pm/items/4703837

Latest Update

[2025.10.15]

<Full/PV>

Setup UdonSyncPlayer For PVメニュー機能に最新のフルスクリーン構造が反映されていない問題を修正

Fixed an issue where the latest Full-Screen structure was not reflected in the Setup UdonSyncPlayer For PV menu function.

Setup UdonSyncPlayer For PV 메뉴 기능에 최신 Full-Screen 구조가 반영되지 않은 문제 수정

Update History

[2025.09.14]

<Full/Core>

MikuMikuDance-StationアセットのDance Animator Localオプションの追加に関するコードの追加

Added code related to adding Dance Animator Local option for MikuMikuDance-Station asset.

MikuMikuDance-Station 에셋의 Dance Animator Local 옵션 추가와 관련된 코드 추가

[2025.03.16]

<Full/Core>

MMD Selectorのマイグレーション直後に[Aparche Laboratory> Setup Zoom Controller]コンテキストメニューからFocusZoomControllerをインストールするとFocusControllerとSliderの機能が正常に接続できない問題を修正しました。

Fixed an issue where the functions of FocusController and Slider were not properly connected when installing FocusZoomController through the [Aparche Laboratory > Setup Zoom Controller] context menu immediately after MMD Selector migration.

MMD Selector 마이그레이션 직후 [Aparche Laboratory > Setup Zoom Controller] 컨텍스트 메뉴를 통해 FocusZoomController를 설치할 때 FocusController와 Slider의 기능이 정상적으로 연결되지 못하는 이슈를 수정했습니다.

[2025.02.27]

コードファイルでUpdate - 2025.02.27コメントを検索して、修正項目を確認できます。

You can check the fixes by searching for the Update - 2025.02.27 comment in the code file.

코드 파일에서 Update - 2025.02.27 주석을 검색하여 수정사항을 확인할 수 있습니다.

<Full/Core>

1. MMD停止プロセス実行中にSelectedIndex同期された時、PV Culling Mask初期化が動作しない問題対応

1. Corrects an issue where PV Culling Mask initialization does not work when synchronizing SelectedIndex while the MMD stop process is running.

1. MMD 중지 프로세스 실행 중 SelectedIndex 동기화 시, PV Culling Mask 초기화가 동작하지 못하는 이슈 대응

[2025.02.18]

コードファイルでUpdate - 2025.02.18コメントを検索して、修正項目を確認できます。

You can check the fixes by searching for the Update - 2025.02.18 comment in the code file.

코드 파일에서 Update - 2025.02.18 주석을 검색하여 수정사항을 확인할 수 있습니다.

<Full/Core/PV>

1. PVプレーヤーの映像ロード状態を識別する方式をイベント呼び出し方式に変更

2. PVプレーヤーの映像ロード状態を表示するプログレスUI機能を追加

└MMD Selectorに[Setup UdonSyncPlayer For PV]が適用された状態で、[Setup UdonSyncPlayer Loading UI]を実行してください。

3. PVプレイヤーが異なるマテリアルを使用する複数のスクリーンへの映像送出をサポートするように修正（最新バージョンのFullScreenSystemへの対応）

1. Change the method of identifying the video loading status of the PV player to an event call method.

2. Add progress UI function to display video loading status of PV player

└With [Setup UdonSyncPlayer For PV] applied to the MMD Selector, run [Setup UdonSyncPlayer Loading UI].

3. Modified the PV player to support video transmission to multiple screens using different materials (supports the latest version of FullScreen System)

1. PV 플레이어의 영상 로딩 상태를 식별하는 방식을 이벤트 호출 방식으로 변경

2. PV 플레이어의 영상 로딩 상태를 표시하는 프로그레스 UI 기능을 추가

└MMD Selector에 [Setup UdonSyncPlayer For PV] 이 적용 된 상태로, [Setup UdonSyncPlayer Loading UI]을 실행해주세요.

3. PV 플레이어가 서로 다른 마테리얼을 사용하는 다수의 스크린에 영상 송출을 지원하도록 수정 (최신버전 FullScreenSystem 대응)

Included

[Full-Package]

└[Core]

　└VRC_MMDStation_Add-On_[date]_Core.zip

　　└Add-On/Core

　　　└(Component) UdonMMDOptionalStation

　　　└(ContextMenu) Jump To MMD Station

　　　└(ContextMenu) Migrating MMD Station

　　└Add-On/OptionalStation

　　　└[Sub-Prefab] for Core

　　　└(Component) UdonOptionalFocusController

　　　└(Component) UdonOptionalFocusButton

　　　└(Component) UdonOptionalFocusZoomReset

　　　└(ContextMenu) Setup MMD Position (Add+Sync)

　　　└(ContextMenu) Setup MMD Position (Sync Only)

　　　└(ContextMenu) Setup Zoom Controller (Add)

　└VRC_MMDStation_Add-On_[date]_HeightIndicator.zip

　　└Add-On/HeightIndicator

　　　└Prefabs for Core

　　　└(ContextMenu) Setup Height Indicator

└[PV Support]

　└VRC_MMDStation_Add-On_[date]_PVSupport.zip

　　└Add-On/UdonSyncPlayerForPV

　　　└Prefabs for Core

　　　└RenderTexture

　　　└Material for PV Screen

　　　└(Component) UdonSyncPlayerForPVBG

　　　└(Component) UdonMMDPresetUrl

　　　└(ContextMenu) Setup UdonSyncPlayer For PV

　　　└(ContextMenu) Setup UdonSyncPlayer Loading UI

　　　└(ContextMenu) Add PV-Config to Preset

└[Personal Station]

　└VRC_MMDStation_Add-On_[date]_PersonalStation.zip

　　└Add-On/PersonalStation

　　　└Prefabs

　　　└Sample Animator/UI

　　　└(Component) PersonalStationManager

　　　└(Component) PersonalStationCtrl

└[Full-Screen Installer]

　└VRC_MMDStation_Add-On_[date]_FSInstaller.zip

　　└Add-On/FullScreenSystemInstaller

　　　└(ContextMenu) Setup Full-Screen System

Functions

- Add-On/Core

└(ContextMenu) GameObject > Aparche Laboratory > Jump To MMD Station

└(ContextMenu) Window > Aparche Laboratory > Jump To MMD Station

シーンに配置されたUdonMMDSelectorまたはUdonMMDOptionalStationを自動的に識別し、そのオブジェクトを選択します。Hierarchyのどこからでも実行することができます。

Automatically identifies the UdonMMDSelector or UdonMMDOptionalStation placed in the scene and selects the object.

Can be called from anywhere in the Hierarchy.

씬에 배치된 UdonMMDSelector 혹은 UdonMMDOptionalStation을 자동으로 식별해 해당 오브젝트를 선택합니다. Hierarchy의 어디에서나 호출할 수 있습니다.

*************************************************************

- Add-On/Core

└(ContextMenu) MMD Selector > Aparche Laboratory > Migrating MMD Station

└(ContextMenu) Window > Aparche Laboratory > Migrating MMD Station

既存のMMD StationのUdonMMDSelectorコンポーネントをアドオン機能を使用するためのUdonMMDOptionalStationに移行します。移行しないと、アドオン機能は動作しません。

Zoom ControllerはUdonBehaviourの安定性の問題により移行段階で自動的に追加されないように変更されました。移行後、MMD Selectorを右クリックして[Aparche Laboratory>Setup Zoom Controller (Add)]で追加してください。

Migrate the UdonMMDSelector component of the existing MMD Station to UdonMMDOptionalStation to use the add-on function. If you do not Migrate, the add-on function will not work.

The Zoom Controller has been changed to not be automatically added during the migration step due to a stability issue with UdonBehaviour. After migration, right-click the MMD Selector and add it as [Aparche Laboratory>Setup Zoom Controller (Add)].

기존 MMD Station의 UdonMMDSelector 컴포넌트를 애드온 기능을 사용하기 위한 UdonMMDOptionalStation으로 마이그레이션 합니다. 해당 작업을 적용하지 않으면 애드온 기능은 동작하지 않습니다.

Zoom Controller 기능은 UdonBehaviour의 안정성 이슈로 인해 마이그레이션 단계에서 자동으로 추가되지 않도록 변경되었습니다. 마이그레이션 후 MMD Selector를 우클릭 하여 [Aparche Laboratory>Setup Zoom Controller (Add)] 로 추가해주세요.

*************************************************************

- Add-On/Core

└(Component) UdonMMDOptionalStation

アドオン機能を使用するための基となるコンポーネントです。[Migrating MMD Station]により従来使用されていた MMD Selector の UdonSharpBehaviour を継承する UdonMMDOptionalStation_Migrated コンポーネントが作成されます。

Add-On/OptionalStation のコンポーネントと連動して1人用のMMDを自動的にPositionCheckerが支援する最大人数で実行できるようにします。

同時にUdonOptionalFocusControllerと連動してカメラ画面の中心を特定のポジションのプレイヤーに変更することができます。

Zoom Controllerを追加するとカメラ画面の倍率を調整することもできます。

This is the basic component for using the Add-On function. [Migrating MMD Station] creates a UdonMMDOptionalStation_Migrated component that inherits the UdonSharpBehaviour of the previously used MMD Selector.

By linking with Add-On/OptionalStation components, single-person MMD can be automatically change with the maximum number of people supported by PositionChecker.

At the same time, by linking with UdonOptionalFocusController, you can change the center of the camera screen to the player in a specific position.

Adding a Zoom Controller also allows you to adjust the magnification of the camera screen.

Add-On 기능을 사용하기 위한 바탕이 되는 컴포넌트입니다. [Migrating MMD Station]에 의해 기존에 사용하던 MMD Selector의 UdonSharpBehaviour를 상속하는 UdonMMDOptionalStation_Migrated 컴포넌트가 생성됩니다.

Add-On/OptionalStation의 구성품과 연동하여 1인용 MMD를 자동으로 PositionChecker가 지원하는 최대 인원수로 실행할 수 있게 만듭니다.

동시에 UdonOptionalFocusController와 연동하여 카메라 화면의 중심을 특정 포지션의 플레이어로 변경할 수 있습니다.

Zoom Controller를 추가하면 카메라 화면의 배율을 조정할 수도 있습니다.

*************************************************************

- Add-On/OptionalStation

└(Component) UdonOptionalFocusController

└(Component) UdonOptionalFocusButton

UdonMMDOptionalStationと連動してカメラ画面の中心となる位置を制御します。

Controls the position of the center of the camera screen in conjunction with UdonMMDOptionalStation.

UdonMMDOptionalStation과 연동하여 카메라 화면의 중심될 포지션의 위치를 제어합니다.

*************************************************************

- Add-On/OptionalStation

└(Component) UdonOptionalFocusZoomReset

└(ContextMenu) MMD Selector > Aparche Laboratory > Setup Zoom Controller (Add)

UdonOptionalFocusControllerと連動してカメラ画面の倍率を調整するUIを生成し、ボタンイベントによって倍率を初期化します。

Creates a UI that adjusts the magnification of the camera screen in conjunction with UdonOptionalFocusController, and initializes the magnification through a button event.

UdonOptionalFocusController와 연동하여 카메라 화면의 배율을 조정하는 UI를 생성하고, 버튼 이벤트를 통해 배율을 초기화합니다.

*************************************************************

- Add-On/OptionalStation

└(ContextMenu) MMD Selector > Aparche Laboratory > Setup MMD Position (Add+Sync)

└(ContextMenu) MMD Selector > Aparche Laboratory > Setup MMD Position (Sync Only)

UdonMMDOptionalStationで管理するMMDに参加できる最大人数を変更します。

（Sync Only）メニューで、Dance Stations、Position Checkers、Player List、Optional Dance Stations、Optional Focus Buttonsの設定状態を統一し、（Add + Sync）メニューは同時に最大人数を1つ追加します。

NPC関連項目は変更しません。

Manages the number of positions in UdonMMDOptionalStation.

The (Sync Only) menu unifies the setting status of Dance Stations, Position Checkers, Player List, Optional Dance Stations, and Optional Focus Buttons, and the (Add+Sync) menu adds one position at the same time.

NPC-related settings will not be changed.

UdonMMDOptionalStation의 포지션 개수를 관리합니다.

(Sync Only) 메뉴를 통해 Dance Stations, Position Checkers, Player List, Optional Dance Stations, Optional Focus Buttons의 설정 상태를 통일하고, (Add+Sync) 메뉴는 동시에 포지션을 1개 추가합니다.

NPC 관련 항목은 변경하지 않습니다.

*************************************************************

- Add-On/HeightIndicator

└(ContextMenu) MMD Selector > Aparche Laboratory > Setup Height Indicator

プレーヤーアバターのHeightをワールドでVRChatが演算する値ではなく、MMDの標準値（実際のcm）で表示する機能を提供します。UdonMMDOptionalStationによって動作します。

Activates a function that displays the height of the player avatar in the world as MMD's standard value (actual cm) rather than the value calculated by VRChat. Operates by UdonMMDOptionalStation.

플레이어 아바타의 Height를 월드에서 VRChat에서 연산하는 값이 아닌 MMD의 표준 값(실제 cm)으로 표시해주는 기능을 활성화합니다. UdonMMDOptionalStation에 의해 동작합니다.

*************************************************************

- Add-On/UdonSyncPlayerForPV

└(Component) UdonSyncPlayerForPVBG

└(ContextMenu) MMD Selector > Aparche Laboratory > Setup UdonSyncPlayer For PV

PV背景映像を使用するMMDを再生する時に画面を表示するコンポーネントを追加し、UdonMMDOptionalStationと連携して実際の動作を制御します。

Add a component to display the screen when playing MMD that uses PV Background Movie, and control the actual operation by linking with UdonMMDOptionalStation.

PV 배경화면을 사용하는 MMD를 재생하였을 때 화면을 출력할 컴포넌트를 추가하고, UdonMMDOptionalStation과 연동하여 실제 동작을 제어합니다.

*************************************************************

- Add-On/UdonSyncPlayerForPV

└(Component) UdonSyncPlayerForPVBG

└(ContextMenu) MMD Selector > Aparche Laboratory > Setup UdonSyncPlayer Loading UI

PV壁紙画像の読み込みの進行状況を表示するCanvas UIを追加します。

Add Canvas UI to display the loading progress of the PV wallpaper video.

PV 배경화면 영상의 로딩 진행상태를 표시하는 Canvas UI를 추가합니다.

*************************************************************

- Add-On/UdonSyncPlayerForPV

└(Component) UdonMMDPresetUrl

└(ContextMenu) MMD Preset > Aparche Laboratory > Add PV-Config to Preset

この機能はUdonMMDInformationコンポーネントを使用するMMD Presetオブジェクトをターゲットとして機能します。

プリセットの子オブジェクトとしてPV映像のURL情報を設定できるプレハブを追加します。そのオブジェクトの有無でPV映像を使用するMMDかどうかを識別します。

This function operates on MMD Preset objects that use the UdonMMDInformation component.

Add a prefab that can set the URL information of the PV video as a child object of the preset. The presence or absence of the corresponding object identifies whether it is an MMD that uses PV video.

이 기능은 UdonMMDInformation 컴포넌트를 사용하는 MMD Preset 오브젝트를 대상으로 동작합니다.

프리셋의 자식 오브젝트로 PV 영상의 URL 정보를 설정할 수 있는 프리팹을 추가합니다. 해당 오브젝트의 유무로 PV 영상을 사용하는 MMD인지를 식별하게 됩니다.

*************************************************************

- Add-On/PersonalStation

MMDに参加しない観客プレイヤーのために用意された機能です。デスクトップ用に設定されたトグルキー、またはワールドに配置したUIボタンイベントにより、事前に設定しておいたモーションをワールドのどこでも実行できます。

付属のプリファブをシーンに配置するだけで適用できます。 Prefabの説明については、アドオンフォルダの[ReadMe]テキストファイルを参照してください。

This function is prepared for audience players who do not participate in MMD dances. You can execute preset motions anywhere in the world using toggle keys set for desktop or UI button events placed in the world.

It can be applied simply by placing the enclosed Prefab in the Scene. For an explanation of Prefab, please refer to the [ReadMe] text file in the add-on folder.

MMD 댄스에 참가하지 않는 관객 플레이어를 위해 준비 된 기능입니다. 데스크탑 용으로 설정 된 토글 키, 또는 월드에 배치한 UI 버튼 이벤트를 통해 사전에 설정해둔 모션을 월드의 어디에서나 실행할 수 있습니다.

동봉 된 Prefab을 Scene에 배치하는 것 만으로 적용이 가능합니다. Prefab에 대한 설명은 애드온 폴더의 [ReadMe] 텍스트 파일을 참고해주세요.

*************************************************************

- Add-On/FullScreenSystemInstaller

└(ContextMenu) GameObject > Aparche Laboratory > Setup Full-Screen System

└(ContextMenu) Window > Aparche Laboratory > Setup Full-Screen System

Hierarchyでシーンに配置された UdonMMDSelector または UdonMMDOptionalStation、および [VRC/Udon] Full Screen System の FullScreenSystem_CompletePack や FullScreenSystem_Unlit コンポーネントを使用する Full-Screen System を識別して動作します。

既存のMMD Station製品のダウンロードリストに含まれているマニュアルで案内した両方の製品の連動処理過程を自動的に設定します。

これを使用するためにUdonMMDSelectorをUdonMMDOptionalStationに移行する必要はありません。UdonMMDSelectorのままでも使用できます。ただし、UdonMMDOptionalStationを使用する予定の場合は、OptionalDanceStation機能との連携のために移行後に使用することをお勧めします。

It operates by identifying the Full-Screen System that uses FullScreenSystem_CompletePack or FullScreenSystem_Unlit component of the [VRC/Udon] Full Screen System, and the UdonMMDSelector or UdonMMDOptionalStation placed in the scene in the Hierarchy.

The link processing process for both products, as instructed in the manual included in the download list of the existing MMD Station product, is automatically set.

You can use UdonMMDSelector without necessarily migrating it to UdonMMDOptionalStation. However, if you plan to use UdonMMDOptionalStation, it is recommended to use it after migration to link with the OptionalDanceStation function.

Hierarchy에서 씬에 배치된 UdonMMDSelector 또는 UdonMMDOptionalStation, 그리고 [VRC/Udon] Full Screen System의 FullScreenSystem_CompletePack나 FullScreenSystem_Unlit 컴포넌트를 사용하는 Full-Screen System을 식별하여 동작합니다.

기존 MMD Station 상품의 다운로드 리스트에 포함된 매뉴얼에서 안내한 두 제품의 연동 처리 과정을 모두 자동으로 설정합니다.

반드시 UdonMMDSelector를 UdonMMDOptionalStation으로 마이그레이션 하지 않아도 사용할 수 있습니다. 단, UdonMMDOptionalStation를 사용할 예정이라면 OptionalDanceStation 기능과의 연동을 위해 마이그레이션 후에 사용하는 것이 좋습니다.

Demo MMD Credit

[Music]

煮ル果実 - Traffic Jam

https://www.youtube.com/watch?v=oUevY6uH4Qg&t=0s

[Remix]

john

https://www.bilibili.com/video/BV1dJ41177sz/

[Motion/Camera/Stage]

卜逻desu

https://www.bilibili.com/video/BV1j34y1W7Bo/

[Choreography]

溜一口兮

https://www.bilibili.com/video/BV1cE411Y7oe/

[Avatar]

オリジナル3Dモデル「しなの」 - ポンデロニウム研究所

https://ponderogen.booth.pm/items/6106863

[Hair]

Evergrace_Bunny_Hair - cherry neru

https://neru0606.booth.pm/items/6115027