> ## 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.

# Understanding OneSync Infinity vs. Legacy in FiveM

> Compare OneSync Infinity and Legacy modes in FiveM. Learn the differences for player synchronization, entity streaming, and high-population networking.

## Scaling Your Server Infrastructure

OneSync is the proprietary technical framework that enables FiveM servers to surpass the original 32-player limitation inherent in the GTA V engine. However, selecting the appropriate synchronization mode is a critical architectural decision. Your choice between **Legacy** and **Infinity** fundamentally dictates how player data is broadcast across the network and determines the compatibility requirements for your custom scripts. This guide ensure you select the optimal mode for your community's growth.

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

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

***

## Technical Mode Comparison

Choosing the correct mode depends on your target player population and the age of your resource library.

<Tabs>
  <Tab title="OneSync Legacy">
    * **Capacity:** Limited to **48 slots**.
    * **Synchronization Logic:** Global. Every connected player's entity data is broadcast to every other player's client simultaneously. You can "see" a player's metadata regardless of their distance from you.
    * **Technical Compatibility:** Ideal for legacy communities using older scripts (2017 - 2019) that rely on global client-side awareness.
  </Tab>

  <Tab title="OneSync Infinity (Recommended)">
    * **Capacity:** Supports up to **2048 slots**.
    * **Synchronization Logic:** **Distance Culling**. A player's client only receives data for entities and participants within a \~400-meter radius.
    * **Technical Compatibility:** Requires modern scripting standards. Logic such as `GetActivePlayers()` executed on the client will only return nearby players, not the global server roster.
  </Tab>
</Tabs>

***

## Global Mode Authorization

While FREAKHOSTING servers initialize with OneSync enabled by default via the [Startup Settings](/games/fivem/configuring-servercfg-for-fivem), you can explicitly define the mode within your `server.cfg`.

```cfg theme={null}
# Force Enable OneSync Infinity
set onesync on
```

***

## Strategic Scripting Considerations

<AccordionGroup>
  <Accordion title="Server-Side Data Calculation">
    In an Infinity environment, client-side scripts are "blind" to distant world events. If you are implementing a global scoreboard or a "Total Online" player counter, you **must** perform these calculations on the **Server-Side** and broadcast the resulting integer to the clients.
  </Accordion>

  <Accordion title="Optimizing Network Bandwidth">
    Infinity is significantly more efficient than Legacy for high-population servers. By using distance culling, the server only transmits relevant packets to each player, drastically reducing the bandwidth overhead and preventing client-side FPS drops in crowded areas.
  </Accordion>
</AccordionGroup>

<Warning>
  ### Framework Dependencies

  Before transitioning to OneSync Infinity, verify that your primary framework (e.g., **ESX** or **QB-Core**) is using its latest stable build. Older versions of these frameworks may experience inventory desynchronization or "ghost" character issues when distance culling is active.
</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 | **FiveM:** OneSync optimized.
</div>