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.