Jak dodać FiveM MLO do swojego serwera

Publiczność: Właściciele serwerów i programiści, którzy już obsługują działającą instancję FiveM i chcą ją rozszerzyć o niestandardowe zasoby map wewnętrznych/zewnętrznych (MLOs).

1 · Wymagania wstępne

Wymaganie	Minimalna wersja	Dlaczego to ma znaczenie
Artifakt serwera FiveM	6016 (build 7116) lub nowszy	Starsze artifacty nie mogą ładować nowoczesnych `cerulean` manifestów fx.
Loader map (wbudowany)	Natywnie domyślnie	Nie wymaga dodatkowych wtyczek —FiveM strumieniuje pliki map automatycznie.
Dostęp do serwera	SFTP/SSH + uprawnienia do zapisu	Musisz przesyłać pliki i edytować server.cfg.
Licencja prawna	Dowód zakupu / warunki darmowego użytkowania	EU RODO i polityka Rockstar zabraniają dystrybucji nielicencjonowanych zasobów.

2 · Pobierz i sprawdź pakiet MLO

Integralność źródła – Preferuj dostawców z archiwami zip podpisanymi SHA‑256 lub publicznymi znacznikami Git.
Zweryfikuj strukturę – Zgodny zasób wygląda następująco:

my-mlo/
 ├─ stream/
 │ ├─ *.ydr ↰ (models)
 │ ├─ *.ytyp ↰ (item definitions)
 │ ├─ *.ybn ↰ (collisions‑―if supplied)
 │ └─ *.ytd ↰ (textures)
 ├─ fxmanifest.lua
 └─ README.md (optional)

Tworzyć fxmanifest.lua jeśli brakuje – Minimalny szablon:

fx_version 'cerulean'
games { 'gta5' }

author 'YourName'
description 'My Custom MLO'
version '1.0.0'

this_is_a_map 'yes'

files {
 'stream/**/*.ydr',
 'stream/**/*.ytyp',
 'stream/**/*.ytd',
 'stream/**/*.ybn'
}

data_file 'DLC_ITYP_REQUEST' 'stream/**/*.ytyp'

ℹ️ Manifesty zasobów standardów są zgodne ze schematem w Dokumentacja FiveM → “Manifest zasobu” (commit 20b7b15, 2025‑03‑11)

3 · Prześlij zasób

Połącz się przez SFTP z katalogiem głównym swojego serwera.
Przejdź do /resources/[maps]/—utwórz folder z nawiasami, jeśli nie istnieje.
Prześlij cały my-mlo katalog niezmieniony. Unikaj spacji i wielkich liter w nazwach folderów, aby zapobiec problemom ze ścieżkami w systemie Linux.

4 · Zarejestruj w `server.cfg`

Dołącz (lub zastąp start) po niezbędne podstawowe zasoby:

ensure my-mlo # loads on boot; restarts automatically on txAdmin soft‑restarts

Zapisz plik i uruchom ponownie serwer lub wykonaj refresh ➜ ensure my-mlo w konsoli na żywo.

5 · Wyczyść pamięć podręczną i uruchom ponownie (jeśli to konieczne)

FiveM przechowuje w pamięci podręcznej dane map. Aby uniknąć duchów starszych wersji:

# Linux
rm -rf cache/*
./run.sh +exec server.cfg

# Windows (PowerShell)
Remove-Item -Recurse -Force .cache*
run.cmd +exec server.cfg

Jak wyczyścić pamięć podręczną serwerów FiveM

6 · Lista kontrolna weryfikacji w grze

Sprawdzać	Polecenie/narzędzie	Kryteria zaliczenia
Teleport	vMenu → Misc → Teleport → Enter Coords	Gracz pojawia się w nowym wnętrzu/na zewnątrz.
Integralność tekstur	`profile_frame` następnie chodź dookoła	Brak różowych/białych placeholderów; spadek FPS < 10%.
Kolizja	Spaceruj po ścianach i rampach	Brak niewidzialnych barier ani zapadania się przez podłogę.
Oświetlenie	Zmiana pory dnia za pomocą `/time 23 0`	Wnętrze prawidłowo ciemnieje/rozjaśnia się bez artefaktów.

Jeśli wystąpią jakiekolwiek błędy, sprawdź ponownie listę plików – brakujący .ytd Lub .ybn jest zwykle winowajcą.

7 · Bezpieczne strumieniowanie wielu MLOs

Jeden zasób na MLO. Pozwala to uniknąć kolizji hash.
Poprzedź nazwy tagiem dostawcy, np. bh-bank-lobby, aby ułatwić wyłączanie.
Używaj identycznej wersji manifestu we wszystkich zasobach mapy, aby uniknąć ostrzeżeń parsowania.

8 · Szybki przewodnik rozwiązywania problemów

Objaw	Prawdopodobna przyczyna	Rozdzielczość
Konsola: Nie można sparsować manifestu	Błędna składnia Lua	Uruchom `lua -p fxmanifest.lua` lokalnie; napraw cudzysłowy/przecinki.
MLO widoczne, brakujące tekstury	`.ytd` nieprzywołane pliki	Dodaj je do `files{}` lub umieść w `stream/`.
Gracze crashują przy dołączaniu	Zduplikowany hash propów między mapami	Zmień nazwę duplikatu `.ydr` lub wyłącz konfliktowy zasób.
Długi czas pobierania	Duże `.ytd` tekstury	Kompresuj tekstury (DXT5/BC3) lub zmniejsz skalę.

9 · Uwagi dotyczące zgodności i ochrony danych

Regulamin / Polityka	Co musisz zrobić
Rockstar Polityka Modowania (2015-09-15)	Nie sprzedawaj zasobów zawierających Rockstar IP.
RODO UE Art. 44-49	Przechowuj faktury od sprzedawców; ujawniaj pochodzenie zasobów na żądanie użytkownika.
FiveM ToS §3.2	Zachowaj integralność kredytów; nie rozpowszechniaj płatnych modów publicznie.

Podsumowanie

Prześlij → ensure → zrestartuj; jeśli manifest jest prawidłowy, Twoje nowe wnętrze będzie aktywne w ciągu dwóch minut.

Potrzebujesz nowego MLOs?

Źródła

FiveM Dokumentacja – Manifesty zasobów (dostęp 22 maja 2025 r.)
Rockstar Games – Polityka modowania, 15 wrz 2015
Rozporządzenie (UE) 2016/679 (RODO), Artykuły 44-49