Как очистить кэш FiveM: какие папки удалить (и какие нет)

Транспортное средство показывает неправильную текстуру, изменённый скрипт ведёт себя как старый, или FiveM крашится сразу после обновления. Перед тем как переустанавливать что-либо, очистите кэш клиента. Это займёт минуту, это безопасно, и это исправляет удивительное количество проблем на стороне клиента.

#Что такое кэш

Когда вы присоединяетесь к серверу, FiveM загружает потоковые файлы этого сервера (модели, текстуры, карты) и скрипты, и хранит копии на вашем ПК, чтобы следующее подключение было быстрее. Иногда эти копии устаревают, повреждаются при крахе или потерянном соединении, или больше не совпадают с тем, что отправляет сервер. Очистка кэша принудительно выполняет чистую загрузку.

Это только на стороне клиента. Игроки делают это на своём собственном ПК. Владельцы серверов не могут очистить его для них, но вы можете рассказать игрокам как.

#Пошагово

1. Полностью закройте FiveM, включая программу запуска в системном трее. Проверьте Диспетчер задач для FiveM.exe или FiveM_GTAProcess.exe, если не уверены.
2. Нажмите Win + R, вставьте это, и нажмите Enter:

%localappdata%\FiveM\FiveM.app\data

3. Удалите эти папки, если они существуют:

cache
server-cache
server-cache-priv

4. Запустите FiveM и переподключитесь. Первое подключение медленнее, потому что всё загружается снова.

Если вы хотите быть осторожными, удалите содержимое папок вместо папок, или сначала переместите их куда-нибудь ещё. FiveM их перестраивает в любом случае.

Совет: внутри cache, папка game содержит файлы, связанные с игрой. Некоторые люди оставляют её на месте, чтобы избежать загрузки их снова. Файлы, специфичные для сервера, находятся в server-cache и server-cache-priv, это где живут большинство проблем со старым потоком контента.

#Для чего каждая папка

Если вы хотите исправить проблему только с одним сервером, server-cache и server-cache-priv — это папки, которые имеют значение больше всего. Если ничего не меняется, удалите cache тоже.

#Что не удалять

Оставьте это в покое:

• Вашу папку установки GTA V. Кэш — это не игра.
• FiveM.app\mods и FiveM.app\plugins, если вы их используете. Это ваши собственные файлы.
• CitizenFX.ini в FiveM.app. Он содержит параметры программы запуска.
• Всю папку FiveM. Удаление всего заставляет FiveM переустанавливать себя, что редко требуется.

Если вы не знаете, что такое файл, не удаляйте его. Три папки кэша решают большинство случаев.

#Когда очистка кэша помогает

• Проблемы с текстурами. Размытые, отсутствующие или растянутые текстуры, чёрные транспортные средства, или розовые и шахматные текстуры, которые другие игроки не видят. Часто кэшированная копия потокового файла повреждена. Для текстур, которые слишком большие, см. oversized assets and texture loss.
• Старые версии потоковых файлов. Сервер изменил транспортное средство или карту, но вы всё ещё видите старую. Сервер отправляет новые файлы, но используется ваша кэшированная копия. Это обычно после обновления потокового ресурса.
• Краши после обновления. После обновления FiveM или изменения версии игры, старые кэшированные данные могут привести к краху клиента при подключении или загрузке. Очистка кэша — первое, что стоит попробовать.
• Зависшие загрузки. Загрузка, которая никогда не завершается или перезапускается снова и снова. Если сам экран загрузки никогда не заканчивается, см. игроки застревают на экране загрузки.
• Странные проблемы NUI. UI показывает старую графику или держит старые данные. Закройте FiveM и очистите кэш. Если есть папка nui-storage, она содержит данные браузера для UI, и её безопасно очистить также, когда UI ведёт себя неправильно.

#Когда это не помогает

Очистка кэша ничего не исправляет на стороне сервера. Если каждый игрок получает одну и ту же ошибку, причина находится на сервере или в ресурсе, а не в ячейке любого. Обычные примеры — ошибки скрипта, отсутствующий ресурс, или плохой манифест. Протестируйте со вторым ПК или другом: если проблема происходит для них тоже, перестаньте очищать кэши и читайте консоль сервера.

Это также не исправляет повреждённую установку GTA V, сломанный драйвер графики, или конфликт оверлея. Для этого проверьте файлы игры в вашей программе запуска и обновите драйвер GPU.

#Для владельцев серверов: помогите вашим игрокам

Игроки спрашивают в Discord, почему их игра выглядит неправильно после обновления. Добавьте короткое закреплённое сообщение с путём и тремя именами папок. Также держите ваши потоковые активы в здравом смысле: огромные файлы и большое их количество делают проблемы кэша более вероятными и первое подключение медленнее.

#Контрольный список