Copyright © 1991-2001 by Bjørn Stabell, Ken Ronny Schouten, Bert Gijsbers & Dick Balaska. XPilot 4.4.1NT13 comes with ABSOLUTELY NO WARRANTY; for details see the provided LICENSE file. jarno@j-a-r-n-o.nl is responsible for the local installation. You can modify your xpilot.ini by setting these options. You only need to rewrite them a bit. -option should be written as option= in your xpilot.ini The options include: -help Display this help message. -version Show the source code version. -name Set the nickname. -user Set the realname. -host Set the hostname. -join Join the game immediately, no questions asked. -noLocalMotd Do not display the local Message Of The Day. -autoServerMotdPopup Automatically popup the MOTD of the server on startup. The default value is: Yes. -refreshMotd Get a fresh copy of the server MOTD every time it is displayed. The default value is: No. -text Use the simple text interface to contact a server instead of the graphical user interface. The default value is: No. -list List all servers running on the local network. -team Set the team to join. The default value is: 4095. -display Set the X display. -keyboard Set the X keyboard input if you want keyboard input from another display. The default is to use the keyboard input from the X display. -geometry Set the window size and position in standard X geometry format. The maximum allowed window size is 1282x1024. -ignoreWindowManager Ignore the window manager when opening the top level player window. This can be handy if you want to have your XPilot window on a preferred position without window manager borders. Also sometimes window managers may interfere when switching colormaps. This option may prevent that. -shutdown Shutdown the server with a message. The message used is the first argument to this option. -port Set the port number of the server. Almost all servers use the default port, which is the recommended policy. You can find out about which port is used by a server by querying the XPilot Meta server. The default value is: 15345. -shipShape Define the ship shape to use. Because the argument to this option is rather large (up to 500 bytes) the recommended way to set this option is in the .xpilotrc file in your home directory. The exact format is defined in the file doc/README.SHIPS in the XPilot distribution. Note that there is a nifty Unix tool called editss for easy ship creation. There is XPShipEditor for Windows and Ship Shaper for Java. See the XPilot FAQ for details. See also the "shipShapeFile" option below. -shipShapeFile An optional file where shipshapes can be stored. If this resource is defined and it refers to an existing file then shipshapes can be referenced to by their name. For instance if you define shipShapeFile to be /home/myself/.shipshapes and this file contains one or more shipshapes then you can select the shipshape by starting xpilot as: xpilot -shipShape myshipshapename Where "myshipshapename" should be the "name:" or "NM:" of one of the shipshapes defined in /home/myself/.shipshapes. Each shipshape definition should be defined on only one line, where all characters up to the first left parenthesis don't matter. -power Set the engine power. Valid values are in the range 5-55. The default value is: 45.0. -turnSpeed Set the ship's turn speed. Valid values are in the range 4-64. See also turnResistance. The default value is: 35.0. -turnResistance Set the ship's turn resistance. This determines the speed at which a ship stops turning after a turn key has been released. Valid values are in the range 0.0-1.0. Useful values are in the range 0.05-0.15. See also turnSpeed. The default value is: 0.12. -altPower Set the alternate engine power. See also the keySwapSettings option. The default value is: 35.0. -altTurnSpeed Set the alternate ship's turn speed. See also the keySwapSettings option. The default value is: 25.0. -altTurnResistance Set the alternate ship's turn resistance. See also the keySwapSettings option. The default value is: 0.12. -showHUD Should the HUD be displayed or not. The default value is: Yes. -fuelNotify The limit when the HUD fuel bar will become visible. The default value is: 500. -fuelWarning The limit when the HUD fuel bar will start flashing. The default value is: 200. -fuelCritical The limit when the HUD fuel bar will flash faster. The default value is: 100. -verticalHUDLine Should the vertical lines in the HUD be drawn. The default value is: No. -horizontalHUDLine Should the horizontal lines in the HUD be drawn. The default value is: Yes. -speedFactHUD Should the HUD be moved, to indicate the current velocity? The default value is: 0.0. -speedFactPTR Uses a red line to indicate the current velocity and direction. The default value is: 0.0. -fuelMeter Determines if the fuel meter should be visible. The default value is: No. -fuelGauge Determines if the fuel gauge should be visible. The default value is: Yes. -turnSpeedMeter Should the turn speed meter be visible at all times. The default value is: No. -powerMeter Should the power meter be visible at all times. The default value is: No. -packetSizeMeter Should the network packet size meter be visible at all times. Each bar is equavalent to 1024 bytes, for a maximum of 4096 bytes. The default value is: No. -packetLossMeter Should the packet loss meter be visible. This gives the percentage of lossed frames due to network failure. The default value is: No. -packetDropMeter Should the packet drop meter be visible. This gives the percentage of dropped frames due to display slowness. The default value is: No. -slidingRadar If the game is in edgewrap mode then the radar will keep your position on the radar in the center and raw the rest of the radar around it. Note that this requires a fast graphics system. The default value is: No. -outlineWorld Draws only the outline of all the blue map constructs. The default value is: No. -filledWorld Draws the walls solid, filled with one color. Be warned that this option needs fast graphics. The default value is: No. -texturedWalls Draws the walls filled with a texture pattern. See also the wallTextureFile option. Be warned that this needs a very fast graphics system. The default value is: No. -wallTextureFile Specify a XPM format pixmap file to load the wall texture from. -texturePath Search path for texture files. This is a list of one or more directories separated by colons. The default value is: /home/stud/nikolk/games/xpilot-4.4.1/lib/textures/. -texturedObjects Whether to draw ships, shots and walls with textures. Be warned that this needs a very fast graphics system. You may also need to enable multibuffering or double-buffering. The default value is: No. -markingLights Should the fighters have marking lights, just like airplanes? The default value is: Yes. -sparkProb The chance that sparks are drawn or not. This gives a sparkling effect. Valid values are in the range [0.0-1.0] The default value is: 0.50. -sparkSize Size of sparks in pixels. The default value is: 2. -charsPerSecond Speed in which messages appear on screen in characters per second. The default value is: 50. -clock Should a clock be displayed in the top right of the score window. The default value is: No. -clockAMPM 12 or 24 hour format for clock display. The default value is: No. -pointerControl Enable mouse control. This allows ship direction control by moving the mouse to the left for an anti-clockwise turn and moving the mouse to the right for a clockwise turn. Also see the pointerButton options for use of the mouse buttons. The default value is: No. -gameFont The font used on the HUD and for most other text. The default value is: -*-times-*-*-*--18-*-*-*-*-*-iso8859-1. -scoreListFont The font used on the score list. This must be a non-proportional font. The default value is: -*-fixed-bold-*-*--15-*-*-*-c-*-iso8859-1. -buttonFont The font used on all buttons. The default value is: -*-*-bold-o-*--14-*-*-*-*-*-iso8859-1. -textFont The font used in the help and about windows. The default value is: -*-*-bold-i-*--14-*-*-*-p-*-iso8859-1. -talkFont The font used in the talk window. The default value is: -*-fixed-bold-*-*--15-*-*-*-c-*-iso8859-1. -motdFont The font used in the MOTD window and key list window. This must be a non-proportional font. The default value is: -*-courier-bold-r-*--14-*-*-*-*-*-iso8859-1. -messageFont The font used for drawing messages. The default value is: -*-times-*-*-*--14-*-*-*-*-*-iso8859-1. -maxMessages The maximum number of messages to display. The default value is: 8. -reverseScroll Reverse scroll direction of messages. The default value is: No. -selectionAndHistory Provide cut&paste for the player messages and the talk window and a `history' for the talk window. The default value is: Yes. -maxLinesInHistory Number of your messages saved in the `history' of the talk window. `history' is accessible with `keyTalkCursorUp/Down'. The default value is: 32. -shotSize The size of shots in pixels. The default value is: 3. -teamShotSize The size of team shots in pixels. Note that team shots are drawn in blue. The default value is: 2. -showNastyShots Use the new Nasty Looking Shots or the original rectangle shots, You will probably want to increase your shotSize if you use this. The default value is: No. -backgroundPointDist The distance between points in the background measured in blocks. These are drawn in empty map regions to keep feeling for which direction the ship is moving to. The default value is: 8. -backgroundPointSize Specifies the size of the background points. 0 means no points. The default value is: 2. -titleFlip Should the title bar change or not. Some window managers like twm may have problems with flipping title bars. Hence this option to turn it off. The default value is: Yes. -toggleShield Are shields toggled by a keypress only? The default value is: No. -autoShield Are shields lowered automatically for weapon fire? The default value is: Yes. -shieldDrawSolid Are shields drawn in a solid line. Not setting a value for this option will select the best value automatically for your particular display system. The default value is: Default. -showShipName Should all ships have the name of the player drawn below them. The default value is: Yes. -showMineName Should the name of the owner of the mine be drawn below the mine. The default value is: Yes. -showMessages Should messages appear on screen. The default value is: Yes. -showItems Should owned items be displayed permanently on the HUD, or only when their amount has changed? The default value is: Yes. -showItemsTime The time in seconds to display item information when it has changed and the showItems option is turned on. The default value is: 2.0. -receiveWindowSize Too complicated. Keep it on 3. The default value is: 3. -visual Specify which visual to use for allocating colors. To get a listing of all possible visuals on your dislay set the argument for this option to list. -mono Only use black and white (may be very slow). -erase Use Erase(-hack) for slow X. -colorSwitch Use color buffering or not. Usually color buffering is faster, especially on 8-bit PseudoColor displays. The default value is: Yes. -multibuffer Use the X windows multibuffer extension if present. The default value is: No. -maxColors The number of colors to use. Valid values are 4, 8 and 16. The default value is: 8. -black The color value for black (better use color0 instead). -white The color value for white (better use color1 instead). -blue The color value for blue (better use color2 instead). -red The color value for red (better use color3 instead). -color0 The color value for the first color. -color1 The color value for the second color. -color2 The color value for the third color. -color3 The color value for the fourth color. -color4 The color value for the fifth color. This is only used if maxColors is set to 8 or 16. -color5 The color value for the sixth color. This is only used if maxColors is set to 8 or 16. -color6 The color value for the seventh color. This is only used if maxColors is set to 8 or 16. -color7 The color value for the eighth color. This is only used if maxColors is set to 8 or 16. -color8 The color value for the nineth color. This is only used if maxColors is set to 16. -color9 The color value for the tenth color. This is only used if maxColors is set to 16. -color10 The color value for the eleventh color. This is only used if maxColors is set to 16. -color11 The color value for the twelfth color. This is only used if maxColors is set to 16. -color12 The color value for the thirteenth color. This is only used if maxColors is set to 16. -color13 The color value for the fourteenth color. This is only used if maxColors is set to 16. -color14 The color value for the fifteenth color. This is only used if maxColors is set to 16. -color15 The color value for the sixteenth color. This is only used if maxColors is set to 16. -hudColor Which color number to use for drawing the HUD. The default value is: 4. -hudLockColor Which color number to use for drawing the lock on the HUD. The default value is: 4. -wallColor Which color number to use for drawing walls. The default value is: 2. -wallRadarColor Which color number to use for drawing walls on the radar. Valid values all even numbers smaller than maxColors. The default value is: 2. -decorColor Which color number to use for drawing decorations. The default value is: 6. -showDecor Should decorations be displayed on the screen and radar? The default value is: Yes. -decorRadarColor Which color number to use for drawing decorations on the radar. Valid values are all even numbers smaller than maxColors. The default value is: 6. -oldMessagesColor Which color number to use for drawing old messages. The default value is: 1. -outlineDecor Draws only the outline of the map decoration. The default value is: No. -filledDecor Draws filled decorations. The default value is: No. -texturedDecor Draws the map decoration filled with a texture pattern. See also the decorTextureFile and texturedWalls options. The default value is: No. -decorTextureFile Specify a XPM format pixmap file to load the decor texture from. -texturedBalls Draw the balls with a texture specified by the ballTextureFile option. The default value is: No. -ballTextureFile Specify a XPM format pixmap file to load the ball texture from. -targetRadarColor Which color number to use for drawing targets on the radar. Valid values are all even numbers smaller than maxColors. The default value is: 4. -sparkColors Which color numbers to use for spark and debris particles. The default value is: 5,6,7,3. -modifierBank1 The default weapon modifier values for the first modifier bank. -modifierBank2 The default weapon modifier values for the second modifier bank. -modifierBank3 The default weapon modifier values for the third modifier bank. -modifierBank4 The default weapon modifier values for the fourth modifier bank. -keyTurnLeft Turn left (anti-clockwise). The default key is: a. -keyTurnRight Turn right (clockwise). The default key is: s. -keyThrust Thrust. The default keys are: Shift_R Shift_L. -keyShield Raise or toggle the shield. The default keys are: space Caps_Lock. -keyFireShot Fire shot. Note that shields must be down to fire. The default keys are: Return Linefeed. -keyFireMissile Fire smart missile. The default key is: backslash. -keyFireTorpedo Fire unguided torpedo. The default key is: quoteright. -keyFireHeat Fire heatseeking missile. The default key is: semicolon. -keyFireLaser Activate laser beam. The default key is: slash. -keyDropMine Drop a stationary mine. The default key is: Tab. -keyDetachMine Detach a moving mine. The default key is: bracketright. -keyDetonateMines Detonate the mine you have dropped or thrown, which is closest to you. The default key is: equal. -keyLockClose Lock on closest player. The default keys are: Select Up. -keyLockNextClose Lock on next closest player. The default key is: Down. -keyLockNext Lock on next player. The default keys are: Next Right. -keyLockPrev Lock on previous player. The default keys are: Prior Left. -keyRefuel Refuel. The default keys are: f Control_L Control_R. -keyRepair Repair target. The default key is: f. -keyCloak Toggle cloakdevice. The default keys are: Delete BackSpace. -keyEcm Use ECM. The default key is: bracketleft. -keySelfDestruct Toggle self destruct. The default key is: End. -keyIdMode Toggle User mode (show real names). The default key is: u. -keyPause Toggle pause mode. When the ship is stationary on its homebase. The default key is: Pause. -keySwapSettings Swap control settings. These are the power, turn speed and turn resistance settings. The default key is: Escape. -keySwapScaleFactor Swap scalefactor settings. These are the scalefactor settings. -keyChangeHome Change home base. When the ship is stationary on a new homebase. The default keys are: Home h. -keyConnector Connect to a ball. The default key is: Control_L. -keyDropBall Drop a ball. The default key is: d. -keyTankNext Use the next tank. The default key is: e. -keyTankPrev Use the the previous tank. The default key is: w. -keyTankDetach Detach the current tank. The default key is: r. -keyIncreasePower Increase engine power. The default key is: KP_Multiply. -keyDecreasePower Decrease engine power. The default key is: KP_Divide. -keyIncreaseTurnspeed Increase turnspeed. The default key is: KP_Add. -keyDecreaseTurnspeed Decrease turnspeed. The default key is: KP_Subtract. -keyTransporter Use transporter to steal an item. The default key is: t. -keyDeflector Toggle deflector. The default key is: o. -keyHyperJump Teleport. The default key is: q. -keyPhasing Use phasing device. The default key is: p. -keyTalk Toggle talk window. The default key is: m. -keyToggleNuclear Toggle nuclear weapon modifier. The default key is: n. -keyToggleCluster Toggle cluster weapon modifier. The default key is: c. -keyToggleImplosion Toggle implosion weapon modifier. The default key is: i. -keyToggleVelocity Toggle explosion velocity weapon modifier. The default key is: v. -keyToggleMini Toggle mini weapon modifier. The default key is: x. -keyToggleSpread Toggle spread weapon modifier. The default key is: z. -keyTogglePower Toggle power weapon modifier. The default key is: b. -keyToggleCompass Toggle HUD/radar compass lock. The default key is: KP_7. -keyToggleAutoPilot Toggle automatic pilot mode. The default key is: h. -keyToggleLaser Toggle laser modifier. The default key is: l. -keyEmergencyThrust Pull emergency thrust handle. The default key is: j. -keyEmergencyShield Toggle emergency shield power. The default key is: g. -keyTractorBeam Use tractor beam in attract mode. The default key is: comma. -keyPressorBeam Use tractor beam in repulse mode. The default key is: period. -keyClearModifiers Clear current weapon modifiers. The default key is: k. -keyLoadModifiers1 Load the weapon modifiers from bank 1. The default key is: 1. -keyLoadModifiers2 Load the weapon modifiers from bank 2. The default key is: 2. -keyLoadModifiers3 Load the weapon modifiers from bank 3. The default key is: 3. -keyLoadModifiers4 Load the weapon modifiers from bank 4. The default key is: 4. -keyToggleOwnedItems Toggle list of owned items on HUD. The default key is: KP_8. -keyToggleMessages Toggle showing of messages. The default key is: KP_9. -keyReprogram Reprogram modifier or lock bank. The default key is: quoteleft. -keyLoadLock1 Load player lock from bank 1. The default key is: 5. -keyLoadLock2 Load player lock from bank 2. The default key is: 6. -keyLoadLock3 Load player lock from bank 3. The default key is: 7. -keyLoadLock4 Load player lock from bank 4. The default key is: 8. -keyToggleRecord Toggle recording of session (see recordFile). The default key is: KP_5. -keySelectItem Select an item to lose. The default keys are: KP_0 KP_Insert. -keyLoseItem Lose the selected item. The default keys are: KP_Delete KP_Decimal. -keyPrintMessagesStdout Print the current messages to stdout. The default key is: Print. -keyTalkCursorLeft Move Cursor to the left in the talk window. The default key is: Left. -keyTalkCursorRight Move Cursor to the right in the talk window. The default key is: Right. -keyTalkCursorUp Browsing in the history of the talk window. The default key is: Up. -keyTalkCursorDown Browsing in the history of the talk window. The default key is: Down. -keyPointerControl Toggle pointer control. The default key is: KP_Enter. -pointerButton1 The key to activate when pressing the first mouse button. The default value is: keyFireShot. -pointerButton2 The key to activate when pressing the second mouse button. The default value is: keyThrust. -pointerButton3 The key to activate when pressing the third mouse button. The default value is: keyShield. -pointerButton4 The key to activate when pressing the fourth mouse button. -pointerButton5 The key to activate when pressing the fifth mouse button. -maxFPS Set client's maximum FPS supported. The default value is: 20. -recordFile An optional file where a recording of a game can be made. If this file is undefined then recording isn't possible. -clientPortStart Use UDP ports clientPortStart - clientPortEnd (for firewalls). The default value is: 0. -clientPortEnd Use UDP ports clientPortStart - clientPortEnd (for firewalls). The default value is: 0. -scaleFactor Specifies scaling factor for the drawing window. The default value is: 1.0. -altScaleFactor Specifies alternative scaling factor for the drawing window. The default value is: 2.0. -keySendMsg1 Sends the talkmessage stored in msg1. The default key is: F1. -msg1 Talkmessage 1. -keySendMsg2 Sends the talkmessage stored in msg2. The default key is: F2. -msg2 Talkmessage 2. -keySendMsg3 Sends the talkmessage stored in msg3. The default key is: F3. -msg3 Talkmessage 3. -keySendMsg4 Sends the talkmessage stored in msg4. The default key is: F4. -msg4 Talkmessage 4. -keySendMsg5 Sends the talkmessage stored in msg5. The default key is: F5. -msg5 Talkmessage 5. -keySendMsg6 Sends the talkmessage stored in msg6. The default key is: F6. -msg6 Talkmessage 6. -keySendMsg7 Sends the talkmessage stored in msg7. The default key is: F7. -msg7 Talkmessage 7. -keySendMsg8 Sends the talkmessage stored in msg8. The default key is: F8. -msg8 Talkmessage 8. -keySendMsg9 Sends the talkmessage stored in msg9. The default key is: F9. -msg9 Talkmessage 9. -keySendMsg10 Sends the talkmessage stored in msg10. The default key is: F10. -msg10 Talkmessage 10. -keySendMsg11 Sends the talkmessage stored in msg11. The default key is: F11. -msg11 Talkmessage 11. -keySendMsg12 Sends the talkmessage stored in msg12. The default key is: F12. -msg12 Talkmessage 12. -keySendMsg13 Sends the talkmessage stored in msg13. -msg13 Talkmessage 13. -keySendMsg14 Sends the talkmessage stored in msg14. -msg14 Talkmessage 14. -keySendMsg15 Sends the talkmessage stored in msg15. -msg15 Talkmessage 15. -keySendMsg16 Sends the talkmessage stored in msg16. -msg16 Talkmessage 16. -keySendMsg17 Sends the talkmessage stored in msg17. -msg17 Talkmessage 17. -keySendMsg18 Sends the talkmessage stored in msg18. -msg18 Talkmessage 18. -keySendMsg19 Sends the talkmessage stored in msg19. -msg19 Talkmessage 19. -keySendMsg20 Sends the talkmessage stored in msg20. -msg20 Talkmessage 20. Most of these options can also be set in the .xpilotrc file in your home directory. Each key option may have multiple keys bound to it and one key may be used by multiple key options. If no server is specified then xpilot will search for servers on your local network. For a listing of remote servers try: telnet meta.xpilot.org 4400