Wprowadzenie
Konwencje stosowane w podręczniku
tu są instrukcje
W niebieskiej ramce prezentowane są fragmenty plików misji lub programów. Pogrubiony tekst oznacza wyszczególnienie informacji, a kursywa - symbol, do którego odwołanie znajduje się w dalszej części tekstu. W przypadku opisów składni polecenia CBOT - pogrubione mogą zostać słowa kluczowe.
Co potrzebne Do tworzenia własnych poziomów będziemy potrzebowali następujących narzędzi i programów: System operacyjny, na którym będą działać poniższe narzędzia, czyli Windows 98/Me/2k/XP/Vista. Bardziej ambitni użytkownicy mogą się pokusić o zainstalowanie Colobota na Linuxie, np. na emulatorze Wine, Cedega itp. Gra Colobot Edytor tekstu: na przykład vim z kolorowaniem składni dla colobota.` Zaawansowany program graficzny, np. Photoshop, GIMP itp. Prosty program graficzny do rysowania, np. windowsowy Paint
Słowniczek wysokość bezwzględna - wysokość względem koloru białego w pliku rzeźby terenu. kolor bez przezroczystości - zapis koloru (zobacz niżej) bez podania czwartej wartości. ułamek jedynkowy - wartość większa od zera i mniejsza od jedynki. Ułamek dziesiętny.
Formatowanie wartości Pozycja
x;y
x, y - położenie punktu
Kolor
r;g;b;a
r, g, b - wartości kolorów: czerwonego, zielonego i niebieskiego. Możliwe wartości: 0 - 255. a - przezroczystość. Od 0 do 255.
r;g;b
Określenie koloru bez przezroczystości.
Środowisko pracy, foldery Wszystkie własne poziomy tworzyć będziemy w katalogu user. W nim muszą znaleźć się katalogi opisujące grupy poziomów (w praktyce planety). Najlepiej w nazwach folderów stosować na początku liczby, np.
01_Merkury 02_Wenus 03_Ziemia 04_Mars
itd. Dzięki temu planety będą według naszej kolejności, nie alfabetycznej.
Ścieżki do plików Podczas tworzenia misji należy użyć plików aby opisać rzeźbę terenu, zasoby planety, tło, programy Obcych itp. Pliki te powinny znaleźć się w katalogu planety. Można korzystać też ze standardowych plików (używanych we wbudowanych misjach).
Aby odwołać się do stworzonego przez siebie pliku np. terrain1.bmp, który będziemy potrzebować np. na Wenus, należy ten plik umieścić w katalogu user\02_Wenus. Z kodu misji w odpowiednim miejscu trzeba napisać: %user%\terrain1.bmp. Przykład:
Jeśli korzystasz z wbudowanych plików, nie poprzedzaj nazwy pliku tekstem "%user%\"
Plik scene00.txt W tym pliku jest zamieszczona nazwa planety. Jego zawartość to:
Title.J text="opisowa" resume="krótka"
J - język do użycia, w przypadku wielojęzykowości może być kilka linii PpolskiEangielskiFfrancuski
opisowa - nazwa opisowa, widoczna na liście misji. krótka - nazwa użyta przy zapisywaniu.
Pliki misji W tych plikach zapisana jest treść misji. Zawartość takiego pliku przedstawiono poniżej. Nazewnictwo plików misji Nazwy, są to "scenenn.txt". nn to numer kolejny z zerem (np. scene01.txt)
Ważne informacje o składni Komentarze
Tu wpisz jakieś instrukcje (choć nie jest to konieczne) // tu wpisz komentarz
Komentarze zaczynają się od znaków // a kończą wraz z końcem linii.
Zapis liczb Liczby zapisujemy z kropką jako seperatorem dziesiętnym.
Komendy dotyczące nazw i plików pomocy
Nazwa misji
Title.J text="tytuł" Resume.J text="opis"
Te linie przechowują tytuł i opis misji. J - język, jak przy scene00.txt tytuł - Zwięzły tytuł, widoczny na liście opis - tekst widoczny w polu "streszczenie"
Domyślna nazwa nowych programów
ScriptName.J text="nazwa"
J - język nazwa - Domyślna nazwa funkcji
Pliki pomocy
Instructions name="ścieżka" // Zadania misji Satellite name="ścieżka" // Raport z satelity Loading name="ścieżka" // Programy z Houston SoluceFile name="ścieżka" // Rozwiązanie HelpFile name="cbot.txt" // Podręcznik programowania
Definiuje pliki pomocy pokazywane w SatCom. Jeśli nie chcesz definiować wszystkich, pomiń niektóre linie.
ścieżka - Ścieżka do pliku. Pamiętaj o %user%\ w przypadku plików w katalogu użytkownika!
Nazwy plików misji zwyczajowo powinny zaczynać się od: Zadania misjimhelpRaport satelitarnyminfoProgramymloadRozwiązaniemsolu Takie nazewnictwo nie jest jednak konieczne.
Przykład:
Satellite name="%user%\minfo01.txt"
oraz:
Satellite name="%user%\sat01.txt"
Wyświetlenie SatCom na początku misji Wystarczy na końcu wiersza dodać "immediat=1" aby otworzył się SatCom na początku misji z wybraną stroną. Przykład:
Instruction name="%user%\INSTRUCT1.txt" immediat=1
spowoduje otwarcie SatCom z zadaniami misji na jej początku. Często stosowane w Ćwiczeniach i Wyzwaniach programistycznych.
Pliki obrazów wygranej / przegranej
EndingFile win=w lost=p
w - numer pliku wygranej (winw.txt z dodanymi zerami) p - numer pliku przegranej (lostp.txt z dodanymi zerami)
EndingFile win=12 lost=0
Plik wygranej win012.txt, plik przegranej lost000.txt (z katalogu wbudowanych misji)
Niestety nie można zdefiniować własnych plików...
Czas wyświetlania informacji
MessageDelay factor=n
n - czas wyświetlania. 1 - normalne, 2 - 2 razy dłużej, 0.5 - o połowę krócej.
W związku z tym, że domyślnym czasem jest 5 sekund, można przeliczyć na sekundy:
n - wartość do MessageDelay t(s) - czas w sekundach
Komendy dotyczące otoczenia
Muzyka w tle
Audio track=n
n - numer ścieżki z płyty CD-audio, 0 oznacza ciszę.
Kolor otoczenia
AmbiantColor air=ląd water=woda
ląd - Kolor "otaczający" na lądzie. woda - Kolor "otaczający" w wodzie. Kolor otaczający to kolor, który jest niezależny od źródeł światła.
Tej komendy należy użyć jedynie do budowania "nastroju" misji. Typowe wartości to:
AmbiantColor air=102;102;102;102 water=20;20;20;20
Zwykle kolor powienien być szary (wszystkie wartości RGB takie same). Jeśli ma być ciemniej, należy zmniejszyć te wartości. Przezroczystość jest ignorowana.
Kolor zamglonych obiektów Obiekty, które są słabo widoczne mają odmienny kolor od standardowego. Można ustawić to komendą:
FogColor air=ląd water=woda
Kolory są formatowane jak zwykle. Kolor wody zwykle jest zielonkawy lub niebieski, np. 10;20;100;0. Kolor lądu zależy od nastroju planety.
Kolor robotów
VehicleColor color=kolor
kolor - kolor fragmentów robotów i budynków, użyty zamiast standardowego szarego.
Kolor roślin
GreeneryColor color=kolor
kolor - kolor roślin, będzie identyczny dla wszystkich!
Kolor Obcych
InsectColor color=kolor
kolor - kolor Obcych, będzie identyczny dla wszystkich!
Widoczność
DeepView air=ląd water=woda
Wartości podajemy w metrach. Decydują one o tym, jak daleko widać.
FogStart air=ląd water=woda
Tutaj wartości (ułamki jedynkowe) decydują o tym, jak gęsta jest mgła. Im mniejsza wartość, tym gęstsza, tzn. tym wcześniej się zaczyna. Aby obliczyć, gdzie zaczyna się mgła (od kamery 3D) należy pomnożyć wartość z DeepView przez tę z FogStart. Przykład:
DeepView air=200 FogStart air=0.4
Mgła zacznie się 80m od kamery.
Brud
SecondTexture rank=t
t - typ brudu, wartość od 0 do 8. 0 oznacza brak brudu. Wartości 1 - 8 różne jego rodzaje.
Tło
Background image="obraz" up=góra down=dół
Tworzy tło (np. nieruchomy fragment mgławicy). obraz - Plik z obrazem do użycia (BMP lub TGA). Maksymalne wymiary: 1280x480px. góra, dół - Kolory do użycia, gdy gracz wyłączy opcję "Niebo". Wtedy zostanie wyświetlony gradient tych kolorów (płynne przejście).
Background up="góra" down="dół" cloudUp="chmury-góra" cloudDown="chmury-dół"
góra, dół - kolory do użycia (gradient) (przy wyłączonej opcji Niebo) chmury-góra, chmury-dół - Kolory do gradientu, gdy opcja Niebo jest włączona. Chmury (polecenie TerrainCloud) zostaną nałożone na gradient.
Background up="góra" down="dół"
Tworzy prymitywne tło wyłącznie z gradientu.
Efekt soczewki
FrontsizeName image="obraz"
obraz - Nazwa pliku z obrazem dolnej połówki efektu soczewki obiektywu. Tłem powinien być kolor czarny.
Jeśli nie chcesz tworzyć pliku, po prostu napisz:
FrontsizeName image="lens5.tga"
Ruchome ciała niebieskie
przykład:
Planet pos=1.2;0.2 dim=0.40 speed= 0.000 dir=0.5 image="planet02.tga" uv1=0.0;0.0 uv2=0.5;0.5 pos - pozycja na niebie speed - prędkość image - obraz
Komendy dotyczące gruntu
Komenda startowa
TerrainGenerate vision=widoczność depth=1 hard=twardość
widoczność - Widoczność gruntu, musi być co najmniej dwukrotnością widoczności objektów. (DeepView) twardość - Twardość gruntu, decyduje o odgłosach. Ułamek jedynkowy.
Wiatr
TerrainWind speed=NS;WE
NS - szybkość wiatru z północy na południe. Użyj wartości ujemnej aby wiał w kierunku przeciwnym. WE - szybkość wiatru z zachodu na wschód. Użyj wartości ujemnej aby wiał w kierunku przeciwnym.
Burze elektromagnetyczne
TerrainBlitz sleep=s delay=d magnetic=m
s - Czas przed pierwszym uderzeniem. Użyteczne, gdy nie ma statku kosmicznego (czas na zbudowanie Odgromika). d - Czas pomiędzy błyskawicami. m - Promień "pochłaniania" piorunów przez objekty. Jeśli piorun uderzy dostatecznie blisko objektu, zostanie on zniszczony. 0 spowoduje, że burza będzie nieszkodliwa.
Rzeźba terenu (zaczynają się ciekawsze rzeczy ;)
TerrainRelief image="plik" factor=f
plik - Obraz rzeźby terenu do użycia. Musi to być bitmapa w skali szarości (256 odcieni) o wymiarach 161x161px. Im ciemniej na obrazie, tym wyżej. Np. mała czarna plamka oznacza wysoką i stromą górę. f - Zależność wysokości od koloru, zazwyczaj 1.
Zasoby podglebia
TerrainResource image="plik"
plik - Obraz zasobów gruntu (bitmapa 256 kolorów z odpowiednią paletą). Kolory przedstawiono poniżej.
RGBIndeks palety kolorówRodzaj zasobu 255;0;0 5Ruda tytanu 255;255;0 35Ruda uranu 0;255;0 30Złoże energii 0;204;0 24Klucz A 51;204;0 25Klucz B 102;204;0 26Klucz C 153;204;0 27Klucz D
Pobierz obraz bazowy do tworzenia plików zasobów.
Woda
TerrainWater image="obraz" level=poziom moveX=faleX moveY=faleY color=kolor brightness=efekt
obraz - Ścieżka do pliku z obrazem tekstury powierzchni wody. Plik BMP lub TGA. poziom - Poziom wody względem koloru białego w pliku rzeźby terenu. faleX - wielkość falowania poziomego faleY - wielkość falowania pionowego
Ponieważ rozpryski i "kółka" na wodzie nie są teksturowane obrazem, a jednolitym kolorem, należy zdefiniować ten kolor: kolor - Kolor wody efekt - Jasność efektu rozbryzgiwania się wody przy wchodzeniu do niej. Ułamek jedynkowy.
TerrainLava mode=1
Powoduje, że woda zamienia się w lawę (wejście powoduje zniszczenie lub śmierć).
Chmury
TerrainCloud image="obraz" level=poziom
obraz - Ścieżka do pliku BMP lub TGA, wygląd chmur. Maksymalne wymiary: 640x480px. poziom - Wysokość chmur.
Proste tekstury gruntu
TerrainInitTextures image="nazwa" dx=wymiarX dy=wymiarY table=rozkład
nazwa - część nazwy pliku (z rozszerzeniem). Przed kropką sygnalizującą rozszerzenie zostanie włączony trzycyfrowy numer (zobacz poniżej) wymiarX, wymiarY - wymiary "tabeli" tekstur rozkład - oddzielone średnikami numery plików, które wypełnią tabelę
Przykład
TerrainInitTextures image="%user%\gr.bmp" dx=5 dy=2 table=1;2;3;4;5;18;19;20;2;3
Spowoduje wygenerowanie "tabeli" tekstury z teksturami z plików z katalogu użytkownika: gr001.bmpgr002.bmpgr003.bmpgr004.bmpgr005.bmpgr018.bmpgr019.bmpgr020.bmpgr002.bmpgr003.bmp Taka konstrukcja będzie powtarzana poziomo i pionowo.
Wymiary pliku powinny wynosić 512x512px, bitmapa 24 bitowa, plik BMP
Zaawansowane tekstury gruntu
W Colobocie istnieje możliwość szczegółowego zaprogramowania, jaki rodzaj tekstury będzie wykorzystywany na określonej wysokości, stromiźnie itp. Np. możliwe jest coś takiego: Na wysokości powyżej 40m skała. Powyżej 43m śnieg, o ile nie jest stromo i śnieg tylko na 70% możliwej powierzchni. Mało tego, tekstury i przejścia między nimi mogą być malowane w programie graficznym. Bardzo dobry do tego jest darmowy GIMP.