docs: update MA Parameters docs (#1351)

docs~/docs/reference/parameters.md

@@ -14,36 +14,50 @@ than VRChat builtins.
 
 ## How do I use it?
 
-### Setting defaults
+Each entry in the MA Parameters list configures a single parameter, or a prefix used for a VRChat PhysBone.
+You set the name (or prefix) in the top row, with the type of parameter next to it.
 
-The parameters UI shows each parameter initially in a collapsed view. This view makes it easy to set the default values
+### Parameter types
-for each parameter, and whether they are saved when you change avatars, or change worlds. Setting a non-blank default
-value will override the value in the main Expressions Parameters asset, if any.
 
-You can set a blank value here as well; this can be useful if multiple MA Parameters components define the same
+The parameter type field in the upper right can be set to any of the following:
-parameter, where the "default value" field will ignore any MA Parameters component which does not set a default.
-Setting default values for the same parameter in multiple Parameters components will result in a warning, as it's
-unclear which should be used.
 
-For the "Saved" option, generally speaking the parameter will be saved if any MA Parameters component sets it to be
+* Bool
-saved. However, there is an exception; see the section on "Nesting" for more information. Note also that the "Saved"
+* Int
-setting will be enabled if either MA Parameters or the original Expression Parameters asset enables saving for the
+* Float
-parameter.
+* Animator Only
+* PB Prefix
 
-Normally, the default values you set will only affect the Expressions Parameters settings for your avatar. However,
+If you select Animator Only, the parameter will not be added to the Expressions Parameters list. However, it will still
-you can override the default values for the _animator_ itself by either setting the "Parameter Type" to "Animator Only",
+be able to rename the parameter in question, as described below.
-or by enabling the "Override Animator Defaults" checkbox (note that this is ignored for animator only parameters).
+
+The PB Prefix setting is used when this parameter prefix is set in a PhysBones component. As with Animator Only, this will
+not be added to the Expressions Parameters list.
 
 ### Renaming parameters
 
-By setting the "Change name to" field you can _rename_ a parameter. That is, if you have a parameter "foo", which has
+If you enter a name in the "Change name to" field, the parameter will be renamed to that name for anything _outside_
-a "Change name to" setting of "bar", then on the object with the MA Parameters component and its children you can
+of the MA Parameters object and its children. This can be useful for avoiding conflicts between different gimmicks,
-refer to this parameter as "foo" (eg in [MA Menu Item](menu-item.md), [MA Merge Animator](merge-animator.md), or in
+or conversely, deliberately connecting two different gimmicks by making them use the same parameter.
-VRChat Contact Receivers); however, outside of this object, the parameter will be referred to as "bar".
 
-By renaming parameters on multiple components to use the same name, you can wire up one gimmick to trigger another.
+You can also click the "Auto rename" box to have Modular Avatar automatically select an unused name for you.
-You can also select "Auto Rename" to have Modular Avatar automatically select an unused name; this will help avoid
+
-accidental name collisions between different gimmicks.
+### Default values
+
+You can set a default value for each parameter. This value will be used when you avatar is reset. If you leave the
+default box blank, then the value (if any) in the main Expressions Parameters asset will be used, or otherwise zero (or
+false) will be used.
+
+If you click the "Override Animator Defaults" box, then any default values specified in the _animator controller_ of
+your asset will be changed to this default. This is occasionally useful with particularly complex gimmicks. If you
+selected "Animator Only" and specified a default value, then this box will be ignored, and the animator controller
+default will always be replaced.
+
+### Saved/Synced
+
+The Saved box controls whether the parameter will be saved across avatar changes and restarting VRChat.
+
+The Synced box controls whether the parameter will be synced across the network. If you clear this box, this parameter
+won't use your limited parameter space.
 
 ### Creating new parameters
 
@@ -58,18 +72,6 @@ Either way, after creating the parameter, click the chevron next to the new para
 There, you can set the parameter type (which controls whether the parameter is synced), and other attributes of the
 parameter.
 
-### PhysBones and Contacts
-
-MA Parameters can rename parameters used by VRChat PhysBone components and Contact Receivers. For PhysBones, enter the
-prefix (the value in the "Parameter" field of the VRC Phys Bone component) as the parameter name, and click the
-"Is PhysBone Prefix" option. This will be automatically set if you add it via the "Unregistered Parameters" section.
-
-### Expression Parameters
-
-Set the "Parameter type" field to register the parameter in the VRC Expressions Parameters list. This will sync the
-parameter over the network, and allow for it to be used in the expressions menu and in OSC. If you don't need the
-parameter to be synced, click "Local Only". 
-
 ### Nesting
 
 MA Parameters components can be nested. This lets you build up a complex system out of multiple subcomponents. Each

docs~/i18n/ja/docusaurus-plugin-content-docs/current/reference/parameters.md

@@ -12,32 +12,45 @@ VRChatが提供するパラメーター以外の、自分で定義するパラ
 
 ## 使い方
 
-### 初期値を設定する
+MA Parametersリストの各エントリーは、一つのパラメーター、またはVRChatのPhysBoneの前置詞を指定します。上段に名前（または前置詞）を、
+その横にパラメーターの型を設定します。
 
-ParametersのUIは最初はたたんだ状態でパラメーター情報を表示します。この表示では初期値と、アバター変更やワールド移動でで保存されるかを
+### パラメーター型
-設定できます。空以外の設定だと、Expressions Parametersに設定された初期値も上書きします。
 
-複数のMA Parametersで同じパラメーターが設定された場合は、初期値を空欄にするのが便利です。設定されたところだけ初期値に関与します。
+右上のパラメーター型欄には、以下のいずれかを設定できます。
-なお、複数のMA Parametersコンポーネントで同じパラメーターの初期値を設定してしまうと初期値が不定になるため注意がでます。
 
-「保存する」設定に関しては、どれか一つのMA Parametersで有効になっている場合は保存状態となります。しかし、例外もあります。詳しくは
+* Bool
-「入れ子にする」に参照。なお、Expressions ParametersとMA Parameters両方に定義される場合は、どちらか（あるいは両方）に「保存する」が
+* Int
-有効になっていると、保存される扱いとなります。
+* Float
+* Animatorのみ
+* PB前置詞
 
-普段は設定した初期値はアバターのExpressions Parameters設定のみに適用されます。ただし、「パラメーター型」を「Animatorのみ」に設定するか、
+「Animatorのみ」を選択すると、そのパラメーターはExpressions Parametersリストに追加されません。ただし、下記の名前変更はできます。
-「アニメーターの初期値を設定」を有効にすることで、アニメーター自体の初期値を上書きすることができます。なお、「アニメーターの初期値を設定」は
-「アニメーターのみ」の場合無視されます。
 
-### 名前を変更
+「PB前置詞」設定は、このパラメーター前置詞がPhysBonesコンポー年tおに設定されている場合に使います。Animatorのみと同様、Expressions Parameters
+リストには追加されません。
 
-「名前を変更」欄に新しい名前を入れると、パラメーターのリネームができます。たとえば、「hoge」という名のパラメーターに、「piyo」という
+### パラメーターのリネーム
-「名前を変更」設定を入れると、MA Parametersコンポーネントのあるオブジェクトとその子では「hoge」として参照できます。その中の
-[MA Menu Item](menu-item.md)、[MA Merge Animator](merge-animator.md)、VRChat Contact Receiverなどは「hoge」で扱うわけです。
-しかし、そのオブジェクトの外では、「piyo」として扱われます。
 
-複数のMA Parametersで名前がかぶるように設定すると、一つのギミックで別のギミックを制御するように連動させることができたりします。
+「名前を変更」欄に新しい名前を入れると、そのパラメーターはMA Parametersオブジェクトとその子の外ではその名前として扱われます。これは、
-また、「自動リネーム」を設定すれば、Modular Avatarに自動的に衝突しない名前を選択してもらえます。これで意図してない名前の衝突を避ける
+異なるギミック間の衝突を避けるために使ったり、逆に同じパラメーターを使って二つのギミックを連動させるために使うことができます。
-ことができます。
+
+「自動リネーム」をクリックすると、使われていない名前が自動的に選択されます。
+
+### 初期値
+
+各パラメーターには初期値を設定できます。この値はアバターをリセットしたときに使われます。初期値を空欄にすると、アバターのExpressions Parameters
+アセットに設定された値が使われます。それもない場合は、0（またはfalse）が使われます。
+
+「アニメーターでの初期値を設定」を有効にすると、アニメーターコントローラーの初期値を上書きします。一部複雑なギミックを作る際に便利です。
+「Animatorのみ」を選択して初期値を設定した場合は、この設定は無視され、常にアニメーターコントローラーの初期値が上書きされます。
+
+### 保存・同期
+
+「保存する」設定は、パラメーターがアバター変更やVRChat再起動時に保存されるかを設定します。
+
+「同期する」設定は、パラメーターがネットワーク経由で同期されるかを設定します。この設定をクリアすると、パラメーターはネットワーク上での
+パラメーター数を消費しません。
 
 ### パラメーターの新規作成
 
@@ -49,17 +62,6 @@ ParametersのUIは最初はたたんだ状態でパラメーター情報を表
 
 どのみち、パラメーターを作ったら▶を押せば詳細画面を開けます。そこで同期状態をつかさどるパラメーター型を設定したり、その他詳細設定ができます。
 
-### PhysBoneやContact
-
-MA ParametersはVRC Phys BoneやContact Receiverコンポーネントにも対応しています。PhysBonesの場合は、VRC Phys Boneコンポーネント
-の「Parameter」欄にも登録されている、前置詞をパラメーター名にしてから、「PhysBone前置詞名」を有効にしてください。なお、
-「未登録パラメーター」のリストから追加する場合は自動的に設定されます。
-
-### Expression Parameters
-
-VRC Expression Parametersに登録する場合は、「パラメーター型」を設定してください。ネットワーク経由で同期されるようになり、
-Expressions Menu（アクションメニュー）やOSCで使えるようになります。ネットワーク同期が不要の場合は「Local Only」を設定してくささい。
-
 ### 入れ子にする
 
 MA Parametersコンポーネントは入れ子状態にできます。これで複雑なシステムを、複数のモジュールから組み上げることができます。