Skip to content

Oyasumi Expression Menu

Raphii edited this page Oct 28, 2022 · 9 revisions

Some Oyasumi features can be controlled over OSC. Because of this, it is possible to control these features from the expression menu on your avatar. A premade asset was made that you can use to add this functionality to your avatar. This page will go over how to install this on your avatar.

For more information on how exactly these features are controlled over OSC, please check out the page on "Controlling Oyasumi over OSC".

Preview:

English 日本語

Installation Guide

1. Import the package

  1. First of all, download the latest Unity Package for the expression menu.

  2. Import the package, by dragging it into Unity.
    image

2. Setting Menu Parameters

You have to add the required menu parameters to your avatar. How to do this depends on if you already have menu parameters set for your avatar.

a. No existing menu parameters

If your avatar does not have any existing menu parameters, you can simply drag the OyasumiParameters right into the Parameters slot on your VRC Avatar Descriptor.

chrome_rCxTkTpss4

b. Merge parameters with VRCAvatar3Tools

If your avatar already has menu parameters, you need to add Oyasumi's parameters to them. The easiest way to do this is with AvatarTools3.

You can do this as follows:

  1. Download VRCAvatar3Tools and import the Unity package like you did for Oyasumi's expression menu.

  2. From the menu bar, choose VRCAvatars3Tools -> ExpressionParametersCombiner
    image

  3. In the "Src ExpressionParameters" put the OyasumiParameters object, In "Dst ExpressionParameters" put your existing menu parameters object, then click "Combine".
    image

c. Add the parameters by hand

Alternatively, if you already have menu parameters on your avatar, you can add Oyasumi's required parameters manually.

Open your existing menu parameters, and add the parameters from OyasumiParameters to the end of your existing list. They should look something as follows: image

3. Adding the menu

Like with the menu parameters, how to add the menu to your avatar depends on if your avatar already has an expression menu for it set up.

a. No existing expression menu

If your avatar does not have any existing expression menu, you can simply drag the desired menu right into the Menu slot on your VRC Avatar Descriptor.

There is one menu included for each language. Assuming you want the English menu, use OyasumiMenuEN.

chrome_7gBddiKFgv

b. Add a submenu to your existing expression menu

If your avatar already has an expression menu, you probably want to add Oyasumi's expression menu as a submenu. You do this as follows

  1. Open your existing menu and add a new control
    image

  2. Configure the control as a submenu
    For "Name", we'll pick "Oyasumi", but you can set anything you want here.
    For "Type", select "Sub Menu".
    For "Sub Menu", put in the Oyasumi menu for the language you want to use. Assuming you want the English menu, use OyasumiMenuEN.
    For "Icon", you can optionally set the Oyasumi icon. You'll find it under Oyasumi/ExpressionMenu/Icons/OyasumiIconLogo.
    image

4. You're done!

Clone this wiki locally