Как исправить "You lack the required entitlement" на сервере FiveM

Платные ресурсы FiveM поставляются через Cfx.re Asset Escrow. Покупка добавляет ресурс на один аккаунт Cfx.re, и сервер может запускать его только тогда, когда лицензионный ключ сервера принадлежит этому аккаунту. Когда ресурс пытается запустить сервер без такого права, документация FiveM описывает результат так: ресурс не запустится, а в консоли сервера появится ошибка "You lack the required entitlement".

You lack the required entitlement to use <resource name>

То есть сообщение говорит о том, кому принадлежит ресурс. С файлами всё в порядке, просто серверу, который их запрашивает, не разрешено их запускать.

1. Перезапустите сервер целиком, а не только ресурс. Поддержка Cfx.re называет это первым шагом, и его достаточно, если покупка была сделана, когда сервер уже работал.
2. Найдите аккаунт, которому принадлежит ресурс. Войдите на portal.cfx.re и откройте Granted Assets. Ресурс должен быть в этом списке. Если его там нет, вы вошли не в тот аккаунт, который использовался при оплате.
3. Найдите аккаунт, которому принадлежит ключ сервера. Ключ задаётся строкой sv_licenseKey в server.cfg. Он должен быть одним из ключей сервера того же аккаунта в Portal.
4. Сделайте так, чтобы они совпали. Либо создайте новый ключ сервера на аккаунте, у которого есть ресурс, и впишите его в server.cfg, либо перенесите ассет на аккаунт, которому принадлежит ключ. Поддержка Cfx.re описывает перенос и для Keymaster, и для Portal.
5. Перезапустите сервер ещё раз и прочитайте консоль.

# server.cfg
sv_licenseKey "your_server_key"

Ситуация	Причина	Решение
Ресурс куплен несколько минут назад, сервер уже работал	Сервер ещё не получил новое право	Перезапустите сервер целиком.
Ресурс есть в Granted Assets, ошибка остаётся	Ключ сервера создан на другом аккаунте Cfx.re	Используйте ключ с аккаунта, у которого есть ресурс, или перенесите ассет.
Сервер настраивал хостинг или разработчик	Ключ в server.cfg принадлежит им, а не вам	Создайте свой ключ в Portal и замените его.
Ресурса вообще нет в Granted Assets	Покупка сделана под другим логином Cfx.re	Войдите в аккаунт, который использовался при оплате, и при необходимости перенесите ассет.
Файлы получены от кого-то другого	Аккаунт никогда не получал этот ресурс	Ресурс должен купить владелец сервера. Скопированные файлы право на запуск не переносят.
Работало и перестало	Закончилась подписка или сменился ключ сервера	Продлите подписку или проверьте ключ в server.cfg.

О подписках в документации FiveM сказано: когда подписка истекает, ассет удаляется с аккаунта и больше не запускается на этом сервере.

На одном аккаунте должны находиться две вещи: купленный ресурс и ключ сервера. При оплате через Tebex вы входите в аккаунт Cfx.re, и ресурс получает именно этот аккаунт. Сервер подтверждает, кому он принадлежит, своим лицензионным ключом. Компьютер и хостинг-компания на это не влияют.

Поэтому ошибка так часто появляется после смены владельца сервера, после переезда на новый хостинг, который выдал собственный ключ, или когда ресурсы покупает один человек, а ключ создал другой. Решите, на каком аккаунте работает сервер, и держите на нём и покупки, и ключи. Весь процесс установки описан в гайде об установке ресурса FiveM из Cfx.re Escrow.

Да, но сообщение будет другим. В скачанном ресурсе под escrow есть небольшой файл .fxap в папке ресурса, рядом с fxmanifest.lua. Его имя начинается с точки, поэтому некоторые файловые менеджеры и FTP-программы скрывают или пропускают его. Загружайте папку целиком в том виде, в каком она была скачана, не меняйте её имя и не редактируйте защищённые файлы.

Если консоль пишет, что защищённый ресурс не удалось проверить, и не упоминает entitlement, скачайте ресурс из Portal заново и замените папку на сервере, прежде чем менять что-то ещё.

Документация FiveM называет файлы Lua, YFT, YDD и YDR теми типами, которые защищает Asset Escrow. Автор может оставить любой файл открытым с помощью escrow_ignore в fxmanifest.lua. Вот пример из документации:

escrow_ignore {
  'script/code.lua',  -- Only ignore one file
  'stream/tuner.ydr', -- Works for any file, stream or code
  'stream/*.yft',     -- Ignore all .yft files in that folder
  'stream/**/*.yft'   -- Ignore all .yft files in any subfolder
}

Перечисленные там файлы приходят читаемыми, и их можно менять. Так остаётся редактируемым файл конфигурации или handling транспорта. Какие файлы открыты, решает автор. Meta-файлы, которые обычно можно менять в ресурсах с транспортом, перечислены в гайде о fxmanifest.lua и data_file для транспорта.

Весь транспорт, ховерборды и питомцы Nilo3D поставляются через Cfx.re Escrow, поэтому действуют те же правила. Если после шагов выше ошибка остаётся, откройте тикет в Discord Nilo3D и пришлите свой логин Cfx.re. По нему мы видим, какой аккаунт получил покупку.