==========================================================================
Cafu Game and Graphics Engine http://www.cafu.de
Demo Readme info@cafu.de
==========================================================================
Welcome to Cafu, the open-source Game and Graphics Engine for
multiplayer, cross-platform, real-time 3D Action.
This readme gets you started with the Cafu binary demo packages. The
demo packages are archives that contain precompiled program executables
and everything else that is required to run the Cafu engine demo.
If you are interested in getting and compiling the source code instead,
refer to the Cafu documentation at http://www.cafu.de/wiki/
Contents of this file:
1. Quick-start for Windows
2. Quick-start for Linux
3. Documentation
4. Release Notes
5. License
6. Contact
==========================================================================
1. Quick-start for Windows
==========================================================================
You can run the Cafu demo by clicking on the Cafu.exe file that is in
the same directory as this README.txt file.
Your Windows or Personal Firewall may report Cafu opening a network
connection. This is because Cafu starts a client and a server, then
connects to itself even for pure single-player games.
Thus, please set your firewall to not block Cafu from network access.
The Cafu World Editor "CaWE" is started analogously by clicking on
the CaWE.exe file in the same directory.
More information about the Cafu engine and the editor CaWE can be
found in the documentation at http://www.cafu.de/wiki/
==========================================================================
2. Quick-start for Linux
==========================================================================
Extracting the Cafu .tar.gz archive makes automatically sure
that the executable bit is properly set for all relevant files, and
thus you can (double-)click the "Cafu-run" file that is in the same
directory as this README.txt file in order to start the Cafu engine.
"Cafu-run" is a shell script that sets the proper working directory
before starting the Cafu executable.
Alternatively, you can run Cafu from a command line shell by cd'ing
into the same directory as this file (e.g. cd ~carsten/Cafu/ ), and
then just type ./Cafu
The Cafu World Editor "CaWE" is started analogously by clicking on
the "CaWE-run" file or by running ./CaWE-bin respectively.
More information about the Cafu engine and the editor CaWE can be
found in the documentation at http://www.cafu.de/wiki/
==========================================================================
3. Documentation
==========================================================================
If you need help, please refer to the user manual at
http://www.cafu.de/wiki/. It has a "Quick Start" section that
briefly summarizes everything to get you started, and also has more
detailed information about installing, de-installing, requirements etc.
Additional documentation and information about all advanced aspects of
Cafu (e.g. map editing and development) is found at
a) the Cafu wiki at http://www.cafu.de/wiki/
b) the Cafu forum at http://www.cafu.de/forum/
==========================================================================
4. Release Notes
==========================================================================
Known problems specific to all supported platforms:
None.
Known problems specific to the Windows platform:
a) Occasionally distorted background music playback in the TechDemo
map near the base of the ladder to the emergency exit.
Known problems specific to the Linux platform:
a) Screen resolution cannot be changed at runtime (this is a
limitation of the X server, not Cafu).
b) Blank/black screen after starting. On some systems, it takes a long
time between starting the engine and the initial appearance of the
"Loading..." screen. The screen is then fully black, and it takes up
to one or two minutes until the splash screen appears. This problem
has only been observed on systems that do not meet the minimum system
requirements, and is due to inadequate hardware and/or driver support.
==========================================================================
5. License
==========================================================================
Please refer to file LICENSE.txt in the same directory as this readme
for license information.
==========================================================================
6. Contact
==========================================================================
If you experience problems or if you have any questions or suggestions,
visit the official Cafu website at
http://www.cafu.de
You will find background information, discussion forums, IRC chat
details, and many other resources to help you out. You're heartily
invited to join the forums and the IRC chat to place your questions and
suggestions.
You can also contact the Cafu author Carsten Fuchs directly by
sending an email to
info@cafu.de