Vous manquez de l'entitlement requis pour utiliser une ressource : correction de l'escrow

Vous démarrez un script acheté et la console imprime quelque chose comme :

You lack the required entitlement to use my_script

ou :

Failed to verify protected resource my_script

Le script est protégé par l'escrow d'actifs Cfx.re, et votre serveur ne peut pas prouver que vous le possédez. La correction est presque toujours une non-concordance entre la clé de licence dans server.cfg et le compte Cfx.re qui a acheté l'actif.

#Comment fonctionne l'escrow

Les scripts escrowed (protégés) sont chiffrés. Quand le serveur démarre la ressource, il vérifie la clé de licence avec laquelle le serveur s'exécute. Cette clé appartient à un compte Cfx.re. La vérification réussit seulement si ce même compte a été accordé l'actif.

Il y a donc trois choses qui doivent s'aligner :

1. L'actif a été acheté, et il a été accordé à un compte Cfx.re (celui que vous avez utilisé au paiement).
2. Ce compte a généré la clé de licence du serveur.
3. La clé est celle définie dans server.cfg.

#Étape 1 : vérifiez la clé dans server.cfg

sv_licenseKey "cfxk_xxxxxxxxxxxxxxxxxxxx_xxxxx"

Si vous utilisez txAdmin, la clé peut aussi être définie dans sa configuration ou ses paramètres au lieu du fichier. Regardez dans les deux endroits, et cherchez une deuxième clé sur une autre ligne ou dans une copie de server.cfg que vous ne saviez pas qui était chargée.

Attention : ne partagez jamais votre clé de licence dans les captures d'écran, les messages Discord ou les tickets d'assistance. Si vous l'avez divulguée, générez une nouvelle dans le portail et remplacez-la.

#Étape 2 : vérifiez qui possède la clé

Ouvrez portal.cfx.re et connectez-vous. Dans la section des clés, regardez les clés qui existent sur ce compte. La clé dans votre server.cfg doit apparaître dans la liste du compte dans lequel vous êtes connecté. Si elle n'y est pas, elle a été générée par un autre compte, et c'est la raison habituelle de l'erreur.

Les situations typiques sont :

• Un ami ou un développeur a généré la clé pour vous, depuis son propre compte.
• Vous possédez deux comptes Cfx.re et utilisez la clé de l'un tandis que l'actif est sur l'autre.
• Une clé a été générée pour un serveur différent et vous l'avez copiée d'une ancienne config.

#Étape 3 : vérifiez que l'actif a été accordé à ce compte

Dans le même portail, ouvrez la page répertoriant les actifs accordés. Votre achat devrait y être, sous le même compte que la clé. S'il manque :

• Regardez le compte que vous avez entré au paiement. Un achat est lié au compte Cfx.re entré à ce moment-là, pas à l'e-mail avec lequel vous payez.
• Vérifiez la confirmation d'achat que vous avez reçue pour voir quel compte elle nomme.
• Si l'actif est sous un compte différent, vous avez deux voies : utiliser la clé de licence de ce compte sur le serveur, ou demander au support du vendeur de déplacer l'actif vers le compte que vous voulez. N'essayez pas de la contourner.

L'octroi peut prendre un peu de temps après l'achat. Si vous l'avez acheté il y a quelques minutes, attendez, actualisez le portail et redémarrez le serveur.

#Étape 4 : retéléchargez après l'achat

Retéléchargez la ressource du portail après que l'actif apparaisse dans votre liste accordée. Une copie prise ailleurs, ou une ancienne version obtenue avant l'octroi de l'achat, ne vérifiera pas. Remplacez le dossier complètement, puis redémarrez la ressource.

#Étape 5 : ne modifiez pas les fichiers protégés

L'escrow chiffre le script. Ouvrir ou modifier les fichiers chiffrés casse la vérification et vous obtenez Failed to verify protected resource. Modifiez seulement les fichiers que le script envoie ouverts, généralement un config.lua et parfois des fichiers de langue ou partagés. Si vous avez modifié quelque chose et maintenant vous obtenez un échec de vérification, retéléchargez une copie propre et appliquez seulement vos modifications de config.

À propos du nom du dossier : gardez le nom du dossier de ressource que le script lui-même indique. Si les instructions indiquent un nom requis, utilisez-le. Renommer une ressource escrowed peut la casser quand le script lui-même s'attend à son nom, donc ne la renommez que quand le vendeur dit que c'est correct.

#Étape 6 : redémarrez proprement

Après avoir changé la clé ou remplacé la ressource :

refresh
ensure my_script

Si la clé de licence a changé dans server.cfg ou dans txAdmin, redémarrez le serveur entier, pas seulement la ressource. La clé est lue au démarrage.

Pour d'autres messages de la même famille, voir Erreur de clé de licence serveur et Couldn't start resource.

#Déplacement vers un nouveau serveur

L'escrow ne lie pas l'actif à une adresse IP. Il le lie au compte dont votre serveur utilise la clé. Quand vous vous déplacez vers un nouvel hôte, gardez la même sv_licenseKey (ou générez une nouvelle clé sur le même compte), et l'actif continue de fonctionner. Si vous transférez le serveur entier à quelqu'un d'autre, il doit avoir l'actif accordé à son compte, ce qui doit être arrangé avec le vendeur.

#Liste de vérification