FiveM scripts installeren: stap voor stap

FiveM-servers draaien op "resources": scripts die functionaliteit toevoegen. Een politieauto, een banksysteem, een tankstation, een garage, een kledingwinkel: alles is een resource. Het installeren volgt altijd hetzelfde patroon, maar er zijn valkuilen die uw server kunnen breken als u ze niet kent.

Waar vindt u scripts

• Cfx.re forums: gratis releases van de community.
• Tebex (voorheen buycraft): betaalde premium scripts. Populaire winkels: ESX Scripts, QBCore Framework, Renewed Scripts.
• GitHub: veel open-source scripts. Zoek op "fivem qbcore" of "fivem esx" gevolgd door de functie.

Controleer altijd of het script compatibel is met uw framework (ESX, QBCore, Qbox of standalone).

Installeren in vijf stappen

1. Downloaden: download het script als zip of clone de Git-repository.
2. Uitpakken: pak de zip uit en hernoem de map als nodig. De mapnaam is de resource-naam.
3. Uploaden: upload de map naar resources/ op uw server. De meeste servers organiseren scripts in submappen: resources/[esx]/, resources/[qb]/, resources/[standalone]/.
4. Configureren: open het config.lua of shared/config.lua bestand in de scriptmap en pas de instellingen aan. Taal, prijzen, locaties, toegangsniveaus: alles staat in de config.
5. Toevoegen aan server.cfg: voeg ensure scriptnaam toe aan uw server.cfg. De volgorde is belangrijk: dependencies moeten voor de scripts staan die ze nodig hebben.

Dependencies

De meeste scripts hebben afhankelijkheden. Veelvoorkomende:

• oxmysql of mysql-async: database-connector. Zie database koppelen.
• ox_lib: utility-library die veel moderne scripts gebruiken. Download van GitHub.
• ox_inventory of qb-inventory: het inventarissysteem van uw framework.
• ox_target of qb-target: het interactiesysteem (3D-doelen op objecten).

Dependencies staan in de fxmanifest.lua van het script. Als u een dependency mist, krijgt u een foutmelding in de console bij het opstarten.

De juiste volgorde in server.cfg

De ensure-volgorde bepaalt in welke volgorde resources worden geladen. Een veelgebruikte structuur:

ensure oxmysql
ensure ox_lib
ensure es_extended    # of qb-core/qbx_core
ensure ox_inventory
ensure ox_target
ensure esx_policejob  # of uw scripts

De vuistregel: databases eerst, dan libraries, dan het framework, dan de scripts die erop bouwen.

SQL importeren

Scripts die data opslaan (garages, eigendom, banen) hebben SQL-tabellen nodig. Het SQL-bestand staat meestal in de hoofdmap van het script. Importeer het via phpMyAdmin (knop in het gamepanel naast de database). Doe dit een keer; de tabellen blijven bestaan.

Veelgemaakte fouten

• Mapnaam begint met een punt of bevat spaties: FiveM laadt de resource niet. Gebruik alleen letters, cijfers en streepjes.
• Dubbele resource-naam: twee mappen met dezelfde naam. De eerste wordt geladen, de tweede genegeerd zonder foutmelding.
• Script voor een ander framework: een ESX-script op een QBCore-server geeft onbegrijpelijke fouten. Controleer de compatibiliteit voor het downloaden.
• Ontbrekende config.lua: sommige scripts verwachten dat u config.lua.example hernoemt naar config.lua.

Kan ik scripts live herladen zonder herstart?

Ja. Typ ensure scriptnaam in de serverconsole of in txAdmin. De resource wordt opnieuw geladen. Let op: niet alle scripts ondersteunen hot-reload. Als het script zich vreemd gedraagt na een reload, herstart dan de hele server.

Hoeveel scripts kan mijn server aan?

Dat hangt af van de kwaliteit van de scripts en het geheugen. Een 4 GB server draait gemakkelijk 50 tot 80 lichte scripts. Zware scripts (grote maps, veel streaming assets) kosten meer. Monitor de server FPS in txAdmin: onder de 30 is een teken dat u moet optimaliseren of upgraden.

Zijn betaalde scripts beter dan gratis?

Niet per definitie. Er zijn uitstekende gratis scripts (ox_inventory, qb-target, okokGarage) en slechte betaalde scripts. Lees reviews op het forum voor u koopt. De bekendste premium makers (Renewed, ox-team) leveren doorgaans hoge kwaliteit.

Scripts draaien op alle FiveM-pakketten van HostValues. Bij vragen over de installatie kunt u een ticket openen.