Fixed: Calling stop on music player should not affect background music.

[ryzomcore.git] / snowballs2 / README

\r
1. What's this document about?\r
   ---------------------------\r
\r
This document contains useful information about SNOWBALLS, NeL, Nevrax,\r
technical requirements, and caveats about compilation and installation.\r
It also includes a short "user manual" for the programs provided. It is\r
highly recommended reading.\r
\r
\r
2. What are NeL and Nevrax\r
   -----------------------\r
\r
NeL is a free software framework developped by Nevrax Ltd, for the purpose of \r
building internet multiuser entertainment.\r
\r
Nevrax is a company dedicated to Free Software, which is why their tools are \r
covered by the GPL. See the attached license file. They built NeL to create \r
their massively multiplayer online role playing game called The Saga of Ryzom.\r
\r
You should visit our website at http://www.opennel.org/ for more information.\r
\r
\r
3. What's in the package?\r
   ----------------------\r
\r
The package contains:\r
\r
   - The latest source code for the NeL client and server frameworks\r
   - The source code and data for a sample NeL game called 'SNOWBALLS'\r
\r
If you have a source distribution, you need to compile the source to\r
produce the various executables. If you have a binary distribution,\r
you have a pre-built exe client for Snowballs, but no source.\r
\r
The source code is provided as is, and reflects the state of the NeL\r
framework at the release date. We have done our best to insure that the\r
snapshot you are using now compiles and works correctly. However, we\r
only test on a limited range of configurations, and the vagaries of\r
OS and hardware means we cannot guarantee it compiles and executes\r
correctly on your system at the time.\r
\r
If you are using SVN, you can keep in synch with the NeL Development Team \r
as we have included the required SVN information. An update will give you \r
current source. We do not guarantee that the source in SVN will compile \r
and work correctly at all time as it includes the latest work in progress.\r
\r
\r
4. Caveat\r
   ------\r
\r
The sample client, server and data files provided do not accurately reflect\r
our game currently in production. We do intend penguins and gnus to appear\r
in the final game, but most of the gameplay you will see does not reflect\r
what we will implement later.\r
\r
\r
5. Compiling NeL and SNOWBALLS\r
   ---------------------------\r
\r
TODO: update text.\r
You will need a C++ compiler to properly compile and execute the NeL\r
framework. The program compiles reasonably under a Unix/GCC environment,\r
but it has been chiefly tested under a Linux environment.\r
\r
TODO: update text.\r
The server has been compiled and executed on a Windows machine, but it\r
is highly recommended that you run it on a separate GNU/Linux machine. The\r
client has been compiled and executed on a GNU/Linux machine, but will\r
probably not work on other unix compatible systems (yet).\r
\r
The client and server require an operating TCP/IP stack to communicate.\r
\r
The data files for the client and server should be in the ./data child \r
directories of the directory in which the executables are located.\r
\r
See the INSTALL file for the requirements and installation instructions.\r
\r
\r
6. Running SNOWBALLS client\r
   ------------------------\r
\r
It is highly recommended that you run the client on a PC with plenty of \r
main memory (128Megs+) and a 3D card that supports T&L in hardware and \r
has 32Mb of memory. Lesser configurations will probably give you very \r
poor framerates.\r
\r
TODO: rewrite completely, incorrect.\r
You just have to execute nel_launcher.exe (and never snowballs.exe directly).\r
The application will prompt you a login and password. If you enter\r
a user name that has never been used before on the server that you are\r
connected to then a new account will be created with the password that\r
you enter at the 'PASSWORD' prompt. You'll need to remeber this password\r
as you'll need each time you login in the future. Use only alphanumeric\r
value for login and password, don't use space and other strange characters.\r
WARNING: Password are not crypted so you should use 'dummy' password.\r
\r
TODO: rewrite completely, incorrect.\r
After you have to select a shard if available, just click on the shard name.\r
It patch if necessary and automatically launch snowballs game, just wait.\r
\r
TODO: rewrite completely, incorrect and extremely boring.\r
You're now a penguin on an artic snowfield. You have snowballs which you\r
can throw at other people. When you throw a snowball, you have a few\r
seconds during which you gather more snow before you can throw the next\r
one. If you hit someone, your score increases, and the snowed opponent \r
becomes immune to further snowing (he flashes on the screen) for 5s. He\r
cannot retaliate while invulnerable.\r
\r
Good luck.\r
\r
\r
7. The controls in SNOWBALLS\r
   -------------------------\r
\r
Use the mouse to look around.\r
Use arrow keys to move forward, backward, strafe left and strafe right.\r
\r
F3: switch on/off the wireframe mode\r
F4: clear the chat window\r
F5: switch on/off the chat text\r
F6: switch on/off the radar\r
F7: zoom out the radar\r
F8: zoom in the radar\r
F9: capture or uncapture the mouse\r
F10: switch betweeon online and offline\r
F11: reset player position\r
F12: take a screenshot\r
SHIFT-ESC: quit\r
Left Mouse Button: throw a snowball\r
Type text followed by ENTER to broadcast messages\r
\r
\r
8. Contacting us\r
   -------------\r
\r
For comments and problems relating to SNOWBALLS or NeL \r
you can go to the forums at http://www.opennel.org/jforum/forums/list.page\r
or use the issue tracker at http://www.opennel.org/jira/secure/Dashboard.jspa\r