Aby utworzyć serwer FivePD, zacznij od działającego FXServer, pobierz pakiet FivePD ze źródła, któremu ufasz, przeczytaj własne notatki instalacyjne pakietu, zainstaluj jego zadeklarowane zależności, dodaj zasoby do server.cfg, i przetestuj podstawowy zasób przed dodaniem wezwań. Nie kopiuj ślepo starej bazy danych ani przykładu konfiguracji: dystrybucje i dodatki FivePD nie wszystkie używają tych samych plików, warstwy przechowywania ani wersji zależności.
Przejrzano 12 sierpnia 2026 r. w oparciu o oficjalną dokumentację Cfx.re dla konfiguracja FXServer, zasoby, manifesty zasobów I komendy serwerowe. Nazwy plików i zależności specyficzne dla FivePD muszą zostać zweryfikowane w dokładnym archiwum, które instalujesz.
Co potrzebujesz przed pobraniem FivePD
- Czysta instancja FXServer, która uruchamia się pomyślnie bez FivePD.
- Ważny klucz serwera Cfx.re i dostęp do konsoli serwera.
- Oddzielny serwer stagingowy lub testowy. Nie eksperymentuj na jedynej działającej kopii.
- Archiwum FivePD, jego plik README lub dokumentacja, oraz każda tam wymieniona zależność.
- Kopia zapasowa
server.cfg, konfiguracji zasobów i dowolnej bazy danych używanej przez pakiet.
Jeśli bazowy serwer FiveM nie jest jeszcze gotowy, najpierw postępuj zgodnie z oficjalną konfiguracją FXServer. Przygotowany pakiet serwera FivePD może skrócić ścieżkę startową, podczas gdy opcje serwera FiveM obejmują szersze konfiguracje serwera. W obu przypadkach zweryfikuj dołączone pliki i wymagania, zamiast zakładać, że każdy pakiet ma ten sam układ.
Krok 1: udowodnij, że bazowy FXServer działa
Uruchom FXServer z minimalną konfiguracją i połącz się raz przed zainstalowaniem FivePD. Potwierdź, że serwer się pojawia, konsola jest wolna od błędów startowych i klient może się połączyć. To oddziela problem z FXServer, zaporą sieciową lub kluczem serwera od problemu z FivePD.
Zapisz bieżące wersje artefaktów i zasobów. Cfx.re zaleca bieżące artefakty serwera, ale zmiana artefaktu, kompilacji gry, frameworka i pakietu FivePD w jednej próbie utrudnia izolację błędów. Zmieniaj jedną warstwę na raz.
Krok 2: sprawdź pobrany plik FivePD
Najpierw rozpakuj archiwum poza folderem "live" resources Znajdź jego fxmanifest.lua lub starszy manifest, README, pliki konfiguracyjne i deklaracje zależności. Folder zasobu umieszczony pod resources musi być folderem zawierającym manifest; dodatkowy folder archiwum nad nim jest częstą przyczyną błędu “nie znaleziono zasobu”.
Sprawdź archiwum pod kątem instrukcji dotyczących importu bazy danych, ciągów połączeń, uprawnień i kolejności ładowania. Niektóre pakiety lub rozszerzenia mogą wymagać przechowywania danych w bazie; inne mogą nie. Twórz schematy lub wklejaj SQL tylko wtedy, gdy zainstalowany pakiet wyraźnie tego wymaga. Nigdy nie publikuj haseł do bazy danych w skrypcie klienta, współdzielonej konfiguracji ani publicznym repozytorium.
Krok 3: zainstaluj zależności przed głównym zasobem
Umieść każdą wymaganą zależność w jej własnym folderze zasobu. Potwierdź, że jej nazwa pasuje do manifestu i ensure linii, której zamierzasz użyć. Jeśli dokumentacja określa kolejność, zacznij od współdzielonych bibliotek i mostów baz danych przed FivePD, a następnie uruchom wywołania po zasobie bazowym.
Prosty kształt konfiguracji wygląda następująco:
# 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_calloutTe nazwy są przykładowe. Użyj rzeczywistych nazw katalogów i zasobów z pobranego pliku. Cfx.re’s ensure polecenie uruchamia zatrzymany zasób lub restartuje już działający.
Krok 4: bezpiecznie skonfiguruj wartości po stronie serwera
Dokonaj minimalnej konfiguracji potrzebnej do pierwszego uruchomienia. Przechowuj dane uwierzytelniające i ustawienia uprzywilejowane po stronie serwera. Tam, gdzie pakiet udostępnia domyślne wartości, skopiuj dostarczony przykład i zmień tylko udokumentowane klucze. Nie wymyślaj pól konfiguracyjnych z niepowiązanego samouczka: błędnie wpisany klucz może zostać zignorowany bez powiadomienia, a stara opcja może już nie istnieć.
Jeśli wymagana jest baza danych, użyj dedykowanego użytkownika bazy danych z tylko niezbędnymi uprawnieniami. Zaimportuj pasujące schematy pakietu raz, a następnie potwierdź istnienie tabel. Pomyślny import SQL nie dowodzi, że zasób może się połączyć, więc sprawdź konsolę serwera podczas uruchamiania.
Krok 5: przetestuj podstawowy zasób przed wezwaniami
- Uruchom serwer z zależnościami i FivePD, ale bez opcjonalnych wezwań.
- Obserwuj kompletny log serwera od wykrycia zasobów do uruchomienia.
- Połącz się z czystym klientem i sprawdź konsolę F8 pod kątem błędów klienta.
- Potwierdź tylko udokumentowane podstawowe polecenia i interfejsy.
- Uruchom ponownie zasób i połącz się ponownie, aby ujawnić problemy z kolejnością ładowania lub trwałością.
Następnie dodaj jedno wezwanie, uruchom ponownie i przetestuj. Powtarzaj po jednym. Wezwanie napisane dla innej wersji FivePD może zawieść, nawet gdy podstawowy zasób jest sprawny; zachowaj ostatnią działającą wersję do wycofania.
Typowe błędy instalacji FivePD
| Objaw | Pierwsze sprawdzenie | Bezpieczna następna akcja |
|---|---|---|
| Nie znaleziono zasobu | Folder zawierający fxmanifest.lua i dokładny ensure nazwa |
Popraw poziom katalogu lub nazwę zasobu, a następnie przeskanuj/uruchom ponownie |
| Brak zależności lub eksportu | Zależność jest zainstalowana, kompatybilna i uruchomiona jako pierwsza | Użyj zadeklarowanej wersji pakietu i kolejności ładowania |
| Błąd połączenia z bazą danych | Wartość połączenia tylko dla serwera, użytkownik bazy danych i wymagane schematy | Przetestuj dostęp z serwera i porównaj z dokumentacją pakietu |
| Podstawa działa, ale wezwanie kończy się niepowodzeniem | Kompatybilność wezwania i jego własne zależności | Wyłącz to wezwanie i wróć do znanej, działającej podstawy |
| Klient dołącza, ale UI lub polecenia kończą się niepowodzeniem | Błędy F8 i brakujące pliki klienta w manifeście | Sprawdź manifest zasobu i pliki browser/NUI |
Bezpieczna kolejność aktualizacji
Zrób kopię zapasową działającego zasobu i jego danych, przeczytaj uwagi do wydania, zaktualizuj na staging, a następnie przetestuj bazę przed opcjonalnymi wezwaniami. Nie nadpisuj skonfigurowanego pliku konfiguracyjnego bez porównania. Jeśli aktualizacja zmienia bazę danych, zachowaj zarówno zrzut przed aktualizacją, jak i dokładną wersję pakietu potrzebną do jej przywrócenia.
Ta sekwencja jest celowo konserwatywna: najpierw FXServer, potem zależności, potem FivePD, potem jedno wezwanie. Daje to każdemu niepowodzeniu mały obszar poszukiwań i umożliwia wycofanie zmian bez odbudowy całego serwera.