Profiles and the Parameter Budget
After reading this page, you will know what Smooth, Compact, and Auto do differently and can decide what to cut when the budget runs out.
The two things VRChat counts
The Expression Parameters an avatar uses are counted along two axes. They are separate limits.
| Axis | Ceiling MLC uses |
|---|---|
| Synced bits — what is sent to other users | 256 |
| Parameter entries — how many parameters are registered | 8192 |
The whole avatar shares this budget. MLC reads whatever is already spent outside MLC as the foreign budget and plans within the room that is left.
Profile sits in the Quick Start card of the component inspector and is one of Auto, Smooth, or Compact.
Smooth
Sends the value as it is.
| Kind of feature | Synced bits | Synced entries |
|---|---|---|
| On/off item | 1 | 1 |
| Value item | 8 | 1 |
Few entries, and the value moves smoothly. In exchange, each value costs 8 bits.
Compact
Sends a value item as several on/off parameters split by Gray code, and rebuilds the single value on the receiving side.
The bit count is the smallest number that can hold that item's bin count.
| Bins | Synced bits |
|---|---|
| 8 | 3 |
| 16 | 4 |
One value item uses that many synced entries plus one local entry to hold the rebuilt value. In other words, Compact spends fewer bits and more entries.
A value item with fewer than two bins cannot be synced in Compact. Selecting it shows this notice.
This float has fewer than two compact bins and cannot sync in Compact. It becomes local-only at install time.
Auto
Auto looks at the foreign budget and the target budget together and chooses like this:
- If Smooth fits, Smooth.
- If it does not, Compact.
- If neither fits, planning fails and a message reporting the cost of both profiles is shown.
Choosing Smooth or Compact yourself means no substitution happens. If that profile goes over budget, it simply fails.
Numbers for the default catalog
Measured with all 23 features of the default catalog enabled.
| Profile | Synced bits | Parameter entries |
|---|---|---|
| Smooth | 92 | 23 (22 synced + 1 local) |
| Compact | 44 | 55 (44 synced + 11 local) |
Turn features off and both numbers drop together. The table above holds only for "the default configuration, untouched".
Turning Synced off
Turn Synced off in Selected Item Settings and that value changes on your own screen only; it is not sent to other users.
- Synced bits: 0
- Parameter entries: 1 local entry
For values only you see, such as corrections used for photography, this saves a large number of bits.
Turning Animated off or pinning a value
Turn Animated off and that feature applies one fixed value at install time, building neither a menu item nor a parameter. The tooltip puts it plainly.
OFF applies one fixed value at install time, reducing menu, Animator layer, and parameter output.
A feature frozen with Pin To Value builds no parameter either. In both cases the synced bits and parameter entries go to 0.
Clear a feature's Enabled altogether and it drops out of both the menu and the budget.
When bits run short: (1) turn Synced off for values only you use, (2) clear Enabled on features you do not use, (3) turn Animated off for features whose value can stay fixed, (4) switch the profile to Compact. When entries run short, reverse step 4 and go back toward Smooth.
Target Synced Bits and Target Parameter Entries
Both values sit in Advanced Options. Both are ceilings for the whole avatar, not MLC's share.
| Item | At 0 | Otherwise |
|---|---|---|
Target Synced Bits | Uses the remaining VRC budget automatically | Bit ceiling for the whole avatar |
Target Parameter Entries | Uses the VRC maximum | Entry ceiling for the whole avatar |
Force Install With Unknown Budget, in the same place, assumes an empty foreign budget when the existing VRC parameters cannot be read. The tooltip nails down the condition.
Assume an empty foreign budget when existing VRC parameters cannot be inspected. Enable only after manual verification.
Reading the Budget & Validation card
The Budget & Validation section of the component inspector has four lines.
| Line | Meaning |
|---|---|
Synced Bits | Smooth 92 / Compact 44 (budget 256) — the cost of both profiles for the current menu layout, and the ceiling |
Avatar Total | Foreign … bits / … entries + MLC (target …, …) — what is already spent outside MLC, and the targets |
Selected | The profile actually chosen and its cost. If planning fails, Over budget / cannot generate |
Enabled Features | enabled count / total count |
The Calculate Budget / Select Profile button in the MLC window (StudioRaming > Ming Light Controller > Open) runs the same calculation.
To check it:
- Select the avatar root in the Hierarchy to open the Ming Light Controller inspector.
- This is correct. The inspector shows the
Quick Start·Menu Layout·Selected Item Settings·Budget & Validation·Advanced Optionscards.
- This is correct. The inspector shows the
- Open the
Budget & Validationcard.- This is correct. The four lines
Synced Bits·Avatar Total·Selected·Enabled Featuresare visible.
- This is correct. The four lines
- Read the
Selectedline.- This is correct. It shows
SmoothorCompactwith its cost, and there is no red error box. If it readsOver budget / cannot generate, go to "When you go over budget" below.
- This is correct. It shows
When you go over budget
The card shows one of two messages.
Both profiles over budget (error)
Both profiles exceed the synced budget. Disable features or make some local-only by turning Synced off.
Smooth only over budget (warning)
Smooth exceeds the budget. Use Compact or reduce the enabled features.
When Selected reads Over budget / cannot generate, an error box below it says which profile is short and by how much. Read that number and cut down in the order given above.
Before touching features one at a time, trying a Starting Preset is also an option. The two presets do different things, though.
Bit Saving— the enabled features are the same asRecommended; it only pins the profile toCompact. Bits go down and parameter entries go up.Performance— turns off the virtual light, the shared colors, master adjust, and the photo look bits, leaving only the performance items and the commands. The number of enabled features itself drops sharply.
A preset overwrites the current configuration. Applying one erases every per-feature setting you had saved, replaces the whole menu layout, and returns Target Synced Bits and Target Parameter Entries to 0. If you have a configuration you tuned by hand, check it before applying. Undo reverses it.