Du kan använda resurser för att utöka din FiveM-spelserver med fler funktioner. Det är särskilt användbart om du planerar större projekt, till exempel en rollspelsserver eller liknande. Sådana projekt är svåra att genomföra utan extra resurser.
FiveM och dess community erbjuder ett enormt urval av resurser. Du hittar en översikt över de populäraste resurserna i Cfx.re-forumet: https://forum.cfx.re/c/development/releases/7
Det snabbaste sättet att installera en resurs är med FiveM Resource Installer direkt i kontrollpanelen. Ladda upp ZIP-arkivet så placerar installationsverktyget resursen i rätt mapp, lägger till den i server.cfg och kan, om du vill, importera medföljande SQL-filer till din databas. Längre ner hittar du den klassiska metoden via SFTP.
Resource Installer är tillgängligt för FiveM-servrar. För FiveM Enhanced och RedM använder du metoden via SFTP.
Öppna kontrollpanelen för din FiveM-server, gå till fliken Verktyg och välj FiveM Resource Installer. Du behöver inte stoppa servern.
För att kunna använda verktyget måste en servermall (Recipe) redan vara konfigurerad i txAdmin. Först då finns en server.cfg och en resources-mapp som verktyget kan skriva till.
Ladda upp resursen som ett ZIP-arkiv. Det går bra att ladda ner en ZIP-fil från GitHub via Code → Download ZIP eller att använda en ZIP-fil från en release.
- ZIP-filer får vara högst 100 MB (högst 400 MB och 5 000 filer när de packats upp).
- Packa om RAR- och 7z-arkiv som ZIP-filer först.
- Installationsverktyget tar bort onödiga mellanliggande mappar (till exempel
min-resurs-main) och tar bort versions- och-main-suffix från namnet. - Om arkivet innehåller flera resurser visas de separat och sorteras efter beroenden.
- Körbara filer som
.exe,.bateller.shskrivs aldrig till din server.
Innan något installeras visar installationsverktyget vad arkivet innehåller:
- Namn och målmapp: Namnet får innehålla bokstäver, siffror samt
_,.och-(högst 64 tecken). Under Mapp i resources/ väljer du kategorimapp, till exempel[standalone]. Om arkivet inte innehåller någon sådan mapp är[local]förvalt. Med Direkt i resources/ (utan mapp) placeras resursen utan en kategorimapp. - Beroenden: För varje beroende (till exempel ESX, QBCore, Qbox, ox_lib, oxmysql) ser du om det finns i arkivet, på servern eller saknas på servern. Beroenden som bara nämns i koden och inte i
fxmanifest.luamarkeras som misstänkta. - Säkerhetskontroll: Installationsverktyget söker igenom alla
.lua- och.js-filer efter kända mönster för skadlig kod. Om något upptäcks får du en varning. Du kan ändå installera resursen, men säkerhetskontrollen inaktiverar den vid nästa serverstart. Kontakta vår support om du tror att varningen är ett falsklarm. - SQL-filer: Medföljande
.sql-filer visas i en lista med information om vilka tabeller de skapar, ändrar eller fyller med data.
Om resursen redan finns på servern avbryter installationsverktyget som standard. Om du vill ersätta den (till exempel vid en uppdatering) markerar du Skriv över befintlig resurs. Då ersätts hela mappen, inklusive dina inställningar som config.lua. Den gamla mappen sparas först som ett arkiv i backups/resource-installer/.
Låt alternativet Lägg till i server.cfg så att den startar automatiskt vara markerat. Installationsverktyget lägger då till ensure <Name> i server.cfg för den aktiva servermappen, efter resursens beroenden, och säkerhetskopierar först den gamla server.cfg som server.cfg.bak-….
Klicka på Installera på servern. Du ser förloppet (säkerhetskopiering, uppackning, placering, uppdatering av server.cfg och kontroll av resultatet). Installationen fortsätter även om du stänger sidan.
Resultatet visar hur resursen startas:
- ensure-rad har lagts till i server.cfg: allt är klart.
- fanns redan i server.cfg: raden fanns redan.
- startar via kategorimappen: din
server.cfginnehåller redanensure [Category], vilket startar resursen. - ensure-rad saknas fortfarande: lägg till
ensure <Name>manuellt iserver.cfg(se Aktivering).
Starta om servern med Starta om server så att FiveM läser in den nya resursen. Du kan också skriva refresh och därefter ensure <Name> i livekonsolen.
Om resursen behöver en databas kan du importera dess SQL-fil direkt från installationsverktyget. Det sker inte automatiskt – du måste klicka på Importera till databas för den aktuella filen.
- Välj serverns databas. Huvuddatabasen är förvald. Om servern inte har någon databas ännu kan du skapa en via Skapa databas på fliken Databaser.
- Om filen innehåller tabeller som redan finns visas det i dialogrutan. Låt då Hoppa över befintliga tabeller (rekommenderas) vara valt. Då påverkas inte befintliga tabeller och deras data.
- Om du har ZapX Pass skapas en säkerhetskopia av databasen automatiskt före importen. Utan Pass bekräftar du Jag importerar utan Backup.
- Klicka på Importera nu.
Varje fil får vara högst 2 MB och innehålla högst 5 000 SQL-instruktioner. Importera större filer via phpMyAdmin enligt anvisningarna i FiveM: Importera SQL-fil.
Importen görs alltid till den valda databasen. Därför är rader som CREATE DATABASE … eller USE … inte tillåtna. Om filen innehåller en sådan rad importeras den inte. Ta bort raderna, packa om ZIP-filen och ladda upp den igen.
| Meddelande eller problem | Lösning |
|---|---|
| RAR- och 7z-arkiv stöds inte | Packa upp arkivet och packa om mappen som en ZIP-fil. |
| Det här arkivet kan inte installeras | Kontrollera namnet och målmappen. Om det redan finns en resurs med samma namn i en annan mapp kan du byta namn på den nya eller ta bort den gamla. Om arkivet saknar fxmanifest.lua (eller __resource.lua) är det inte en resurs, utan till exempel bara en kart- eller fordonsfil. |
| Ett beroende saknas på servern | Installera den saknade resursen (till exempel ox_lib) först, också med installationsverktyget. Utan den startar resursen oftast inte. |
| Meddelande om att Recipe eller servermall saknas | Konfigurera först en servermall i txAdmin och öppna sedan installationsverktyget igen. |
| En installation pågår redan på den här servern | Vänta tills den pågående installationen är klar. Förloppet visas fortfarande på sidan. |
| Installationen avbröts eller misslyckades | Kontrollera servern och starta installationen igen. Om en befintlig resurs skrevs över återställer installationsverktyget den gamla mappen om ett fel uppstår. |
| SQL: USE är inte tillåtet eller Det är inte tillåtet att skapa, ändra eller radera databaser | Ta bort raderna med USE och CREATE DATABASE från SQL-filen och ladda upp ZIP-filen igen. |
| SQL: Misslyckades på rad … | Instruktionerna fram till den raden har redan körts. Korrigera filen och starta importen igen med Hoppa över befintliga tabeller valt. |
| Resursen startar inte efter omstart | Kontrollera felmeddelandet i livekonsolen, att alla beroenden körs och att ensure-raden står efter sina beroenden. Läs mer om vanliga fel i FiveM: Vanliga problem. |
Vill du kontrollera ett arkiv innan du installerar det? Vårt kostnadsfria verktyg FiveM Resource Installer analyserar det direkt i webbläsaren utan att något laddas upp.
Föredragen källa hos Google
