Zonder license key start een FiveM-server niet. We laten zien hoe je de sleutel gratis aanmaakt op de Cfx.re Portal en waar je hem precies invult op de server.
Wat je nodig hebt
- Een Cfx.re-account (hetzelfde account waarmee je inlogt op het forum forum.cfx.re (opent in een nieuw venster)); heb je er geen, dan maak je het aan wanneer je voor het eerst inlogt op de Portal
- Een FiveM-server bij StormHost (of je eigen server op een VPS)
- Ongeveer 5 minuten
Wat een license key is#
Een license key (officieel Server Registration Key, vroeger maakte je hem aan op de website Keymaster) is de sleutel waarmee je server zich legitimeert bij Cfx.re, de partij achter FiveM. De server controleert hem bij het opstarten en start pas daarna en verschijnt dan in de serverlijst.
- De sleutel begint met
cfxk_en is net zo geheim als een wachtwoord. Wie hem heeft, kan hem voor zijn eigen server gebruiken. - Eén Cfx.re-account kan maximaal 3 actieve sleutels hebben, dus 3 servers tegelijk.
- De sleutel hoort bij jouw account. Betaalde scripts die met het systeem Asset Escrow zijn beveiligd, draaien alleen op een server waarvan de sleutel bij hetzelfde account hoort als waarmee je het script hebt gekocht.
- Bij het aanmaken vul je tegenwoordig alleen een servernaam in, geen IP-adres. Oudere handleidingen met een “IP-adres van de sleutel” kloppen niet meer.
Een sleutel aanmaken op de Cfx.re Portal#
Open portal.cfx.re (opent in een nieuw venster) en log in met je Cfx.re-account.
Ga naar de pagina Server Registration Keys (opent in een nieuw venster) (in het menu van de Portal Servers).
Klik op Generate Key +.
Typ in het venster een naam voor de server, bijvoorbeeld
Mijn RP-server. De naam zie alleen jij in de lijst met sleutels, spelers krijgen hem niet te zien.Klik op Generate.
De nieuwe sleutel verschijnt in de lijst met sleutels.
Kopieer de sleutel en bewaar hem in een wachtwoordmanager.
Maak de sleutel nergens openbaar
Zet hem niet in een openbare repository op GitHub, niet op Discord en niet in een screenshot van de console. Is de sleutel gelekt, genereer dan een nieuwe (gedeelte “Als iets niet werkt”).
De sleutel invullen op de server#
Waar je de sleutel invult, hangt ervan af of je de server via txAdmin beheert. Dat zie je op het tabblad Console: een draaiende txAdmin toont na het opstarten een kader met All ready! Please access:.
Met txAdmin
Nieuwe server: je vult de sleutel in de wizard van txAdmin in, in de stap Step 2: Input Parameters, in het veld Server Registration Key. txAdmin schrijft hem zelf naar server.cfg. De hele wizard staat beschreven in de handleiding txAdmin: je FiveM-server voor het eerst instellen.
De server draait al en je wilt de sleutel wijzigen:
Open in txAdmin in het linkermenu CFG Editor.
Zoek de regel met
sv_licenseKeyen vervang de oude sleutel door de nieuwe:server.cfgcfg sv_licenseKey "<LICENSE_KEY>"sv_licenseKey– de instelling waaruit de server de license key leest."<LICENSE_KEY>"– vervang<LICENSE_KEY>door de volledige sleutel van de Portal (begint metcfxk_), tussen aanhalingstekens en zonder punthaken.
Klik op Save File (CTRL+S).
Herstart de server (in txAdmin met de herstartknop links, of in je klantaccount op het tabblad Console met de knop Herstarten).
Zonder txAdmin
- Open in je klantaccount Mijn diensten, klik op de server en ga naar het tabblad Instellingen.
- Zoek in het gedeelte Variabelen de variabele voor de license key. Je herkent hem aan de omschrijving, die naar de Cfx.re Portal verwijst.
- Plak de sleutel en klik op Opslaan. Het veld met de sleutel is om veiligheidsredenen afgeschermd, de inhoud toon je met het oogpictogram in het veld.
- Klik op het tabblad Console op Herstarten.
Heeft de server geen variabele voor de sleutel, zet de sleutel dan rechtstreeks in server.cfg (tabblad Bestanden) met de regel sv_licenseKey "<LICENSE_KEY>".
Eigen VPS
Op je eigen server hoort de sleutel in server.cfg in de map met de serverdata:
sv_licenseKey "<LICENSE_KEY>"Vervang <LICENSE_KEY> door de sleutel van de Portal. Start de server daarna met de parameter +exec server.cfg, anders laadt hij het bestand niet. Gebruik je txAdmin, volg dan het tabblad “Met txAdmin”.
Sleutel in de variabele en in server.cfg
Staat de sleutel zowel in de variabele als in server.cfg, dan geldt de sleutel die het laatst wordt ingesteld. Meestal is dat server.cfg, omdat dat bestand pas na de startparameters wordt geladen. Het eenvoudigst is om de sleutel maar op één plek te hebben. Laat je hem op beide plekken staan, dan moet hij hetzelfde zijn.
Controle#
- Op het tabblad Console verschijnt na de herstart geen fout over de license key en de server laadt de resources.
- Binnen een paar minuten (uiterlijk ongeveer 8 minuten na de start) is de server zichtbaar in de serverlijst van FiveM.
- Je kunt de server ook controleren met onze tool CFX Resolver: voer het adres van het tabblad Netwerk in (IP:poort).
Als iets niet werkt#
no license key was specified#
De server heeft helemaal geen sleutel gekregen. Controleer of de regel sv_licenseKey in de server.cfg staat die de server echt laadt (bij txAdmin in de map die je bij het deployen hebt gekozen), of dat de variabele op het tabblad Instellingen is ingevuld. Controleer bij een eigen VPS of je de server start met +exec server.cfg.
Could not authenticate server license key#
De sleutel is ongeldig, gedeactiveerd of onvolledig gekopieerd (er ontbreekt een teken aan het begin of einde, of er staat een spatie te veel). Kopieer hem opnieuw van de Portal. Controleer op de pagina Server Registration Keys (opent in een nieuw venster) of hij de status Active heeft. Een gedeactiveerde sleutel activeer je opnieuw met de knop Re-Activate in de details van de sleutel.
De sleutel is gelekt#
Klik op de pagina met sleutels op het Server ID van de betreffende sleutel, daarna op Regenerate en bevestig met Yes. De oude sleutel werkt dan niet meer, vul de nieuwe dus meteen in op de server volgens de stappen hierboven. Cfx.re kan je een e-mail sturen dat de sleutel is gevonden in een openbare repository op GitHub. De stappen zijn dan hetzelfde.
Je kunt geen extra sleutel aanmaken#
Je hebt 3 actieve sleutels. Open de sleutel van een server die je niet meer gebruikt en klik op Deactivate.
You lack the required entitlement to use …#
Een betaald script (Asset Escrow) is gekocht met een ander Cfx.re-account dan het account waar de license key van de server bij hoort. Gebruik een sleutel van het account waarmee je het script hebt gekocht, of draag het script op de Portal over naar het juiste account. Meer details staan in de handleiding FiveM resources.
Samenvatting
- Een license key (Server Registration Key) maak je gratis aan op portal.cfx.re › Servers › Registration Keys › Generate Key +.
- Eén account heeft maximaal 3 actieve sleutels, een sleutel is niet aan een IP-adres gekoppeld.
- Met txAdmin vul je de sleutel in de wizard in (Server Registration Key) of in de CFG Editor, zonder txAdmin op het tabblad Instellingen › Variabelen of in
server.cfg. - Herstart de server nadat je de sleutel hebt gewijzigd. Genereer een gelekte sleutel meteen opnieuw met de knop Regenerate.