From 68da2c9b769ac068cb46695e5cddd66b33fc9a51 Mon Sep 17 00:00:00 2001 From: Piotr Dziwinski Date: Tue, 17 Apr 2012 00:32:13 +0200 Subject: Rewritten README.txt; added HOWTO.txt --- HOWTO.txt | 71 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ README.txt | 52 +++++++++++++-------------------------------- 2 files changed, 86 insertions(+), 37 deletions(-) create mode 100644 HOWTO.txt diff --git a/HOWTO.txt b/HOWTO.txt new file mode 100644 index 0000000..0c4e2cc --- /dev/null +++ b/HOWTO.txt @@ -0,0 +1,71 @@ +How to... + +1. Compile the game with MinGW. + + 1. Download and install DirectX 8.1 SDK. It can be difficult to find it now as it is old SDK, but here is a working dowload link: + http://dl.dropbox.com/u/32866936/dx81sdk_full.exe + 2. Download and install MinGW and MSYS: + http://sourceforge.net/projects/mingw/files/Installer/mingw-get-inst/mingw-get-inst-20111118/ + 3. When installing, select all available components. + 4. In the file src/CMakeLists.txt, change "set(DXSDK_DIR "c:/dxsdk") to the directory, where you have DirectX SDK + (the slashes must be in this form: /, not \). + 5. Run MinGW console from the shortcut in menu start. + 6. Change to the directory where you have the Colobot sources by typing "cd /c/where/the/sources/are" + 7. Type "cmake -G 'MSYS Makefiles' ." + 8. Type "make" + 9. Everything should compile without errors. + +2. Run the compiled game. + + 1. Download and unpack the package with the game data files. + 2. Copy the compiled files from bin/colobot.exe, bin/CBot/libCBot.dll + and from the directory, where MinGW is installed bin/libgcc_s_dw2-1.dll and bin/libstdc++-6.dll + to the directory with game data (there should be several files named colobot*.dat). + 3. Create a shortcut to the colobot.exe executable and add to the executed command " -nocd" option. + 4. Run the shortcut and enjoy the game. + +3. But it's in French! How to change the language? + + 1. In the source code, find language.h file and change the line #define FRENCH TRUE to #define FRENCH FALSE and do the reverse + on on the language of your choice (English, German or Polish). + 2. Recompile the game and copy bin/colobot.exe. + 3. In the directory with game data switch the directories scene, script and help with those from the directory of given language + (e.g. english/). + 4. Run the game. + + +PL + +Jak... + +1. Skompilować projekt pod MinGW. + + 1. Ściągamy i instalujemy DirectX SDK w wersji 8.1. Może być problem ze znalezieniem linka bo to już stary SDK, ale można ściągnąć stąd: + http://dl.dropbox.com/u/32866936/dx81sdk_full.exe + 2. Ściągamy i instalujemy MinGW i MSYS: + http://sourceforge.net/projects/mingw/files/Installer/mingw-get-inst/mingw-get-inst-20111118/ + 3. Przy instalacji zaznaczamy wszystkie komponenty do instalacji. + 4. W pliku src/CMakeLists.txt zmieniamy set(DXSDK_DIR "c:/dxsdk") na katalog, gdzie jest zainstalowany DirectX SDK (w wersji 8.1) + (slashe mają być właśnie w takiej postaci: / a nie \). + 5. Uruchamiamy MinGW console ze skrótu w menu start. + 6. Przechodzimy do katalogu, gdzie są źródła wpisując "cd /c/tam/gdzie/sa/zrodla" + 7. Wpisujemy "cmake -G 'MSYS Makefiles' ." + 8. Wpisujemy "make" + 9. Wszystko powinno się skomplikować bez błędów. + +2. Uruchomić skompilowaną grę. + + 1. Ściągamy paczkę z plikami danych gry. + 2. Kopiujemy skompilowane pliki bin/colobot.exe, bin/CBot/libCBot.dll + i z katalogu, gdzie jest zainstalowany MinGW bin/libgcc_s_dw2-1.dll i bin/libstdc++-6.dll + do katalogu z plikami danych (powinno być tam kilka plików colobot*.dat). + 3. Tworzymy skrót do colobot.exe, przy czym w wywoływanej komendzie dopisujemy na końcu opcję " -nocd". + 4. Odpalamy skrót i cieszymy się grą. + +3. Ale gra jest po francusku! Jak zmienić język? + + 1. W kodzie źródłowym znajdujemy plik language.h i zmieniamy #define FRENCH TRUE na #define FRENCH FALSE i robimy odwrotnie + dla wybranego języka (angielski, niemiecki lub polski). + 2. Kompilujemy od nowa grę i kopiujemy bin/colobot.exe. + 3. W katalogu z plikami danych podmieniamy katalogi scene, script i help z tymi z katalogu danego języka (np. english/). + 4. Odpalamy grę. \ No newline at end of file diff --git a/README.txt b/README.txt index 591ab15..c58d6e6 100644 --- a/README.txt +++ b/README.txt @@ -1,46 +1,24 @@ -EN: MinGW development branch +Welcome to Colobot project repository -Status +This repository contains the source files of Colobot game released on open source license (GNU GPLv3) by the producer Epitec CH. +The sources were released and the rights granted to a group of Polish Colobot fans centered around the site http://colobot.cba.pl/ +This repository contains only the source code of the game. The necessary data files will soon be available as a separate download. +For now, though, you can download the original download package released by Epitec (the link is on http://colobot.cba.pl/ site). -This branch will serve as the place for continued work in running the project under CMake and MinGW. -The branch will be strictly tied to the master, but nevertheless separate so as not to break anything. +For more information on the project, see the wiki pages. -Instructions for compiling and running with MinGW. +Status -1. Download and install MinGW and MSYS: +Our first goal has been reached now: the project has been successfully ported to CMake build system and MinGW compiler +from the original MSVC6 project. -2. When installing, select all available components -3. In the file src/CMakeLists.txt, change "set(DXSDK_DIR "c:/dxsdk") to the directory, where you have DirectX SDK (version 8.1) - (the slashes must be in this form: /, not \) -4. Run MinGW console from the shortcut in menu start -5. Change to the directory where you have the Colobot sources: "cd /c/where/the/sources/are" -6. "cmake -G 'MSYS Makefiles' ." -7. "make" -8. Everything should compile without errors -9. Copy bin/colobot.exe, bin/CBot/libCBot.dll and from the directory, where MinGW is installed - bin/libgcc_s_dw2-1.dll and bin/libstdc++-6.dll to where you have the data files colobot*.dat -10. Run colobot.exe with -nocd option +Now our goal is to port the game to OpenGL and SDL, thus making it multiplatform. Further goals include adding +new features to the game, though that will be decided later on. +Compiling and running the game -PL: Gałąź rozwojowa MinGW +For these instructions see HOWTO.txt file. -Status +Contact -Gałąź ta posłuży za miejsce do kolejnych prac nad uruchomieniem projektu pod MinGW. -Będzie ścisle związana z główną, ale mimo wszystko osobna, żeby niczego nie zepsuć. - -Instrukcja jak skompilować i uruchomić pod MinGW - -1. Ściągamy i instalujemy MinGW i MSYS: - http://sourceforge.net/projects/mingw/files/Installer/mingw-get-inst/mingw-get-inst-20111118/ -2. Przy instalacji zaznaczamy wszystkie komponenty do instalacji -3. W pliku src/CMakeLists.txt zmieniamy set(DXSDK_DIR "c:/dxsdk") na katalog, gdzie jest zainstalowany DirectX SDK (w wersji 8.1) - (slashe mają być właśnie w takiej postaci: / a nie \) -4. Uruchamiamy MinGW console ze skrótu w menu start -5. Przechodzimy do katalogu, gdzie są źródła: "cd /c/tam/gdzie/sa/zrodla" -6. "cmake -G 'MSYS Makefiles' ." -7. "make" -8. Wszystko powinno się skomplikować bez błędów -9. Kopiujemy bin/colobot.exe, bin/CBot/libCBot.dll i z katalogu, gdzie jest zainstalowany MinGW - bin/libgcc_s_dw2-1.dll i bin/libstdc++-6.dll do miejsca, gdzie mamy pliki z danymi colobot*.dat -10. Odpalamy colobot.exe z -nocd +If you want to help in the project, please contact us on the forum on our website (there is also an English board). -- cgit v1.2.3-1-g7c22