Commit 3045b717 authored by Julien Puydt's avatar Julien Puydt

Import Upstream version 0.15.1

parents

Too many changes to show.

To preserve performance only 1000 of 1000+ files are displayed.

We are sorry about this empty file which is forced on us by autotools.
Software which tries to be smarter than you is never good.
The list of authors is in the CREDITS menu of the game.
Autotools require this file. Do not blame us.
This diff is collapsed.
This diff is collapsed.
Currently the FreedroidRPG development team needs:
* Artists
We have a lack of skilled graphics artists, especially those that can create pretty things with 3D tools.
All current graphics sources are .blend, but whatever software is your preference is fine by us, as long as the sources are saved in a format accessible to free tools like e.g. Blender.
* Sound designers
We are not very satisfied with the quality of our sound effects.
If you have the tools and ability to make sound effects, we'll be glad to hear from you.
* Coders
The more coders the more new features and bug fixes. So if you like FreedroidRPG and know C then do not be afraid to get in touch with us on IRC or the mailing list. :)
* Content creators
What's the point of having code and pretty graphics if you do not have content?
Designing maps and really good dialogs and story lines takes good imagination and a lot of time.
So even if you know nothing about programing or drawing, your contribution can be very useful indeed.
At the end of the day, it's the content that makes or breaks an RPG game.
By all means, you should also check http://www.freedroid.org/developer-area/contribute/ since it is more likely to be up-to-date.
Finally, remember that no contribution is too small to be interesting. :)
/FreedroidRPG development team
Find us at
Website ................ http://www.freedroid.org/
Forum ................ https://sourceforge.net/apps/phpbb/freedroid/
IRC channel ................ #freedroid on irc.freenode.net or
http://webchat.freenode.net/?channels=freedroid (requires Javascript)
Mailing list ................ freedroid-discussion@lists.sourceforge.net
Sourceforge project page ... http://sourceforge.net/projects/freedroid/
FreedroidRPG Installation
=========================
To build FreedroidRPG from source on a Unix-like system, you will use the "standard" GNU autotools way.
Dependencies
============
FreedroidRPG requires the following libraries, along with, on the Linux distributions that split them, their associated -dev package.
Make sure you install them before attempting to build.
SDL
SDL_image
SDL_gfx
SDL_mixer (optional)
libogg (optional)
libvorbis (optional)
OpenGL (optional)
lua (optional, packaged in the source tree if not available system-wide)
The packages to install are listed below, depending on your distribution.
1) Debian/Ubuntu
sudo apt-get install libsdl1.2-dev libsdl-mixer1.2-dev libsdl-gfx1.2-dev libsdl-image1.2-dev libogg-dev liblua5.1-dev
2) Fedora
yum install SDL_image-devel SDL_net-devel SDL_mixer-devel SDL_gfx-devel libjpeg-devel libpng-devel libvorbis-devel libGLU-devel
3) Archlinux
pacman -S libgl libvorbis lua sdl sdl_gfx sdl_image sdl_mixer
There is also a freedroidrpg-svn pkgbuild at the arch user repository: https://aur.archlinux.org/packages.php?ID=30257
4) Please contribute lists for your distribution!
Building with autotools
=========================
1) Open a terminal.
a) Via right click in some file browsers.
b) Via main menu (usually "System" entry).
Move to the FreedroidRPG source directory using "cd ./XYZ/" command. XYZ = path to the FreedroidRPG source.
2) If you are running an SVN version of the game, you will first need to generate the
configure script by running:
./autogen.sh
If you don't know what the SVN version is, you are not running it and can skip this step.
3) Run the configure script:
./configure
You can check the options it accepts with --help.
If you are running MAC OSX you will probably want to use ./configure --with-apple-opengl-framework
During the configure process, the terminal may notify you that some software is required.
Install the required packages and restart ./configure.
4) If ./configure finishes without errors or warnings, then proceed with building the game with:
make
5) Installation
a) "make install" will install the game system-wide. You need to be root for this. The binary name is freedroidRPG.
Hint: you can speed up "make" process using "make -j n". Replace "n" with number of jobs.
For more information execute "make --help".
b) If you are working with the source tree and want to svn update regularly we
recommend the following instead:
Do not issue "make install", instead, simply go to the src/ subdirectory, and run
./freedroidRPG.
Cross compile for Windows with autotools
========================================
Provided you have a cross compiler installed and set up (see
below for more details), use the following configure line:
$ ./configure --prefix=/path/to/the/cross/compiler --host=i686-pc-mingw32 --without-x --enable-nls LIBS="-lintl"
One critical point is to make sure you have all required libraries installed.
You will need to have libogg and libvorbis for sound and music, and will need libintl and its dependencies
to provide translation support.
The binary we ship supports all those features and is built with autotools.
In special cases we may agree to sending you the complete cross-compiler archive so you can build win32 binaries
easily.
Building In Windows
===================
1) Installation of Python
Python will be needed during the build of FreedroidRPG, so you frist need to install it.
Download and install ActivePython from http://www.activestate.com/activepython/downloads
2) Installation of MinGW
Before trying to build FreedroidRPG under Windows, you need to setup a development environment that will "mimic" a Unix development environment:
Get the lastest version of MinGW from http://sourceforge.net/projects/mingw/files/Automated%20MinGW%20Installer/mingw-get-inst/
Run the downloaded installer, and:
* Choose to 'download latest repository catalogues'
* Choose following destination: C:\MinGW (if you choose an other destination, you'll have to adapt the rest of this How-To)
* On the components selection screen, add 'MinGW Developer Toolkit'
Once installed, you'll have a new MinGW entry in your Start Menu, and a MinGW Shell subentry.
Launch MinGW Shell, and in the terminal window just opened, type:
mingw-get install msys-wget
mingw-get install msys-unzip
mingw-get install msys-mintty
If you want a better terminal than the one provided by default, open the properties of the MinGW Shell menu subentry (by right-clicking on it), and change the target to
C:\MinGW\msys\1.0\msys.bat --mintty
and launch a new MinGW Shell.
Nota: When you start a MinGW Shell, the current directory is your HOME directory. This HOME directory can be found in
C:\MinGW\msys\1.0\home\<your_username>
3) SVN installation
To retrieve FreedroidRPG source files, you will need to use Subversion (SVN in short) (http://subversion.apache.org/).
There are several graphical Windows clients for SVN, the most known and used being TortoiseSVN. Here, we will use the command line client.
To download, extract and install the SVN tool, type the following commands in a MinGW Shell:
wget http://alagazam.net/svn-1.6.16/svn-win32-1.6.16.zip
If that doesn't work, try_
wget slaxer.com/chucks/svn-win32-1.6.16.zip
unzip svn-win32-1.6.16.zip
cd svn-win32-1.6.16
cp -r bin iconv share /
cd
4) FreedroidRPG dependencies installation
In order to compile FreedroidRPG, you have to first install some library dependencies. We provide those libraries in 2 binary packages, so you do not need to compile them yourself
In a MinGW Shell, type the following commands:
wget http://buildbot.freedroid.org/downloads/freedroidRPG_dev.tar.gz
wget http://buildbot.freedroid.org/downloads/freedroidRPG_dependencies.zip
cd /
tar -xzf ~/freedroidRPG_dev.tar.gz
cd /bin
unzip ~/freedroidRPG_dependencies.zip
cd /c/WINDOWS/system32
unzip ~/freedroidRPG_dependencies.zip
cd
5) FreedroidRPG compilation
So, you are now finally ready to download and compile the game!
In a MinGW Shell, do the following:
download the source files with svn:
svn co http://freedroid.svn.sourceforge.net/svnroot/freedroid freedroid
enter freedroid source directory:
cd freedroid
compile the game:
./autogen.sh
CFLAGS=-I/include ./configure --without-x --disable-sdltest
make
Nota:, if an error window opens complaining about libgmp-10.dll missing, then you used a bugged version of the MinGW installer
(some DLLs are not correctly installed). To fix the problem, just type the following commands:
cp /mingw/bin/libgmp-10.dll /mingw/libexec/gcc/mingw32/4.5.2
cp /mingw/bin/libmpc-2.dll /mingw/libexec/gcc/mingw32/4.5.2
cp /mingw/bin/libmpfr-1.dll /mingw/libexec/gcc/mingw32/4.5.2
cp /mingw/bin/libiconv-2.dll /mingw/mingw32/bin
cp /mingw/bin/libintl-8.dll /mingw/mingw32/bin
If everything went alright, you will find a freedroidRPG.exe file in the src/ subdirectory. You can launch it from the terminal:
cd src
./freedroidRPG
or you can just double-click on the executable's icon from the File Explorer. You will find it in
C:\MinGW\msys\1.0\home\<your_username>\freedroid\src
Enjoy the game!
==============================================================
If you have problems with the compilation/installation, please
contact us : #freedroid on irc.freenode.net,
or send a mail to freedroid-discussion@lists.sourceforge.net.
==============================================================
Basic Installation
==================
These are generic installation instructions.
The `configure' shell script attempts to guess correct values for
various system-dependent variables used during compilation. It uses
those values to create a `Makefile' in each directory of the package.
It may also create one or more `.h' files containing system-dependent
definitions. Finally, it creates a shell script `config.status' that
you can run in the future to recreate the current configuration, a file
`config.cache' that saves the results of its tests to speed up
reconfiguring, and a file `config.log' containing compiler output
(useful mainly for debugging `configure').
If you need to do unusual things to compile the package, please try
to figure out how `configure' could check whether to do them, and mail
diffs or instructions to the address given in the `README' so they can
be considered for the next release. If at some point `config.cache'
contains results you don't want to keep, you may remove or edit it.
The file `configure.in' is used to create `configure' by a program
called `autoconf'. You only need `configure.in' if you want to change
it or regenerate `configure' using a newer version of `autoconf'.
The simplest way to compile this package is:
1. `cd' to the directory containing the package's source code and type
`./configure' to configure the package for your system. If you're
using `csh' on an old version of System V, you might need to type
`sh ./configure' instead to prevent `csh' from trying to execute
`configure' itself.