Density Layer Installer

FS25 SoilFertilizer — instalator warstwy gęstości
==============================================

SZYBKI START (nie wymaga wiedzy technicznej)
------------------------------------------------------
1. Pobierz plik FS25_SoilLayerInstaller.exe
2. Zamknij całkowicie Farming Simulator 25.
3. Kliknij dwukrotnie plik .exe — kliknij „Uruchom instalator”.
4. Uruchom FS25 i załaduj swój zapis. Zrobione.

To wszystko. Instalator automatycznie znajdzie zapisany stan gry i mapę,
tworzy kopię zapasową mapy ZIP i łata wszystko jednym kliknięciem.


CO TO DZIAŁA
------------
Łata modyfikację aktywnej mapy ZIP, aby dodać pięć niestandardowych map gęstości gleby
warstwy (glebaN, glebaP, glebaK, glebaPH, glebaOM). Gdy już są warstwy
obecnie FS25_SoilFertilizer może śledzić składniki odżywcze z dokładnością do pojedynczego piksela
rozdzielczość zamiast jednej średniej wartości na pole.

Bez łatki: każdy piksel w „Polu 3” ma jedną wartość azotu.
Z łatką: każdy piksel ma swoją wartość, więc opryskujemy połowę pola
daje prawdziwy podział na lewą i prawą stronę na nakładce mapy.


WYMAGANIA
------------
- FS25 zamyka się po uruchomieniu instalatora (pliki ZIP nie mogą być blokowane)
- Mod mapy ZIP zainstalowany w folderze Mods
- Co najmniej jeden zapis kariery przy użyciu tej mapy


Tworzenie kopii zapasowych i przywracanie
----------------
Kopia zapasowa tworzona jest automatycznie przed wprowadzeniem jakichkolwiek zmian:
<nazwa mapy>.zip.backup_soilinstaller

Aby cofnąć łatkę:
1. Zamknij FS25.
2. Zmień nazwę pliku .backup_soilinstaller z powrotem na oryginalną nazwę .zip
(usuń przyrostek .backup_soilinstaller).
3. Uruchom FS25 — warstwy gleby zniknęły.


JUŻ POŁATOWANO?
----------------
Ponowne uruchomienie instalatora na już załatanej mapie pokazuje komunikat „Już załatano”
i nic nie robi. W każdej chwili można bezpiecznie ponownie uruchomić.

Aby wymusić ponowną aktualizację, najpierw przywróć kopię zapasową, a następnie ponownie uruchom instalator.


OBSŁUGIWANE MAPY
--------------
Dowolny mod mapy FS25, który:
-Wysyłane jako pojedynczy ZIP w folderze Mods
- Ma swój główny plik i3d pod adresem maps/mapXX.i3d w formacie ZIP
- Przechowuje pliki danych terenowych na mapach/danych/w pliku ZIP

Testowano na: The Pichonniere Valley (FS25_The_Pichonniere_Valley.zip)


UWAGI I UWAGI
---------------
- FS25_SoilFertilizer musi być w wersji 2.2.5.0 lub nowszej, aby wykryć warstwy.
- Na mapach, które już zawierają warstwy o nazwach glebaN / glebaP / glebaK / glebaPH /
soulOM, instalator wykrywa je i pomija — mod używa ich w niezmienionej postaci.
- Puste pliki GRLE stanowią bezpieczny stan początkowy (wszystkie zera).
FS25_SoilFertilizer uzupełnia je automatycznie podczas oprysków i zbiorów.
- Tryb wieloosobowy: wszyscy klienci muszą używać poprawionej mapy ZIP, aby uzyskać spójne wyniki.


ROZWIĄZYWANIE PROBLEMÓW
---------------
„Nie znaleziono zapisu stanu gry”
Upewnij się, że masz co najmniej jeden zapis kariery w:
Dokumenty\Moje gry\FarmingSimulator2025\savegame1

„Nie znaleziono pliku ZIP mapy”
Nazwa moda mapy w zapisie gry nie pasuje do żadnego kodu ZIP w modach
folderze. Potwierdź, że mod mapy jest zainstalowany i spróbuj ponownie.

Minimapa nie pokazuje kolorów gleby po załadowaniu
Poczekaj kilka sekund — nakładka zostanie odbudowana w cyklu 2-sekundowym.

Wynik „częściowego sukcesu”.
Może brakować jednej lub więcej warstw. Przywróć kopię zapasową, zgłoś
problem (dołącz dziennik instalatora) i nie ładuj FS25, dopóki nie zostanie to potwierdzone.


ZAAWANSOWANE/KORZYSTANIE Z CLI
------------------
Jeśli wolisz wiersz poleceń, dołączony jest także oryginalny skrypt Pythona:

python SoilLayerInstaller.py

Wymaga Pythona 3.8 lub nowszego. Ta sama logika co GUI, wyjście w konsoli.