Wersja alfa 1.0.73Wersja przełomowa o tyle, że zawiera działający instalator paczek.
Zaraz po uruchomieniu, a przed wybraniem scenerii, w miejscu guzika
Losuj tekstury jest guzik
Instalator dodatków. Otwiera on formę (okno) instalatora. Instalator nie ma nic wspólnego z pozostałymi zakładkami głównej formy programu. Na formie instalatora górnymi zakładkami wybieramy kategorię dodatku. Poniżej zakładek, umieszczone są listy:
- Typy - typy dodatków w ramach kategorii, np. EU07, poniżej przycisk odświeżający.
- Wersje - głównie w przypadku pojazdów może występować kilka wersji (generacji) tego samego typu, np. kolejne modele EU07. Poniżej listy jest opis wybranej wersji.
- Paczki - lista paczek w ramach wybranej wersji. Poniżej nieaktywny przycisk, który kiedyś będzie umożliwiał sprawdzenie najnowszych paczek.
Po wybraniu typu, wersji i paczki, w okienku po prawej pojawi się informacja tekstowa o wybranej paczce. Jeśli istnieje tylko jedna wersja lub jedna paczka, zostaną one automatycznie wybrane, a lista będzie zablokowana.
Po wybraniu paczki powinien się uaktywnić przycisk
Pobierz informacje. Pobiera on skrypt instalacyjny z serwera, a następnie zmienia opis paczki na ten ze skryptu oraz pobiera i wyświetla miniatury obrazków, o ile są one określone w skrypcie. Jeśli skrypt jest już pobrany, przycisk nie będzie aktywny, a informacja tekstowa i miniatury wyświetlą się od razu. Po kliknięciu na miniatury pobierze się i wyświetli obrazek powiększony.
Przycisk
Sprawdź instalację sprawdza, w jakim stopniu paczka została już zainstalowana - porównując długości plików i ich sumy kontrolne z zapisanymi w skrypcie instalacyjnym. Wyświetla się procent zgodnych plików. Jeśli paczka została już zainstalowana, pokaże się 100.00%, a 0.00% to kompletny brak plików z paczki. Czasem przed zainstalowaniem może być np. 9.09%, co oznacza, że 1 z 11 plików został znaleziony. (Docelowo będzie szczegółowa informacja o różnicach pomiędzy plikami.)
Przycisk
Pobierz paczkę sprawdza obecność paczki w katalogach wpisanych na zakładce
Paczki głównej formy programu. Jeśli nie zostanie ona znaleziona (w sensie długości i sumy kontrolnej), zostanie pobrana z linku podanego w skrypcie instalacyjnym i zapisana w katalogu
download. Zalecane jest, by przed użyciem instalatora
wejść na zakładkę Paczki i dodać wszystkie katalogi, w których mogą być umieszczone paczki z plikami do MaSzyny. Nie będą one wtedy ściągane po raz kolejny.
Przycisk
Instaluj paczkę robi to samo, co wymieniony wyżej, a następnie uruchamia instalację.
Na chwilę obecną dostępne są skrypty instalacyjne dla Lxd2, wagonów Villach oraz dla nowego nieba Sigmana.
Idea instalatoraStruktura paczek jest odczytywana z pliku
packinfo\install.ini, pobieranego z serwera. Są w nim 4 główne sekcje:
- [FULL] - paczki całościowe,
- [DYNAMIC] - pojazdy,
- [SCENERY] - scenerie,
- [OTHER] - pozostałe dodatki, np. nieba.
W każdej sekcji są wpisy typu:
nazwa.wersja=opis wersji
Dalej są sekcje
[nazwa.wersja] z listami paczek. W takiej sekcji znajduje się lista paczek w następującej postaci:
paczka.rar=*DATA-DŁUGOŚĆ-CRC32
*DATA-DŁUGOŚĆ-CRC32=opis paczki
gdzie ciąg
DATA-DŁUGOŚĆ-CRC32 jest kluczem identyfikacyjnym paczki, który będzie umożliwiał zainstalowanie paczki poprzez przeciągnięcie jej myszą do programu. Klucz ten jest użyty również do nazwania pliku (skryptu) instalacyjnego.
Po wybraniu paczki w oknie instalatora, pobierany i przetwarzany jest skrypt instalacyjny.
Budowa skryptu instalacyjnegoSkrypt instalacyjny ma format pliku INI o następujących sekcjach:
- [INFO] - zawiera informacje o paczce w różnych jeżykach - aktualnie używany jest jedynie klucz pl=, zawierający opis paczki w języku polskim.
- [VERIFY] - lista plików, które powinny być obecne po zainstalowaniu paczki.
- [DYNAMIC.DAT] - lista wpisów do DYNAMIC.DAT, jeszcze nie obsługiwana.
- [ARCHIVES] - lista paczek składających się na dodatek.
- [PREVIEW] - lista obrazków podglądu, aktualnie obsługiwane są pierwsze dwa.
- [DOWNLOAD] - lista linków do paczek, na wypadek awarii można podać wiele linków do jednej paczki.
- [TEXTURES.TXT] - lista katalogów, w których należy utworzyć pliki TEXTURES.TXT. Zawartość tych plików pobierana jest ze wskazanych sekcji.
- [paczka.rar] - sekcja o nazwie paczki, określająca metodę jej zainstalowania i opcjonalnie listę plików do przekopiowania.
Obecnie są obsługiwane 3 metody instalacji:
-
temp - paczka rozpakowywana do tymczasowego katalogu, a wyszczególnione w sekcji następnie pliki kopiowane pojedynczo,
-
copy - służy do kopiowania pliku, który nie został spakowany, np. wav, scn,
-
raw - paczka jest wypakowywana bezpośrednio (w przyszłości będą dodatkowo możliwe zmiany nazw plików i usuwanie zbędnych po rozpakowaniu).
W planach:
-
exe - do paczek z instalatorem - uruchomienie instalatora (np. UHARC),
-
ini - uruchomienie innego skryptu instalacyjnego,
-
fix - uruchomienie pliku poprawkowego,
-
one - wypakowywanie pojedynczych plików z paczki.
Metoda instalacji znajduje się w sekcji każdej paczki, w linii z
*=. Dla każdej paczki możliwy jest inny typ instalacji, jeśli na jeden dodatek składa się kilka paczek.
W obecnej wersji, instalator potrafi:
- Zweryfikować zainstalowanie paczki - sekcja [VERIFY] pliku instalacyjnego. Podaje procent znalezionych plików. Docelowo będzie możliwość wyświetlenia informacji o znalezionych plikach w odniesieniu do podlegających instalowaniu.
- Pobrać brakujące paczki - sekcja [DOWNLOAD] pliku instalacyjnego. Pliki nie są pobierane, jeśli zostaną znalezione w katalogach wpisanych na zakładce Paczki.
- Pobrać i wyświetlić dwa miniaturowe obrazki 150×113 dla wybranej paczki - sekcja [PREVIEW] pliku instalacyjnego. W tej sekcji są nazwy dużych obrazków, nazwy miniatur są tworzone poprzez dodanie kreski _ przed kropką rozszerzenia. Po kliknięciu na miniaturę, pobiera się i wyświetla duży obrazek (zalecana rozdzielczość 640×480).
- Tworzyć pliki TEXTURES.TXT, dodając wpisy ze wskazanej sekcji pliku instalacyjnego.
Oczywiście zachęcam też do tworzenia skryptów instalacyjnych. Najwięcej pracy wymaga przygotowanie zestawu obrazków do kompletu. Przy przerabianiu plików produkowanych podczas katalogowania (i dostępnych na stronach paczek) trzeba uważać na zamianę kresek z / na pecetowe \ oraz pierwszego przecinka po nazwie pliku/paczki na znak równości. Spakowany plik instalacyjny wraz z obrazkami (miniatura ma dodatkowo kreskę przed kropką rozszerzenia) można przesłać standardową procedurą zgłaszania nowych dodatków do testów poprzez
uploader - po sprawdzeniu umieszczę na serwerze. Posiłkować się proszę również tym, co się ściąga do katalogu
packinfo.
Problematyczne jest na razie instalowanie tekstur, ponieważ powinny trafić do odpowiedniego katalogu (np.
EU07.v05), a nie ma jeszcze oficjalnego podziału pojazdów na wersje.