Zasoby pozwalają rozszerzyć serwer FiveM o dodatkowe funkcje. Przydają się szczególnie wtedy, gdy planujesz większe projekty, takie jak serwer Roleplay. Takie projekty trudno zrealizować bez dodatkowych zasobów.
FiveM i jego społeczność oferują ogromny wybór zasobów. Listę najpopularniejszych znajdziesz na forum Cfx.re: https://forum.cfx.re/c/development/releases/7
Najszybciej zainstalujesz zasób za pomocą FiveM Resource Installer bezpośrednio w panelu. Prześlij archiwum ZIP, a instalator umieści zasób we właściwym folderze, doda go do pliku server.cfg i — jeśli chcesz — zaimportuje do twojej bazy danych dołączone pliki SQL. Niżej znajdziesz klasyczną metodę instalacji przez SFTP.
Resource Installer jest dostępny dla serwerów FiveM. W przypadku FiveM Enhanced i RedM skorzystaj z metody przez SFTP.
Otwórz panel swojego serwera FiveM, przejdź do karty Narzędzia i wybierz FiveM Resource Installer. Nie musisz w tym celu zatrzymywać serwera.
Warunkiem jest skonfigurowanie szablonu serwera (Recipe) w txAdmin. Dopiero wtedy dostępne będą plik server.cfg i folder resources, w których instalator może wprowadzać zmiany.
Prześlij zasób jako archiwum ZIP. Możesz bezpośrednio użyć pliku pobranego z GitHuba przez Code → Download ZIP lub archiwum ZIP z wydania.
- Możesz przesyłać pliki ZIP o rozmiarze do 100 MB (po rozpakowaniu maksymalnie 400 MB i 5 000 plików).
- Najpierw spakuj archiwa RAR i 7z ponownie jako ZIP.
- Instalator sam usuwa zbędne foldery pośrednie (np.
moja-resource-main) oraz dopiski z wersją i-mainz nazwy. - Jeśli archiwum zawiera kilka zasobów, instalator wyświetli je osobno i uporządkuje według zależności.
- Pliki wykonywalne, takie jak
.exe,.batczy.sh, nigdy nie zostaną zapisane na twoim serwerze.
Zanim cokolwiek zostanie zainstalowane, instalator pokaże ci zawartość archiwum:
- Nazwa i folder docelowy: Nazwa może zawierać litery, cyfry oraz znaki
_,.i-(maksymalnie 64 znaki). W polu Folder w resources/ wybierz folder kategorii, na przykład[standalone]. Jeśli archiwum nie zawiera takiego folderu, domyślnie wybrany zostanie[local]. Wybierz Bezpośrednio w resources/ (bez folderu), aby umieścić zasób bez folderu kategorii. - Zależności: Przy każdej zależności (np. ESX, QBCore, Qbox, ox_lib, oxmysql) zobaczysz, czy znajduje się ona w archiwum, na serwerze, czy jej brakuje. Zależności, które pojawiają się tylko w kodzie i nie są wymienione w
fxmanifest.lua, zostaną oznaczone jako przypuszczalne. - Skanowanie bezpieczeństwa: Instalator sprawdza wszystkie pliki
.luai.jspod kątem znanych wzorców złośliwego kodu. Jeśli coś wykryje, wyświetli ostrzeżenie. Nadal możesz zainstalować zasób, ale skan bezpieczeństwa wyłączy go przy następnym uruchomieniu serwera. Jeśli uważasz, że to fałszywy alarm, skontaktuj się z naszym zespołem pomocy. - Pliki SQL: Zostaną wyświetlone dołączone pliki
.sqlwraz z informacją o tabelach, które tworzą, zmieniają lub wypełniają.
Jeśli zasób jest już na twoim serwerze, instalator domyślnie przerwie instalację. Jeśli chcesz go zastąpić (np. podczas aktualizacji), zaznacz Nadpisz istniejący zasób. Zastąpiony zostanie cały folder, w tym twoje ustawienia, takie jak config.lua. Przedtem stary folder zostanie zapisany jako archiwum w backups/resource-installer/.
Pozostaw zaznaczoną opcję Dodaj do server.cfg, aby uruchamiał się automatycznie. Instalator doda wtedy ensure <Name> w pliku server.cfg aktywnego folderu serwera, za zależnościami zasobu. Wcześniej utworzy kopię zapasową starego pliku server.cfg o nazwie server.cfg.bak-….
Kliknij Zainstaluj na serwerze. Zobaczysz postęp instalacji (tworzenie kopii zapasowej, rozpakowywanie, umieszczanie plików, uzupełnianie server.cfg, sprawdzanie wyniku). Instalacja będzie kontynuowana nawet po zamknięciu strony.
Wynik informuje, jak uruchamiany jest zasób:
- Dodano wiersz ensure do server.cfg: wszystko gotowe.
- już znajdował się w server.cfg: wiersz był już na miejscu.
- Uruchamia się przez folder kategorii: w pliku
server.cfgjest już wpisensure [Kategoria], który uruchamia także ten zasób. - Brakuje wiersza ensure: dodaj ręcznie
ensure <Name>do plikuserver.cfg(zobacz sekcję Aktywacja).
Aby FiveM załadował nowy zasób, uruchom ponownie serwer, klikając Uruchom serwer ponownie. Możesz też wpisać refresh, a następnie ensure <Name> w konsoli na żywo.
Jeśli zasób wymaga bazy danych, możesz zaimportować jego plik SQL bezpośrednio z instalatora. Import nie odbywa się automatycznie — musisz kliknąć Importuj do bazy danych przy wybranym pliku.
- Wybierz bazę danych swojego serwera. Główna baza danych jest wybrana domyślnie. Jeśli serwer nie ma jeszcze bazy danych, utwórz ją, wybierając Utwórz bazę danych na karcie Bazy danych.
- Jeśli tabela z pliku już istnieje, okno dialogowe cię o tym poinformuje. Pozostaw wtedy zaznaczoną opcję Pomiń istniejące tabele (zalecane). Dzięki temu istniejące tabele i ich dane pozostaną bez zmian.
- Jeśli masz aktywny ZapX Pass, przed importem automatycznie zostanie utworzona kopia zapasowa bazy danych. Jeśli nie masz Passa, potwierdź Importuję bez Backupu.
- Kliknij Importuj teraz.
Każdy plik może mieć maksymalnie 2 MB i zawierać 5 000 instrukcji SQL. Większe pliki zaimportujesz przez phpMyAdmin, zgodnie z instrukcją FiveM: Importowanie pliku SQL.
Import zawsze odbywa się do wybranej bazy danych. Dlatego wiersze takie jak CREATE DATABASE … czy USE … są niedozwolone i nie zostaną zaimportowane. Usuń je z pliku, ponownie spakuj ZIP i prześlij go jeszcze raz.
| Komunikat lub problem | Rozwiązanie |
|---|---|
| Archiwa RAR i 7z nie są obsługiwane | Rozpakuj archiwum i ponownie spakuj folder jako ZIP. |
| Nie można zainstalować tego archiwum | Sprawdź nazwę i folder docelowy. Jeśli zasób o tej samej nazwie znajduje się w innym folderze, zmień nazwę nowego zasobu albo usuń stary. Jeśli archiwum nie zawiera pliku fxmanifest.lua (lub __resource.lua), nie jest zasobem — może zawierać na przykład tylko mapę lub plik pojazdu. |
| Brakuje zależności na serwerze | Najpierw zainstaluj brakujący zasób (np. ox_lib), również za pomocą instalatora. Bez niego zasób zwykle się nie uruchomi. |
| Informacja o braku Recipe lub szablonu serwera | Najpierw skonfiguruj szablon serwera w txAdmin, a potem ponownie otwórz instalator. |
| Na tym serwerze trwa już instalacja | Poczekaj, aż bieżąca instalacja się zakończy. Jej postęp będzie nadal widoczny na stronie. |
| Instalacja została przerwana lub nie powiodła się | Sprawdź serwer i ponownie rozpocznij instalację. Jeśli nadpisano istniejący zasób, w razie błędu instalator przywróci poprzedni folder. |
| SQL: USE jest niedozwolone lub Tworzenie, modyfikowanie i usuwanie baz danych jest niedozwolone | Usuń z pliku SQL wiersze USE i CREATE DATABASE, a następnie ponownie prześlij plik ZIP. |
| SQL: Błąd w wierszu … | Instrukcje do tego wiersza zostały już wykonane. Popraw plik i ponownie rozpocznij import, zaznaczając opcję Pomiń istniejące tabele. |
| Zasób nie uruchamia się po ponownym uruchomieniu serwera | Sprawdź komunikat o błędzie w konsoli na żywo, upewnij się, że wszystkie zależności są uruchomione, a wiersz ensure znajduje się po zależnościach. Pomoc w rozwiązaniu częstych problemów: FiveM: Częste problemy. |
Chcesz najpierw sprawdzić archiwum bez instalowania go? Nasze bezpłatne narzędzie FiveM Resource Installer analizuje je bezpośrednio w przeglądarce — bez przesyłania plików.
Preferowane źródło w Google
