> For the complete documentation index, see [llms.txt](https://vrchat-community-document.gitbook.io/go/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://vrchat-community-document.gitbook.io/go/guides/particle-limiter.md).

# Particle Limiter

VRChat has introduced a Particle Limiting System on June 19, 2018. This Feature allows you to limit the maximum values of particle specific settings without completely hiding them through the trust system. 

This means that you are still able to see most particle animations while having a smaller risk of being crashed or obtaining lagg.

To use the Particle limiter system, add a file called **config.json** to **%AppData%\\..\LocalLow\VRChat\vrchat** and give it the following content:

{% hint style="warning" %}
Do not set any of these values to 0! It can cause avatars to fail loading and load the red error model instead!

Please keep in mind you will need to restart your game for changes to take effect.
{% endhint %}

{% code title="config.json" %}

```
{
	"betas": [
		"particle_system_limiter"
	],
	"ps_max_particles": 50000,
	"ps_max_systems": 200,
	"ps_max_emission": 5000,
	"ps_max_total_emission": 40000,
	"ps_mesh_particle_divider": 60,
	"ps_mesh_particle_poly_limit": 50000,
	"ps_collision_penalty_high": 50,
	"ps_collision_penalty_med": 30,
	"ps_collision_penalty_low": 10,
	"ps_trails_penalty": 10
}
```

{% endcode %}

### Limiter Configuration Description

| Value Name                    | Explanation                                                                                                                                                                       |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `betas`                       | Adding or removing the string "particle\_system\_limiter" will enable/disable the Limiter system                                                                                  |
| `ps_max_particles`            | Max particles a single particle system can spawn                                                                                                                                  |
| `ps_max_emission`             | Max emission a single particle system is allowed                                                                                                                                  |
| `ps_max_total_emission`       | Max emission allowed between all particle systems on an avatar                                                                                                                    |
| `ps_mesh_particle_divider`    | The mesh particle penalty is calculated using the highest poly mesh on them divided by this value, the resulting value divides the max particle allowance for the particle system |
| `ps_mesh_particle_poly_limit` | The max poly count a mesh on a particle system can be                                                                                                                             |
| `ps_collision_penalty_high`   | The penalty for high quality collision on a particle system, the resulting value divides the max particle allowance for the particle system                                       |
| `ps_collision_penalty_med`    | The penalty for medium quality collision on a particle system, the resulting value divides the max particle allowance for the particle system                                     |
| `ps_collision_penalty_low`    | The penalty for low quality collision on a particle system, the resulting value divides the max particle allowance for the particle system                                        |
| `ps_trails_penalty`           | The penalty for having trails enabled on the particle system, the resulting value divides the max particle allowance for the particle system                                      |