Hoe maak je een FivePD Server: Download- en Setupgids

Om een FivePD server te maken, begin je met een werkende FXServer, download je het FivePD pakket van een bron die je vertrouwt, lees je de eigen installatie-instructies van het pakket, installeer je de vermelde afhankelijkheden, voeg je de resources toe aan server.cfg, en test je de basisresource voordat je callouts toevoegt. Kopieer niet zomaar een oude database of configuratievoorbeeld: FivePD distributies en add-ons gebruiken niet allemaal dezelfde bestanden, opslaglaag of afhankelijkheidsversies.

Beoordeeld op 12 augustus 2026 tegen de officiële Cfx.re documentatie voor het opzetten van FXServer, resources, resource manifests En server commands. FivePD-specifieke bestandsnamen en afhankelijkheden moeten worden geverifieerd in het exacte archief dat je installeert.

Wat je nodig hebt voordat je FivePD downloadt

• Een schone FXServer-instantie die succesvol start zonder FivePD.
• Een geldige Cfx.re server-sleutel en toegang tot de serverconsole.
• Een aparte staging- of testserver. Experimenteer niet op de enige live kopie.
• Het FivePD archief, de README of documentatie ervan, en elke daar genoemde afhankelijkheid.
• Een back-up van server.cfg, serverconfiguratie en elke database die door het pakket wordt gebruikt.

Als de onderliggende FiveM-server nog niet gereed is, volg dan eerst de officiële FXServer-installatie. Een voorbereid FivePD serverpakket kan het starttraject verkorten, terwijl de FiveM serveropties bredere serverbuilds omvatten. Verifieer in beide gevallen de meegeleverde bestanden en vereisten in plaats van aan te nemen dat elk pakket dezelfde lay-out heeft.

Stap 1: Bewijs dat de basis FXServer werkt

Start FXServer met een minimale configuratie en maak eenmaal verbinding voordat je FivePD installeert. Bevestig dat de server verschijnt, de console vrij is van opstartfouten en een client kan deelnemen. Dit scheidt een FXServer-, firewall- of server-sleutelprobleem van een FivePD-probleem.

Noteer de huidige artifact- en resourceversies. Cfx.re raadt huidige serverartifacts aan, maar het wijzigen van de artifact, game build, framework en FivePD-pakket in één poging maakt het moeilijk om fouten te isoleren. Wijzig één laag tegelijk.

Stap 2: inspecteer de FivePD download

Pak het archief buiten de live resources directory uit. Zoek de fxmanifest.lua of legacy manifest, README, configuratiebestanden en afhankelijkheidsverklaringen. De resource map die onder resources geplaatst moet worden, is de map die de manifest bevat; een extra archiefmap erboven is een veelvoorkomende reden voor “resource niet gevonden”.

Controleer het archief op instructies over database-imports, connection strings, permissies en laadvolgorde. Sommige pakketten of extensies hebben mogelijk databaseopslag nodig; andere mogelijk niet. Maak alleen schema's of plak SQL wanneer het geïnstalleerde pakket dit expliciet vereist. Publiceer nooit databasewachtwoorden in een client-script, gedeelde configuratie of openbare repository.

Stap 3: installeer afhankelijkheden vóór de hoofdresource

Plaats elke vereiste afhankelijkheid in zijn eigen resource map. Bevestig dat de naam overeenkomt met het manifest en de ensure regel die je van plan bent te gebruiken. Als de documentatie een volgorde specificeert, start dan gedeelde bibliotheken en databasekoppelingen vóór FivePD, en start dan callouts na de basisresource.

Een eenvoudige configuratievorm is:

# Start required libraries first
ensure required_dependency

# Start the FivePD resource after its dependencies
ensure fivepd

# Add one compatible callout only after the base test passes
ensure example_callout

Deze namen zijn ter illustratie. Gebruik de echte map- en resourcenamen uit je download. Cfx.re's ensure commando start een gestopte resource of herstart een die al draait.

Stap 4: configureer server-side waarden veilig

Maak de kleinste configuratie die nodig is voor een eerste start. Houd inloggegevens en bevoorrechte instellingen aan de serverzijde. Waar het pakket standaardwaarden biedt, kopieer je het gedistribueerde voorbeeld en wijzig je alleen gedocumenteerde sleutels. Verzin geen configuratievelden uit een ongerelateerde tutorial: een verkeerd gespelde sleutel kan stilzwijgend worden genegeerd en een oude optie bestaat mogelijk niet meer.

Als een database vereist is, gebruik dan een speciale databasegebruiker met alleen de noodzakelijke machtigingen. Importeer eenmalig het bijpassende schema van het pakket en bevestig vervolgens dat de tabellen bestaan. Een succesvolle SQL-import bewijst niet dat de resource verbinding kan maken, dus controleer de serverconsole tijdens het opstarten.

Stap 5: test de basisresource vóór callouts

1. Start de server met afhankelijkheden en FivePD, maar zonder optionele callouts.
2. Bekijk het volledige serverlogboek vanaf de ontdekking van resources tot het opstarten.
3. Maak verbinding met een schone client en inspecteer de F8-console op clientfouten.
4. Bevestig alleen de gedocumenteerde basiscommando's en interfaces.
5. Herstart de resource en maak opnieuw verbinding om problemen met de laadvolgorde of persistentie bloot te leggen.

Voeg vervolgens één callout toe, herstart en test deze. Herhaal één voor één. Een callout die is geschreven voor een andere FivePD build kan mislukken, zelfs als de basisresource gezond is; houd de laatste werkende versie beschikbaar voor terugdraaien.

Veelvoorkomende FivePD installatiefouten

Veilige updatevolgorde

Maak een back-up van de werkende resource en de bijbehorende gegevens, lees de release notes, update op staging en test de basis opnieuw voordat je optionele callouts uitvoert. Overschrijf een aangepaste configuratie niet zonder deze te vergelijken. Als een update de database wijzigt, bewaar dan zowel de dump van vóór de update als de exacte pakketversie die nodig is om deze te herstellen.

Deze reeks is bewust conservatief: eerst FXServer, dan afhankelijkheden, dan FivePD, dan één callout. Het geeft elke storing een klein zoekgebied en maakt terugdraaien mogelijk zonder de hele server opnieuw op te bouwen.