Hello Creators,
Today, we’re expanding Avatar Settings to give you greater control over the look and behavior of player avatars in your experiences.
Ensuring fair and consistent gameplay can be a challenge when players enter your experience with a wide range of avatar shapes and sizes. Previously, if you were building an experience where predictable avatar sizing and behavior were important, you had to script custom solutions. Now, Avatar Settings can help you ensure consistent avatar behavior without the need for manual work. Our goal for Avatar Settings is to empower you to create a wider range of high-quality experiences while allowing your players to express themselves.
How Your Experiences Can Benefit
Avatar Settings aims to:
-
Improve consistency while supporting player expression: Let users bring in their personalized avatars while establishing rules for avatar bodies, clothing and accessories.
-
Enable fair play in competitive experiences: Give avatars a consistent height and a uniform collider to ensure that competitive games can be played on an equal footing.
-
Minimize or eliminate custom work: Reduce the need for complex custom scripts to manage avatar consistency and UGC.
Getting Started
The new Avatar Settings UI is available today! You can find it by selecting Avatar Settings from the main Studio File menu or by navigating to the Avatar Tab in Roblox Studio and selecting the Avatar Settings icon.
Avatar Settings opens next to the viewport. Like Game Settings, you will need to Save your place to Roblox to access the controls.
Key Features
This initial release of Avatar Settings focuses on some of the most acute problems you’ve faced with gameplay consistency, including avatar size, physics/collision behavior, and clothing/accessories.
-
A new non-modal window with a preview lineup: Allows you to edit, preview, and test your changes before publishing them to your live experience!
-
Simple Presets to get started quickly: At launch, we have two presets:
-
Player Choice - leaves player avatars unmodified and exactly as the user intended.
-
Consistent Gameplay - makes avatars the same height and uses a single box collider for consistent collision and physics behavior.
-
-
Controls to customize the Avatar Body, including proportions, parts, and a new Custom Scale control. When you set a specific height or range, Avatars are scaled to that height while maintaining their proportions.
-
Clothing & Accessory Controls:
-
Manage overly large items based on how far they extend from the avatar’s body:
Please note: Unfortunately, we discovered a bug impacting clothing controls. Because of this, we have put this update on hold. Accessory settings will continue to work as intended. We will update you once a fix has been rolled out. -
Remove or Replace items based on their category (e.g., replace all hats):
-
-
Consistent Collision & Physics: Use a uniform collision box for all avatars, regardless of visual appearance. This gives avatars consistent mass, physics and (optionally) hit and touch detection.
-
Animation Controls to customize and preview animations for Roblox’s default locomotion.
And more! You can find full documentation here!
What’s Next?
We will make further enhancements based on your feedback and evolving platform needs. This includes exploring deeper integration with other avatar systems and more advanced appearance adaptation techniques.
We Want Your Feedback!
Please try out the new settings and let us know what you think! Your feedback is crucial as we continue to develop and refine this feature. Share your thoughts, use cases, and any issues you encounter in the thread below.
- What experiences will these settings help you build or improve?
- What other critical controls do you need for avatar/gameplay consistency?
Thank you!
The Avatar Settings Team
FAQs
Will my experience change or break with this update?
-
No, by default Avatar Settings will be backwards compatible with your current experience settings. Opting into certain features can change the avatar’s data and may require script updates (some examples are included here). Please let us know if you run into any unexpected issues by replying to this post.
-
Using Single Collider
-
Make sure to adjust the collider size based on your avatar height selection. For example, making avatars very small while leaving the collider size large could create unexpected physics behaviors.
-
If you have a script that expects HumanoidRootPart, UpperTorso, or LowerTorso to be collidable, you will need to update it.
-
If you check for exact parts in the model hierarchy, e.g. to detect cheating, note that Single Collider adds an invisible “CollisionPart” under the avatar’s HumanoidRootPart at runtime.
-
-
Using Custom Scale or Consistent Gameplay Preset
- If you have a script that calculates the character’s height, e.g. to do raycasts, you will need to update it to directly use the Settings height value. This is because your script may run before the scale changes to Humanoid have updated the avatar’s size.
-
Did you deprecate any of the old avatar controls?
- No, all of the original Game Settings avatar controls are still available in the new UI for backward compatibility. The Game Settings window now points to the new location:
Does this impact the StarterCharacter workflow?
- No, as before, using Avatar Settings does not impact the custom StarterCharacter workflow. If your experience uses a StarterCharacter, Avatar Settings will not have an effect.
I tried out the new Scale control and made avatars a consistent height - why do I still see smaller UGC avatars in my game?
- Some UGC bodies may still be using workarounds to our UGC Validation requirements, so they could appear smaller than expected. This will be solved with upcoming improvements to our validation process, but please report any unexpected results below and we will investigate.
