Skip to content
Game Servers

Fix ARK Mods Not Downloading or Updating

mods not downloadingmod version mismatchstuck installing mods
8 min read Updated 12 June 2026 ESAGAMES Team

ARK mods break in predictable ways: a mismatch after an update, a stalled Workshop download, or the wrong mod IDs in your config. Here's how to get them downloading and in sync again.

How ARK loads mods

The server downloads Workshop mods via SteamCMD and loads the IDs you list in your launch parameters / GameUserSettings. Both the server and every client must have the same mod version — a mismatch kicks players.

Set the mod IDs correctly

List the Workshop IDs (comma-separated, no spaces) in your start command:

?GameModIds=731604991,895711211
# or on newer setups, the -mods= launch argument:
-mods=731604991,895711211

Force a clean re-download

If a mod is stuck or corrupted, clear the Workshop cache and let SteamCMD pull it fresh, then restart the server:

# stop the server first, then remove the cached mod folder
steamapps/workshop/content/346110/<modid>/
# restart — SteamCMD re-downloads it on boot
After every ARK update

Update the server first, then let mods update. Players also need to update those mods in-game — a server/client version gap is the #1 "can't join modded server" cause.

Still stuck?

  • Check the mod isn't hidden/removed from the Workshop (it can't download then).
  • Make sure there's enough disk space — big mods fail silently when the disk is full.
  • Load mods one at a time to find a broken or conflicting one.
Right IDs, a clean cache, and matching versions on server and client — that's 95% of ARK mod problems solved.

ARK mods not downloading because of SteamCMD itself

Sometimes the problem isn't the mod but SteamCMD — a half-finished SteamCMD update, a full disk, or Steam's Workshop servers having a temporary issue for that specific mod. Update SteamCMD itself first, confirm you have free disk space well beyond the mod's listed size, and check the mod's own Workshop page for other users reporting the same download failure before assuming it's your config.

How to prevent ARK mod problems after updates

  • Pin a known-good mod list and only add one new mod at a time in testing.
  • Keep at least double the mod's listed size free on disk before installing it.
  • Subscribe to mod update notifications on Steam so you know before players do.
  • Restart the server right after an ARK update rather than waiting — mods often need the fresh binaries to compile and load correctly.

Related ARK guides

If players get a connection timeout rather than a mod mismatch, see ARK joining failed: connection timeout. For a full setup walkthrough, read how to make an ARK server. For mod ideas once things are stable, see best ARK mods.

ARK hosting with easy mods

Our ARK hosting handles Workshop mods and updates for you on fast NVMe, protected in Frankfurt.

ARK hosting
FAQ

Frequently asked questions

Why won't my ARK server download mods?

Common reasons: wrong Workshop IDs in the config, a stalled/corrupted SteamCMD download, no disk space, or a mod removed from the Workshop. Clear the mod cache and restart to force a fresh download.

Why do players get a mod mismatch?

The server and the player have different versions of a mod. After any update, the server must update its mods and players must update theirs in-game so the versions match.

Where are ARK Workshop mods stored?

Under steamapps/workshop/content/346110/ (346110 is ARK's Steam app ID), one folder per mod ID. Deleting a mod's folder forces a clean re-download on the next boot.

How much disk space do ARK mods actually need?

It varies widely — some mods are a few MB, others (large map or creature mods) can be several GB. Keep at least double a mod's listed Workshop size free to avoid a silent failed download.

Can a full disk cause "mods not downloading"?

Yes, and it often fails silently rather than showing a clear "disk full" error. Always check df -h/available space before troubleshooting the mod config itself.

Do all players need to verify their game files after a mod update?

Not always required, but it's the fastest way to rule out a corrupted local copy if a specific player still can't join after everyone else updated successfully.

Why does a mod download stall at the same percentage every time?

That usually points to a specific corrupted chunk in the Workshop cache. Delete that mod's folder under steamapps/workshop/content/346110/ entirely and let SteamCMD re-download it from scratch.

Further reading

Go deeper on this

Guides and explainers that pair with this fix — from our guides and blog.

Knowledge base

Related articles

Skip the troubleshooting

Managed, protected hosting in Frankfurt — we handle the Linux, the network and the DDoS so you don't have to.

Payments Secure checkout with cards, banking apps and digital wallets.

Choose the payment flow that fits your stack and region without leaving the platform.

Pay by Zen Visa Mastercard Paysafecard PaysafeCash Skrill Trustly Bancontact UnionPay iDeal WebMoney