> ## Documentation Index
> Fetch the complete documentation index at: https://help.freakhosting.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to Change Maximum Player Capacity in BeamMP

> Master the relationship between community scale and soft-body physics performance. Learn how to calibrate the MaxPlayers limit for your BeamMP server.

## Scaling Your Community Convoy

BeamMP (BeamNG.drive Multiplayer) is uniquely demanding due to the engine's proprietary soft-body physics system. Unlike traditional racing simulations, the server node must programmatically synchronize every physical deformation, component failure, and collision state for every vehicle in real-time. Because of this architectural complexity, each additional player introduces a significant increase in CPU overhead. Balancing your player limit is the most critical technical decision for ensuring a smooth, low-jitter experience for your community.

<CardGroup cols={2}>
  <Card title="Difficulty" icon="gauge-low">
    Beginner
  </Card>

  <Card title="Time" icon="clock">
    3 Minutes
  </Card>
</CardGroup>

***

## Technical Configuration Workflow

The player capacity is governed exclusively by your core server configuration registry.

<Steps>
  <Step title="Initialize Maintenance">
    Log in to the [Game Panel](https://games.freakhosting.com) and **Stop** your server to prevent configuration overwrites.
  </Step>

  <Step title="Open the Registry">
    Navigate to the **Files** tab and open the `ServerConfig.toml` file.
  </Step>

  <Step title="Adjust the Slot Limit">
    Locate the `MaxPlayers` parameter. Change the numeric value to your desired capacity (e.g., `MaxPlayers = 12`).
  </Step>

  <Step title="Initialize Growth">
    Save the file and **Start** your server. The new capacity will be broadcast to the global masterlist instantly.
  </Step>
</Steps>

***

## Infrastructure Performance Tiers

To maintain absolute simulation integrity, we recommend the following capacity thresholds based on your FREAKHOSTING infrastructure.

| Participant Count  | Technical Profile                                                        | Recommended Hosting            |
| :----------------- | :----------------------------------------------------------------------- | :----------------------------- |
| **1 - 8 Players**  | **Optimized:** Negligible impact on world physics.                       | Standard VPS / Game Plan.      |
| **8 - 16 Players** | **Demanding:** Requires high-frequency single-core throughput.           | **FREAKHOSTING Extreme.**      |
| **20+ Players**    | **Experimental:** High probability of network jitter and physics desync. | Dedicated Node Infrastructure. |

<Warning>
  ### Physics Desynchronization

  Regardless of hardware power, BeamMP's networking stack has logical limits. Once you exceed 20 simultaneous players, you will likely observe "Rubber-banding" and delayed crash results. This occurs because the engine must broadcast thousands of vertex updates per second, which can saturate the participants' downstream bandwidth.
</Warning>

***

<Note>
  ### Need Extra Help?

  If you encounter any issues, our support team is ready to assist:

  * **Live Chat:** Quick assistance via our website.
  * **Support Ticket:** [Open a Ticket](https://freakhosting.com/clientarea/submitticket.php)
  * **Discord:** [Join our Community](https://discord.gg/freakhosting)
  * **Email:** [support@freakhosting.com](mailto:support@freakhosting.com)
</Note>

<Tip>
  ### Save on Your Hosting

  Ready to get a new server? Use code **KB20** at checkout for **20% off** your first month!
</Tip>

***

<div align="center">
  **Last Updated:** January 2026 | **Physics:** High stakes, high load.
</div>