> ## 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 Install Truck Mods in ATS

> Learn how to correctly install and synchronize custom truck mods for your ATS Convoy server to ensure all drivers can experience high-quality vehicle variety.

## Customizing Your Fleet

Integrating custom trucks, such as the Peterbilt 389 Glider or specialized heavy-duty haulers, significantly enhances the visual variety and roleplay depth of your American Truck Simulator (ATS) server. Unlike platforms with automated asset streaming, ATS Convoy servers require precise manual synchronization of mod files between the server and all participating drivers.

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

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

***

## The Synchronization Lifecycle

ATS Convoy servers do not automatically push mod assets to joining clients. To ensure that everyone can see and interact with custom trucks without errors, you must follow this lifecycle:

<Steps>
  <Step title="Deploy to Server">
    Upload your chosen truck `.scs` files into the `/mod/` directory of your server via the [Game Panel](https://panel.freakhosting.com) File Manager or an SFTP client.
  </Step>

  <Step title="Client-Side Alignment">
    Every driver intending to join the server **must** possess the identical version of these `.scs` files within their local `Documents/American Truck Simulator/mod/` directory.
  </Step>

  <Step title="Export Mod Manifest">
    use the in-game "Export Server Packages" tool within ATS to generate a fresh `server_packages.sii` file. Upload this file to your server to define which mods are mandatory for entry.
  </Step>
</Steps>

***

## Strategic Community Synchronization

Maintaining consistency across a large group of players is the most challenging aspect of modding. We recommend these proven methods for a smooth experience:

<Tabs>
  <Tab title="Workshop Collections">
    The most efficient method is creating a **Steam Workshop Collection**. Instruct all community members to subscribe to the collection. You can then download these specific files to your PC and upload them to the server's `/mod/` folder.
  </Tab>

  <Tab title="Centralized Repositories">
    If using mods from external sources, provide a single, centralized download link (such as Google Drive or a private Discord channel) to your community. This ensures that every player is using the exact same file hash.
  </Tab>
</Tabs>

<Warning>
  ### Resolving Mod Mismatch Errors

  Even a minor version difference (e.g., v1.1 vs v1.1.1) will trigger a "Mod Mismatch" error, and the server will reject the connection. Always coordinate community-wide updates to ensure all files are updated simultaneously across all participants.
</Warning>

***

## Troubleshooting & Optimization

<AccordionGroup>
  <Accordion title="Trucks Appearing as 'Ghost' Models">
    If a driver can join but cannot see another player's custom truck (seeing a default placeholder instead), it indicates that the driver has the mod active but the versions are not perfectly matched, or the mod is missing a required cabin accessory DLC.
  </Accordion>

  <Accordion title="Optimizing Large Fleet Performance">
    High-fidelity truck mods often have very large texture files. To prevent server-wide FPS drops during convoys, encourage players to use mods that are optimized for multiplayer performance.
  </Accordion>
</AccordionGroup>

***

<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 | **Fleet:** Drive with style.
</div>