Nexuiz 2.5 FAQ
Xonotic 0.7 FAQ
- Troubleshooting
- How do I install Nexuiz? -
- When I start Nexuiz all I see is a black screen or a black screen with some checkered squares +
- How do I install Xonotic? +
- When I start Xonotic all I see is a black screen or a black screen with some checkered squares
- Using Linux I only see the map but no players and items -
- When I start Nexuiz my screen is flickering +
- When I start Xonotic my screen is flickering
- How can I speed up my frame rate?
- The sound is broken, it crackles and stutters
- Mouse is too slow and sensitivity is at top (on Mac / Linux) @@ -89,7 +54,7 @@
- General questions
- How do I install new maps? -
- How can I place a shortcut to Nexuiz on my Linux desktop? +
- How can I place a shortcut to Xonotic on my Linux desktop?
- How do I open the console?
- What console commands/variables are there?
- How can I use colors in my nickname and messages? @@ -104,7 +69,7 @@
- Development
- How can I create or edit Nexuiz maps? +
- How can I create or edit Xonotic maps?
- Where can I get latest development versions of the source code? @@ -114,37 +79,35 @@
- you unpacked the zip file without folder names (see How do I install Nexuiz?) -
- on Linux: the current directory is not your Nexuiz/ folder. See How can I place a shortcut to Nexuiz on my Linux desktop? on how to fix this -
- on Mac: you tried to extract and move the files from a Nexuiz update and it deleted the old files. When using the mac GUI please be sure to move only the files not the folders as that will delete the old files or use the mv console command which will not delete the old files +
- you unpacked the zip file without folder names (see How do I install Xonotic?) +
- on Linux: the current directory is not your Xonotic/ folder. See How can I place a shortcut to Xonotic on my Linux desktop? on how to fix this +
- on Mac: you tried to extract and move the files from a Xonotic update and it deleted the old files. When using the mac GUI please be sure to move only the files not the folders as that will delete the old files or use the mv console command which will not delete the old files
- the engine could not initialize OpenGL. Please install the latest drivers for your graphic card. You will probably find one for your card there: intel ati nvidia -
- your download might be corrupted, please download Nexuiz again +
- your download might be corrupted, please download Xonotic again
-
-
-
-
Troubleshooting
-How do I install Nexuiz?
+How do I install Xonotic?
-Just unzip the nexuiz-<version>.zip file. You can do this with any archive program (like 7zip). It's very important to keep the directory structure while unpacking (in WinZip this option is called "Use folder names"). The directory structure should look like this afterwards: +Just unzip the xonotic-<version>.zip file. You can do this with any archive program (like 7zip). It's very important to keep the directory structure while unpacking (in WinZip this option is called "Use folder names"). The directory structure should look like this afterwards:
-Nexuiz/ +Xonotic/ |-- Docs/ |-- data/ | |-- common-spog.pk3 | `-- data*.pk3 -|-- havoc/ -| `-- data*.pk3 -|-- Nexuiz.app/ -|-- Nexuiz-SDL.app/ +|-- Xonotic.app/ +|-- Xonotic-SDL.app/ |-- server/ | `-- * |-- sources/ |-- *.exe |-- *.dll -`-- nexuiz-linux-* +`-- xonotic-linux-*
When I start Nexuiz all I see is a black screen or a black screen with some checkered squares
+When I start Xonotic all I see is a black screen or a black screen with some checkered squares
This happens when the engine can't load the data*.pk3 file or has trouble to initialize OpenGL. The reasons could be:
-
-
When I start Nexuiz my screen is flickering
+When I start Xonotic my screen is flickering
This is known to happen on Windows with Intel graphic chips and is a bug in the graphics drivers. A workaround is to set Flip-Policiy to blit. Open the control panel, there should be an icon called Intel(R) GMA driver (or something like that), double click it. Click on 3D Settings to find the screen with those settings.
@@ -170,44 +133,43 @@ Some graphic cards (mostly ATI or quite old cards) run A LOT faster if you disabThe sound is broken, it crackles and stutters
-Try run nexuiz-sdl.exe instead of nexuiz.exe (on Windows). Adding the command line options -sndspeed 48000 and/or -sndstereo can also help on some systems (on Linux, Mac, Windows). +Try run xonotic-sdl.exe instead of xonotic.exe (on Windows). Adding the command line options -sndspeed 48000 and/or -sndstereo can also help on some systems (on Linux, Mac, Windows).
Mouse is too slow and sensitivity is at top (on Mac / Linux)
-Mac: The default mouse acceleration on Mac is very high and strange. The Nexuiz defaults work fine with it but some mouse drivers seem to 'correct' the mouse acceleration and conflict with the Nexuiz defaults. Try to disable the option Turn off OS mouse acceleration in the Settings / Input menu. Or the same via console: apple_mouse_noaccel 0; vid_restart (How do I open the console?) +Mac: The default mouse acceleration on Mac is very high and strange. The Xonotic defaults work fine with it but some mouse drivers seem to 'correct' the mouse acceleration and conflict with the Xonotic defaults. Try to disable the option Turn off OS mouse acceleration in the Settings / Input menu. Or the same via console: apple_mouse_noaccel 0; vid_restart (How do I open the console?) Linux: A similar problem can arise on Linux. Its also Turn off OS mouse acceleration in the Settings / Input menu but the console command is different: vid_dga 0; vid_restart (How do I open the console?)
I can't switch to 32 bit color depth (on Windows)
-Check if your desktop color depth is set to 32 bits per pixel. If it's just set to 16, Nexuiz can't switch to 32 bit mode. +Check if your desktop color depth is set to 32 bits per pixel. If it's just set to 16, Xonotic can't switch to 32 bit mode.
When I join a server or after a map change I see nothing but a black screen, but I can still move and shoot
-This is probably because you don't have the map that's running on the server. As Nexuiz supports map/content download the server might not be be setup (correctly) to support this and you will have to get the map the old fashioned way. Those servers should have a download URL in their name or welcome message. There is also a wiki page dedicated to new maps. +This is probably because you don't have the map that's running on the server. As Xonotic supports map/content download the server might not be be setup (correctly) to support this and you will have to get the map the old fashioned way. Those servers should have a download URL in their name or welcome message. There is also a wiki page dedicated to new maps. For Linux users: you need to have libcurl installed, otherwise you won't be able to download any maps. libcurl should be available in any Linux distribution, just search for "libcurl" and install it in your distribution's package manager.
How to report crashes
-Alientrap wants to ensure everyone has a pleasant time playing Nexuiz, so if you have problems we would like to ask you to report them and thus help solve them. Especially crash reports can be very helpful. See below for how to contact Alientrap (Where can i get more help?) +Register at http://dev.xonotic.org and submit a bug report.
-On Mac: IS THERE AN EASY WAY?
+On Mac: IS THERE AN EASY WAY? +-On Linux: In a xterm, cd into your Nexuiz installation directory, start catchsegv ./nexuiz-linux-686-sdl -condebug -developer > crash.txt 2>&1 and give the file crash.txt to the developers. Note that you can also use ./nexuiz-linux-686-glx or if you have a 64bit system ./nexuiz-linux-x86_64-sdl and ./nexuiz-linux-x86_64-glx +On Linux: In a xterm, cd into your Xonotic installation directory, start catchsegv ./xonotic-linux-686-sdl -condebug -developer > crash.txt 2>&1 and give the file crash.txt to the developers. Note that you can also use ./xonotic-linux-686-glx or if you have a 64bit system ./xonotic-linux-x86_64-sdl and ./xonotic-linux-x86_64-glx
-On Windows: Click Start->Run, and enter drwtsn32, click Ok in the next window, run Nexuiz and wait for the crash. Then go to C:\Documents and Settings\All Users\Application Data\Microsoft\Dr Watson there should be a file called "drwtsn32.log", give that file along with the engine's build date to the developers. You'll see that date when you open the ingame console (How do I open the console?). Note that some folders of that path may be hidden or have a translated name if you're using a non-english windows.
-
-This method is not availible in Windows Vista or Windows 7.
+On Windows: Click Start->Run, and enter drwtsn32, click Ok in the next window, run Xonotic and wait for the crash. Then go to C:\Documents and Settings\All Users\Application Data\Microsoft\Dr Watson there should be a file called "drwtsn32.log", give that file along with the engine's build date to the developers. You'll see that date when you open the ingame console (How do I open the console?). Note that some folders of that path may be hidden or have a translated name if you're using a non-english windows.
Where can I get more help?
-Visit the official Nexuiz forum there is a support and bug report area. Or get on IRC to chat with other or ask for help. There is the normal users channel (irc://irc.quakenet.org/nexuiz) and the developers channel (irc://irc.anynet.org/alientrap) +Visit the official Xonotic forum there is a support and bug report area. Or get on IRC to chat with other or ask for help. There is the normal users channel (irc://irc.quakenet.org/xonotic) and the developers channel (irc://irc.freenode.net/xonotic)
@@ -216,13 +178,13 @@ Visit the official Nexuiz foruHow do I install new maps?
-Maps usually ship as *.pk3 file. All you have to do is to copy this file to the Nexuiz/data/ (on Linux, Mac, Windows) OR ~/.nexuiz/data/ (on Linux, Mac) directory. -Map packages that were downloaded from a server during playing end up in Nexuiz/data/dlcache/ or ~/.nexuiz/data/dlcache/ and are only used till you exit Nexuiz. If you want to play them locally or use them to setup a server of your own you can "accept" the packages by moving it one level up - right next to your config.cfg. +Maps usually ship as *.pk3 file. All you have to do is to copy this file to the Xonotic/data/ (on Linux, Mac, Windows) OR ~/.xonotic/data/ (on Linux, Mac) directory. +Map packages that were downloaded from a server during playing end up in Xonotic/data/dlcache/ or ~/.xonotic/data/dlcache/ and are only used till you exit Xonotic. If you want to play them locally or use them to setup a server of your own you can "accept" the packages by moving it one level up - right next to your config.cfg.
-How can I place a shortcut to Nexuiz on my Linux desktop?
+How can I place a shortcut to Xonotic on my Linux desktop?
-Use the script nexuiz-linux-sdl.sh or nexuiz-linux-glx.sh instead of the binaries. The scripts will use the correct working directory,choose the right version (32 or 64 bit) and also allow you to start a extra X server. +Use the script xonotic-linux-sdl.sh or xonotic-linux-glx.sh instead of the binaries. The scripts will use the correct working directory,choose the right version (32 or 64 bit) and also allow you to start a extra X server.
How do I open the console?
@@ -232,7 +194,10 @@ Press [shift]+[escape]. To close it press [escape]. While plWhat console commands/variables are there?
-You can get a list of variables by entering cvarlist on the console (How do I open the console?). cmdlist will give you a list of available commands. An annotated version of that output can be found at the Nexuiz wiki. +You can get a list of variables by entering cvarlist on the console (How do I open the console?). cmdlist will give you a list of available commands. +
++#An annotated version of that output can be found at the Xonotic wiki.
How can I use colors in my nickname and messages?
@@ -262,9 +227,9 @@ Colors can be used in nicknames and chat messages via two ways: Either the simplHow do I watch/record demos?
-Demos are recordings of matches that you have played. To automatically record a demo each time you play enable the option Record demos while playing in the Multiplayer / Demos menu. Or if you just want to record some matches open the console and type rec <demos/name> before playing. That is before starting a game or connecting to a server. The demo file will then be stored in Nexuiz/data/demos/<name>.dem (on Windows) or ~/.nexuiz/data/demos/<name>.dem (on Linux, Mac). -If you downloaded a demo, copy it to Nexuiz/data/demos/<name>.dem (on Linux, Mac, Windows) or ~/.nexuiz/data/demos/<name>.dem (on Linux, Mac). You might have to create this directory if you have never recorded a demo before. -To watch demos you can choose a demo file in the Multiplayer / Demos and click the play button. Also you can watch demos typing ply <demos/name> in the console (How do I open the console?). You can list all your demo files by typing dem on the console. Some useful key bindings for viewing demos and making videos are listed here. A simple way to automatically record demos can be found here. +Demos are recordings of matches that you have played. To automatically record a demo each time you play enable the option Record demos while playing in the Multiplayer / Demos menu. Or if you just want to record some matches open the console and type rec <demos/name> before playing. That is before starting a game or connecting to a server. The demo file will then be stored in Xonotic/data/demos/<name>.dem (on Windows) or ~/.xonotic/data/demos/<name>.dem (on Linux, Mac). +If you downloaded a demo, copy it to Xonotic/data/demos/<name>.dem (on Linux, Mac, Windows) or ~/.xonotic/data/demos/<name>.dem (on Linux, Mac). You might have to create this directory if you have never recorded a demo before. +To watch demos you can choose a demo file in the Multiplayer / Demos and click the play button. Also you can watch demos typing ply <demos/name> in the console (How do I open the console?). You can list all your demo files by typing dem on the console.
@@ -274,18 +239,18 @@ To watch demos you can choose a demo file in the Multiplayer / Demos anHow do I start a server?
Use the Multiplayer / Create menu to start a listen server. You will always have to play yourself in a listen server. -If you want to create a server without being forced to play yourself please take a look at the file readme.txt in the Nexuiz/server/ directory where the dedicated server is explained. +If you want to create a server without being forced to play yourself please take a look at the file readme.txt in the Xonotic/server/ directory where the dedicated server is explained.
Which ports do I have to open in firewall/forward from my router to run a server?
-The default port is 26000 UDP. You can change that in the Multiplayer / Create menu or by starting Nexuiz with the parameter -port <port> or having a line port <port> in the server config file. -If you follow the tutorial mentioned above you do not need this command line argument as it will be done in the config file created for the server. To add the command line argument on Windows, create a new shortcut to nexuiz.exe or nexuiz-dedicated.exe and right click on it. Select properties and -port <port> in the "Target:" line. Be sure that the "Start in:" line contains the full path to your Nexuiz folder and click "OK". The parameter will be used if you start Nexuiz via that new shortcut. +The default port is 26000 UDP. You can change that in the Multiplayer / Create menu or by starting Xonotic with the parameter -port <port> or having a line port <port> in the server config file. +If you follow the tutorial mentioned above you do not need this command line argument as it will be done in the config file created for the server. To add the command line argument on Windows, create a new shortcut to xonotic.exe or xonotic-dedicated.exe and right click on it. Select properties and -port <port> in the "Target:" line. Be sure that the "Start in:" line contains the full path to your Xonotic folder and click "OK". The parameter will be used if you start Xonotic via that new shortcut.
Is there some kind of rcon?
-Yes starting with Nexuiz 2.0 there is rcon (QuakeWorld compatible). To use it you must enter rcon_password <password> in the server console or server config file. The Nexuiz client has to set the same password in the same fashion. You can then issue commands with rcon <command> if you are connected to the server or will have to set rcon_address <ip/hostname> or rcon_address <ip/hostname>:<port> to point to the server. There are also external rcon tools but make sure you use a QW compatible rcon tool. +Yes there is a QuakeWorld compatible rcon. To use it you must enter rcon_password <password> in the server console or server config file. The Xonotic client has to set the same password in the same fashion. You can then issue commands with rcon <command> if you are connected to the server or will have to set rcon_address <ip/hostname> or rcon_address <ip/hostname>:<port> to point to the server. There are also external rcon tools but make sure you use a QW compatible rcon tool.
How can I kick people who are using special characters in their names?
@@ -297,23 +262,20 @@ Enter status at the server console. You will see a list of all playersDevelopment
-How can I create or edit Nexuiz maps?
+How can I create or edit Xonotic maps?
-You need NetRadiant, a stabilized Q3 map editor. For convenience, a snapshot configured for Nexuiz is included in extra/ for Windows and MAC-Intel, but the program is not officially supported by Alientrap. +You need NetRadiant, a stabilized Q3 map editor. For convenience, a snapshot configured for Xonotic is included in extra/ for Windows and MAC-Intel, but the program is not officially supported by Xonotic.
Where can I get latest development versions of the source code?
-Engine: instructions are available at http://icculus.org/twilight/darkplaces/download.html look for Accessing the SVN server (you will need a svn client, beta builds are available here) +Please refer to http://dev.xonotic.org/projects/xonotic/wiki/Repository_Access
-Game data: to check out the Nexuiz svn, you'll need a svn client. To check out the repository with a command line svn client, do +Game data: to check out Xonotic git, you'll need a git client.
--svn co svn://svn.icculus.org/nexuiz/trunk/ -
-To compile the game code you need fteqcc. Just download it and run it 3 times, once in data/qcsrc/menu, once in data/qcsrc/server and once in data/qcsrc/client. Alternatively a Makefile is available in data/ to perform directly the operation. +For more information on how to compile the game please see http://dev.xonotic.org/projects/xonotic/wiki/RepositoryAccess#Cloning-the-repository-and-compiling and http://dev.xonotic.org/projects/xonotic/wiki/CompilingIn_Windows
@@ -321,33 +283,20 @@ To compile the game code you need This document was generated using AFT v5.096 +This document was generated using AFT v5.097