Using OneSync in FiveM

Learn how to enable and configure OneSync on your FiveM server to unlock support for extended player counts and enhanced server features.

What is OneSync ?

OneSync is a core FiveM networking extension that allows:

• ✅ Support for more than 48 players (up to 2048)

• ✅ Better entity streaming and server-side visibility

• ✅ Smoother gameplay in crowded areas

Enabling OneSync is essential for servers aiming for scalability, stability, and a modern multiplayer experience.

📌 This guide focuses on enabling OneSync manually using server.cfg. If you're using TxAdmin, OneSync can be toggled from the web panel under Settings > FXServer.

---

Manual Configuration via server.cfg

1. Open your configuration file

Locate your server.cfg file (typically in the root directory of your FiveM server) and open it in a code editor or text editor.

2. Enable OneSync base

Make sure the following line is present and not commented out:

onesync on

If it is missing, add it. If it’s commented with # or //, remove the comment marker.

3. (Optional) Enable OneSync Infinity

To unlock full scalability and maximum slots:

onesync_enableInfinity 1

This should also be uncommented and placed after the main onesync on directive.

💡 OneSync Infinity improves range-based streaming, but may increase CPU usage. Only use it if your environment requires it ( most recent framework requires it ).

4. Save & Restart

After saving your changes to server.cfg, restart your server completely.

---

Final Notes

• If your scripts or framework depend on specific OneSync features (e.g. entity visibility), test thoroughly after enabling.

• Combine OneSync with updated Artifacts and latest GameBuilds for maximum compatibility.

For more advanced configuration, refer to the FiveM OneSync Documentation.