Fixing Billiard Balls Spinning Infinitely in MassFX

Published on January 08, 2026 | Translated from Spanish
Billiard simulation in MassFX showing balls with controlled rotation and correctly configured friction parameters

The Mystery of Eternally Spinning Billiard Balls

This issue of balls continuing to spin like tops after hundreds of frames is more common than you think in MassFX, especially in billiard simulations where we expect the balls to stop naturally. The behavior you describe indicates that the friction and damping system is not working correctly, allowing rotational energy to be maintained almost indefinitely instead of dissipating gradually as it would in reality.

The problem is usually not in the ball mesh (unless you have extremely low geometry), but in a specific combination of friction and damping parameters that are not balanced to correctly simulate real billiard table surfaces. In a professional billiard table, the balls stop relatively quickly due to friction with the table cloth and air resistance.

In MassFX, a ball that spins forever is like a physicist's dream: all energy is perfectly conserved, but zero friction with reality

Critical Angular Damping Settings

The most important parameter to solve your problem is Angular Damping. This specifically controls how the rotational energy of your balls dissipates.

Realistic Friction Configuration

Friction in MassFX has two components: static and dynamic. For billiard balls, you need specific values.

Static friction controls how much force is needed to start movement, while dynamic friction controls resistance during movement 😊

MassFX Solver Optimization

MassFX's global solver parameters may be contributing to the problem. Suboptimal values create unrealistic simulations.

Go to the Utilities panel > MassFX Tools and adjust the solver parameters for better stability and realism.

Sleeping Parameters Configuration

MassFX has a "sleeping" system that puts objects to rest to optimize performance. If not properly configured, the balls never "sleep".

In the Rigid Body properties, look for the Sleeping section and adjust the thresholds so they correctly detect when the balls should stop simulating.

Mass Properties Verification

The mass of your balls directly affects how they respond to friction forces. Balls that are too light or too heavy behave unrealistically.

Use realistic masses for billiard balls (approximately 0.17 kg each) and ensure all have consistent masses.

Collision Issues Troubleshooting

If the balls are not colliding correctly with the table, they may be "floating" slightly, reducing effective friction.

Verify that both the balls and the table have their collision shapes correctly configured and there is no excessive penetration.

Bake and Reset Method

If you've made many adjustments, sometimes it's better to completely reset the simulation and do a new bake with the corrected parameters.

Delete the existing simulation bake, reset all balls to their initial position, and apply a new bake with the optimized parameters.

Geometry Optimization for Physics

Although you mention it's probably not the mesh, in some cases the geometry can affect physical behavior.

Verify that your balls have enough geometry for precise collision calculations, but not so much that it unnecessarily slows down the simulation.

Recommended Values for Billiards

This combination of parameters usually works well for realistic billiard simulations in MassFX.

Start with these values as a base and adjust according to the specific behavior you observe in your simulation.

Solution Workflow

Follow this orderly process to identify and resolve the problem efficiently.

Work methodically, changing one parameter at a time and testing to understand exactly which adjustment solves the problem.

Prevention for Future Simulations

Once the problem is solved, implement these practices to avoid similar situations in the future.

Creating a preset or template with the optimized parameters will save you time in future projects.

After applying these solutions, your billiard balls should stop naturally after a few seconds of simulation, creating the realism you're looking for in your activity... and best of all, you'll have mastered one of the most subtle but important aspects of physics in MassFX 🎱