Como resolver "You lack the required entitlement" em um servidor FiveM

Resources pagos de FiveM são entregues pelo Cfx.re Asset Escrow. Uma compra adiciona o resource a uma conta Cfx.re, e um servidor só pode rodá-lo quando essa conta é a que está por trás da chave de licença do servidor. Quando um servidor sem esse direito tenta iniciar o resource, a documentação do FiveM descreve o resultado assim: o resource não inicia, e um erro dizendo "You lack the required entitlement" (você não tem o direito necessário) aparece no console do servidor.

You lack the required entitlement to use <resource name>

Ou seja, a mensagem fala de quem é o dono do resource. Os arquivos estão certos; o servidor que pediu é que não tem permissão para rodá-los.

1. Reinicie o servidor inteiro, não apenas o resource. O suporte da Cfx.re dá isso como primeiro passo, e basta quando a compra foi feita com o servidor já rodando.
2. Descubra qual conta é dona do resource. Entre em portal.cfx.re e abra Granted Assets. O resource tem que estar listado ali. Se não estiver, você entrou com uma conta diferente da usada na compra.
3. Descubra qual conta é dona da server key. A key é a linha sv_licenseKey do server.cfg. Ela tem que ser uma das server keys dessa mesma conta no Portal.
4. Faça as duas baterem. Crie uma server key nova na conta que tem o resource e coloque no server.cfg, ou transfira o asset para a conta dona da key. O suporte da Cfx.re documenta a transferência tanto pelo Keymaster quanto pelo Portal.
5. Reinicie de novo e leia o console.

# server.cfg
sv_licenseKey "your_server_key"

Situação	Causa	Solução
Comprou há poucos minutos, o servidor já estava rodando	O servidor ainda não recebeu a nova liberação	Reinicie o servidor inteiro.
O resource está em Granted Assets, o erro continua	A server key foi criada em outra conta Cfx.re	Use uma key da conta que tem o resource, ou transfira o asset.
A hospedagem ou um desenvolvedor montou o servidor	A key do server.cfg é deles, não sua	Crie sua própria key no Portal e troque.
O resource não aparece em Granted Assets	Foi comprado com outro login da Cfx.re	Entre com a conta usada na compra e, se precisar, transfira o asset.
Os arquivos vieram de outra pessoa	A conta nunca recebeu o resource	O dono do servidor tem que comprar. Arquivos copiados não levam o direito de uso junto.
Funcionava e parou	Uma assinatura terminou, ou a server key foi trocada	Renove a assinatura, ou confira a key no server.cfg.

Sobre assinaturas, a documentação do FiveM diz que, quando uma expira, o asset é removido da conta e não inicia mais naquele servidor.

Duas coisas têm que ficar na mesma conta: o resource comprado e a server key. O checkout da Tebex faz o login com uma conta Cfx.re, e é essa conta que recebe o resource. O servidor prova a quem pertence pela chave de licença. A máquina e a empresa de hospedagem não entram nessa conta.

É por isso que o erro aparece tanto depois que um servidor troca de dono, depois de mudar para uma hospedagem que forneceu a própria key, ou quando uma pessoa compra os resources e outra criou a key. Decida qual conta roda o servidor e mantenha as compras e as keys nela. O caminho completo de instalação está em como instalar um resource de FiveM do Cfx.re Escrow.

Podem, mas a mensagem é outra. Um download com escrow tem um arquivo pequeno chamado .fxap na pasta do resource, ao lado do fxmanifest.lua. Como o nome começa com ponto, alguns gerenciadores de arquivos e programas de FTP escondem ou pulam esse arquivo. Envie a pasta inteira exatamente como foi baixada, mantenha o nome da pasta e não edite arquivos protegidos.

Se o console disser que o resource protegido não pôde ser verificado, em vez de falar em entitlement, baixe o resource de novo pelo Portal e substitua a pasta no servidor antes de mudar qualquer outra coisa.

A documentação do FiveM lista os arquivos Lua, YFT, YDD e YDR como os tipos que o Asset Escrow protege. O autor pode deixar qualquer arquivo aberto com escrow_ignore no fxmanifest.lua. Este é o exemplo da documentação:

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
}

Os arquivos listados ali chegam legíveis e podem ser alterados. É assim que um arquivo de config, ou o handling de um veículo, continua editável. Quais arquivos ficam abertos é escolha do autor. Em resources de veículo, os metas que normalmente dá para mudar estão listados em fxmanifest.lua e data_file para veículos.

Todo veículo, hoverboard e pet da Nilo3D é entregue pelo Cfx.re Escrow, então valem as mesmas regras. Se o erro continuar depois dos passos acima, abra um ticket no Discord da Nilo3D e envie seu nome de usuário da Cfx.re. Com ele conseguimos ver qual conta recebeu a compra.