1XPILOT-NG-SERVER(6) Games XPILOT-NG-SERVER(6)
2
6 xpilot-ng-server - server for multiplayer space war game.
7
9 xpilot-ng-server [ options ]
10
12 Copyright © 1991-2005 by Bjørn Stabell, Ken Ronny Schouten, Bert
13 Gijsbers, Dick Balaska, Uoti Urpala, Juha Lindström, Kristian
14 Söderblom and Erik Andersson. XPilot NG 4.7.2 comes with ABSO‐
15 LUTELY NO WARRANTY; for details see the provided COPYING file.
16 Option flags specify where an option can be used and whether it is vis‐
18 ible or not. Default flags are "any" if not otherwise specified by one
19 or more of these keywords:
20 command May be specified on the command-line. passwordfile May
22 be specified in the password file. defaults May be specified in
23 the defaults file. any May be specified in the map file,
24 defaults file,
25 or on the command line.
27 invisible Is not displayed when a list of options is
29 requested from the server by an operator.
31 The possible options include:
33 -help
35 Print out this help message.
37 -version
39 Print version information.
41 -dump
43 Print all options and their default values in defaultsfile for‐
45 mat.
46 -expand <list>
48 Expand a comma separated list of predefined settings. These
50 settings can be defined in either the defaults file or in a map
51 file using the "define:" operator. [ Flags: command, invisible
52 ]
53 -gravity <real>
55 Gravity strength.
57 -shipMass <real>
59 Mass of fighters.
61 -ballMass <real>
63 Mass of balls.
65 -minItemMass <real>
67 The minimum mass per item when carried by a ship.
69 -shotMass <real>
71 Mass of bullets.
73 -shotSpeed <real>
75 Maximum speed of bullets.
77 -shotLife <real>
79 Life of bullets in ticks.
81 -/+treasureCollisionKills or treasureKills
83 Does a player die when hitting a ballarea?
85 -ballCollisionFuelDrain or ballFuelDrain <real>
87 How much fuel does a ball collision cost?
89 -playerCollisionFuelDrain or playerFuelDrain <real>
91 How much fuel does a player collision cost?
93 -/+shotHitFuelDrainUsesKineticEnergy or kineticEnergyFuelDrain
95 Does the fuel drain from shot hits depend on their mass and
97 speed? This should be set to false on Blood's Music maps.
98 -fireRepeatRate or fireRepeat <real>
100 Number of ticks per automatic fire (0=off).
102 -pulseSpeed <real>
104 Speed of laser pulses.
106 -pulseLife <real>
108 Life of laser pulses shot by ships, in ticks.
110 -pulseLength <real>
112 Max length of laser pulse.
114 -laserRepeatRate or laserRepeat <real>
116 Number of ticks per automatic laser pulse fire (0=off).
118 -maxRobots or robots <integer>
120 The maximum number of robots wanted. Adds robots if there are
122 less than maxRobots players.
123 -minRobots <integer>
125 The minimum number of robots wanted. At least minRobots robots
127 will be in the game, if there is room.
128 -robotFile <string>
130 The file containing parameters for robot details. [ Flags: com‐
132 mand, defaults, invisible ]
133 -/+robotsTalk
135 Do robots talk when they kill, die etc.?
137 -/+robotsLeave
139 Do robots leave the game?
141 -robotLeaveLife <integer>
143 After how many deaths does a robot want to leave? (0=off).
145 -robotTeam <integer>
147 Team to use for robots.
149 -/+restrictRobots
151 Are robots restricted to their own team?
153 -/+reserveRobotTeam
155 Is the robot team only for robots?
157 -robotUserName or robotRealName <string>
159 What is the robots' apparent user name?
161 -robotHostName <string>
163 What is the robots' apparent host name?
165 -tankUserName or tankRealName <string>
167 What is the tanks' apparent user name?
169 -tankHostName <string>
171 What is the tanks' apparent host name?
173 -tankScoreDecrement or tankDecrement <real>
175 How much lower is the tank's score than the player's?
177 -/+selfImmunity
179 Are players immune to their own weapons?
181 -defaultShipShape <string>
183 What is the default ship shape for people who do not have a ship
185 shape defined?
186 -tankShipShape <string>
188 What is the ship shape used for tanks?
190 -maxPlayerShots or shots <integer>
192 Maximum number of shots visible at the same time per player.
194 -/+shotsGravity
196 Are shots affected by gravity.
198 -/+Log
200 Log major server events to log file?
202 -/+idleRun or rawMode
204 Does server calculate frames and do robots keep on playing even
206 if all human players quit? [ Flags: command, defaults ]
207 -/+noQuit
209 Does the server wait for new human players to show up after all
211 players have left. [ Flags: command, defaults ]
212 -/+logRobots
214 Log the comings and goings of robots. [ Flags: command,
216 defaults ]
217 -mapWidth <integer>
219 Width of the world in pixels.
221 -mapHeight <integer>
223 Height of the world in pixels.
225 -mapFileName or map <string>
227 The filename of the map to use. [ Flags: command, defaults,
229 invisible ]
230 -mapName <string>
232 The title of the map.
234 -mapAuthor <string>
236 The name of the map author.
238 -mapData <string>
240 Block map topology. [ Flags: command, any, invisible ]
242 -contactPort or port <integer>
244 The server contact port number. [ Flags: command, defaults ]
246 -serverHost <string>
248 The server's fully qualified domain name (for multihomed hosts).
250 [ Flags: command, defaults ]
251 -greeting or xpilotGreeting <string>
253 Short greeting string for players when they login to server.
255 -/+allowPlayerCrashes
257 Can players overrun other players?
259 -/+allowPlayerBounces
261 Can players bounce with other players?
263 -/+allowPlayerKilling or killings
265 Should players be allowed to kill one other?
267 -/+allowShields or shields
269 Are shields allowed?
271 -/+playerStartsShielded or playerStartShielded
273 Do players start with shields up?
275 -/+shotsWallBounce
277 Do shots bounce off walls?
279 -/+ballsWallBounce
281 Do balls bounce off walls?
283 -/+ballCollisionDetaches or ballHitDetaches
285 Does a ball get freed by a collision with a player?
287 -/+ballCollisions
289 Can balls collide with other objects?
291 -/+ballSparkCollisions
293 Can balls be blown around by exhaust? (Needs ballCollisions too)
295 -/+minesWallBounce
297 Do mines bounce off walls?
299 -/+itemsWallBounce
301 Do items bounce off walls?
303 -/+missilesWallBounce
305 Do missiles bounce off walls?
307 -/+sparksWallBounce
309 Do thrust spark particles bounce off walls to give reactive
311 thrust?
312 -/+debrisWallBounce
314 Do explosion debris particles bounce off walls?
316 -/+asteroidsWallBounce
318 Do asteroids bounce off walls?
320 -/+pulsesWallBounce
322 Do laser pulses bounce off walls?
324 -/+cloakedExhaust
326 Do engines of cloaked ships generate exhaust?
328 -maxObjectWallBounceSpeed or maxObjectBounceSpeed <real>
330 The maximum allowed speed for objects to bounce off walls.
332 -maxSparkWallBounceSpeed or maxSparkBounceSpeed <real>
334 The maximum allowed speed for sparks to bounce off walls.
336 -maxShieldedWallBounceSpeed or maxShieldedBounceSpeed <real>
338 The max allowed speed for a shielded player to bounce off walls.
340 -maxUnshieldedWallBounceSpeed or maxUnshieldedBounceSpeed <real>
342 Max allowed speed for an unshielded player to bounce off walls.
344 -playerWallBounceType or wallBounceType <integer>
346 What kind of ship wall bounces to use.
348 A value of 0 gives the old XPilot wall bounces, where the ship
350 velocity in the direction perpendicular to the wall is reversed
351 after which the velocity is multiplied by the value of the play‐
352 erWallBounceBrakeFactor option.
353 A value of 1 gives the "separate multipliers" implementation.
355 A value of 2 causes Mara's suggestion for the speed change in
357 the direction parallel to the wall to be used. Vtangent2 =
358 (1-Vnormal1/Vtotal1*wallfriction)*Vtangent1
359 A value of 3 causes Uau's suggestion to be used: change the par‐
361 allel one by MIN(C1*perpendicular_change, C2*parallel_speed) if
362 you assume the wall has a coefficient of friction C1. .
363 -playerWallBounceBrakeFactor or playerWallBrake <real>
365 Factor to slow down ship in direction perpendicular to the wall
367 when a wall is hit (0 to 1).
368 -playerBallBounceBrakeFactor or playerBallBrake <real>
370 Elastic or inelastic properties of the player-ball collision 1
372 means fully elastic, 0 fully inelastic.
373 -playerWallFriction or wallFriction <real>
375 Player-wall friction (0 to 1).
377 -objectWallBounceBrakeFactor or objectWallBrake <real>
379 Factor to slow down objects when they hit the wall (0 to 1).
381 -objectWallBounceLifeFactor <real>
383 Factor to reduce the life of objects after bouncing (0 to 1).
385 -afterburnerPowerMult or afterburnerPower <real>
387 Multiplication factor for afterburner power.
389 -wallBounceDestroyItemProb <real>
391 The probability for each item a player owns to get destroyed
393 when the player bounces against a wall.
394 -/+reportToMetaServer or reportMeta
396 Keep the meta server informed about our game? [ Flags: command,
398 defaults ]
399 -metaUpdateMaxSize <integer>
401 Maximum size of meta update messages.
403 -/+searchDomainForXPilot
405 Search the local domain for the existence of xpilot.domain? [
407 Flags: command, defaults ]
408 -denyHosts <string>
410 List of network addresses of computers which are denied service.
412 Addresses may be followed by a slash and a network mask. [
413 Flags: command, defaults ]
414 -/+limitedVisibility
416 Should the players have a limited visibility?
418 -minVisibilityDistance or minVisibility <real>
420 Minimum block distance for limited visibility, 0 for default.
422 -maxVisibilityDistance or maxVisibility <real>
424 Maximum block distance for limited visibility, 0 for default.
426 -/+limitedLives
428 Should players have limited lives? See also worldLives.
430 -worldLives or lives <integer>
432 Number of lives each player has (no sense without limitedLives).
434 -/+reset
436 Does the world reset when the end of round is reached? When
438 true all mines, missiles, shots and explosions will be removed
439 from the world and all players including the winner(s) will be
440 transported back to their homebases. This option is only effec‐
441 tive when limitedLives is turned on.
442 -resetOnHuman or humanReset <integer>
444 Normally, new players have to wait until a round is finished
446 before they can start playing. With this option, the first N
447 human players to enter will cause the round to be restarted. In
448 other words, if this option is set to 0, nothing special happens
449 and you have to wait as usual until the round ends (if there are
450 rounds at all, otherwise this option doesn't do anything). If it
451 is set to 1, the round is ended when the first human player
452 enters. This is useful if the robots have already started a
453 round and you don't want to wait for them to finish. If it is
454 set to 2, this also happens for the second human player. This
455 is useful when you got bored waiting for another player to show
456 up and have started playing against the robots. When someone
457 finally joins you, they won't have to wait for you to finish the
458 round before they can play too. For higher numbers it works the
459 same. So this option gives the last human player for whom the
460 round is restarted. Anyone who enters after that does have to
461 wait until the round is over.
462 -/+allowAlliances or alliances
464 Are alliances between players allowed? Alliances are like
466 teams, except they can be formed and dissolved at any time.
467 Notably, teamImmunity works for alliances too. To manage
468 alliances, use the '/ally' talk command: '/ally invite <player
469 name>' to invite another player to join you. '/ally cancel' to
470 cancel such an invitation. '/ally refuse <player name>' to
471 decline an invitation from a player. '/ally refuse' to decline
472 all the invitations you received. '/ally accept <player name>'
473 to join the other player. '/ally accept' to accept all the
474 invitations you received. '/ally leave' to leave the alliance
475 you are currently in. '/ally list' lists the members of your
476 current alliance. If members from different alliances join, all
477 their allies do so.
478 -/+announceAlliances
480 Are changes in alliances made public? If this option is on,
482 changes in alliances are sent to all players and all alliances
483 are shown in the score list. Invitations for alliances are never
484 sent to anyone but the invited players.
485 -/+teamPlay or teams
487 Is the map a team play map?
489 -/+lockOtherTeam
491 Can you watch opposing players when rest of your team is still
493 alive?
494 -/+teamFuel
496 Do fuelstations belong to teams?
498 -/+teamCannons
500 Do cannons belong to teams?
502 -cannonSmartness <integer>
504 0: dumb (straight ahead), 1: default (random direction), 2: good
506 (small error), 3: accurate (aims at predicted player position).
507 Also influences use of weapons.
508 -/+cannonsPickupItems
510 Do cannons pick up items?
512 -/+cannonFlak or cannonAAA
514 Do cannons fire flak or normal bullets?
516 -cannonDeadTicks <real>
518 How many ticks do cannons stay dead? Replaces option cannon‐
520 DeadTime.
521 -cannonShotSpeed <real>
523 Speed of cannon shots.
525 -minCannonShotLife <real>
527 Minimum life of cannon shots, measured in ticks. If this is set
529 to a value greater than maxCannonShotLife, then maxCannon‐
530 ShotLife will be set to that same value.
531 -maxCannonShotLife <real>
533 Maximum life of cannon shots, measured in ticks. If this is set
535 to a value less than minCannonShotLife, then minCannonShotLife
536 will be set to that same value.
537 -cannonInitialFuel <integer>
539 How much fuel cannons start with.
541 -cannonInitialTanks <integer>
543 How many tanks cannons start with.
545 -cannonInitialECMs <integer>
547 How many ECMs cannons start with.
549 -cannonInitialArmor or cannonInitialArmors <integer>
551 How much armor cannons start with.
553 -cannonInitialMines <integer>
555 How many mines cannons start with.
557 -cannonInitialMissiles <integer>
559 How many missiles cannons start with.
561 -cannonInitialCloaks <integer>
563 How many cloaks cannons start with.
565 -cannonInitialSensors <integer>
567 How many sensors cannons start with.
569 -cannonInitialWideangles <integer>
571 How many wideangles cannons start with.
573 -cannonInitialRearshots <integer>
575 How many rearshots cannons start with.
577 -cannonInitialAfterburners <integer>
579 How many afterburners cannons start with.
581 -cannonInitialTransporters <integer>
583 How many transporters cannons start with.
585 -cannonInitialMirrors <integer>
587 How many mirrors cannons start with.
589 -cannonInitialDeflectors <integer>
591 How many deflectors cannons start with.
593 -cannonInitialHyperJumps <integer>
595 How many hyperjumps cannons start with.
597 -cannonInitialPhasings <integer>
599 How many phasing devices cannons start with.
601 -cannonInitialLasers <integer>
603 How many lasers cannons start with.
605 -cannonInitialEmergencyThrusts <integer>
607 How many emergency thrusts cannons start with.
609 -cannonInitialTractorBeams <integer>
611 How many tractor/pressor beams cannons start with.
613 -cannonInitialAutopilots <integer>
615 How many autopilots cannons start with.
617 -cannonInitialEmergencyShields <integer>
619 How many emergency shields cannons start with.
621 -/+keepShots
623 Do shots, mines and missiles remain after their owner leaves?
625 -/+teamImmunity
627 Should other team members be immune to various shots thrust
629 etc.? This works for alliances too.
630 -/+ecmsReprogramMines
632 Is it possible to reprogram mines with ECMs?
634 -/+ecmsReprogramRobots
636 Are robots reprogrammed by ECMs instead of blinded?
638 -/+targetKillTeam
640 Do team members die when their last target explodes?
642 -/+targetTeamCollision or targetCollision
644 Do team members collide with their own target or not.
646 -/+targetSync
648 Do all the targets of a team reappear/repair at the same time?
650 -targetDeadTicks <real>
652 How many ticks do targets stay destroyed? Replaces option tar‐
654 getDeadTime.
655 -/+treasureKillTeam
657 Do team members die when their treasure is destroyed?
659 -/+captureTheFlag or ctf
661 Does a team's treasure have to be safe before enemy balls can be
663 cashed?
664 -specialBallTeam or specialBall <integer>
666 Balls that belong to this team are 'special' balls that score
668 against all other teams.
669 -/+treasureCollisionDestroys or treasureCollisionDestroy
671 Are balls destroyed when a player touches it?
673 -ballConnectorSpringConstant <real>
675 What is the spring constant for connectors?
677 -ballConnectorDamping <real>
679 What is the damping force on connectors?
681 -maxBallConnectorRatio <real>
683 How much longer or shorter can a connecter get before it breaks?
685 -ballConnectorLength <real>
687 How long is a normal connector string?
689 -/+connectorIsString
691 Can the connector get shorter?
693 -ballRadius <real>
695 What radius, measured in pixels, the treasure balls have on the
697 server. In traditional XPilot, the ball was treated as a point
698 (radius = 0), but visually appeared on the client with a radius
699 of 10 pixels.
700 -/+treasureCollisionMayKill or treasureUnshieldedCollisionKills
702 Does a ball kill a player when the player touches it unshielded?
704 -/+wreckageCollisionMayKill or wreckageUnshieldedCollisionKills
706 Can ships be destroyed when hit by wreckage?
708 -/+asteroidCollisionMayKill or asteroidUnshieldedCollisionKills
710 Can ships be destroyed when hit by an asteroid?
712 -/+ignore20MaxFPS
714 Ignore client maxFPS request if it is 20 (old default, too low).
716 [ Flags: command, defaults ]
717 -/+tagGame or tag
719 Are we going to play a game of tag? One player is 'it' (is
721 worth more points when killed than the others). After this
722 player is killed, the one who killed them becomes 'it', and so
723 on.
724 -tagKillItScoreMult or tagKillItMult <real>
726 Score multiplier for killing 'it' (tagGame must be on).
728 -tagItKillScoreMult or tagItKillMult <real>
730 Score multiplier when 'it' kills an enemy player (tagGame must
732 be on).
733 -/+timing or race
735 Enable race mode?
737 -/+ballrace
739 Is timing done for balls (on) or players (off)? Only used if
741 timing is on.
742 -/+ballraceConnected
744 Should a player be connected to a ball to pass a checkpoint?
746 Only used if timing and ballrace are both on.
747 -/+edgeWrap
749 Do objects wrap when they cross the edge of the Universe?.
751 -/+edgeBounce
753 Do objects bounce when they hit the edge of the Universe?.
755 -/+extraBorder
757 Give map an extra border of wall blocks?.
759 -gravityPoint <position>
761 If the gravity is a point source where does that gravity origi‐
763 nate? Specify the point in the form: x,y.
764 -gravityAngle <real>
766 If gravity is along a uniform line, at what angle is that line?
768 -/+gravityPointSource
770 Is gravity originating from a single point?
772 -/+gravityClockwise
774 If the gravity is a point source, is it clockwise?
776 -/+gravityAnticlockwise
778 If the gravity is a point source, is it anticlockwise?
780 -/+gravityVisible
782 Are gravity mapsymbols visible to players?
784 -/+wormholeVisible
786 Are wormhole mapsymbols visible to players?
788 -/+itemConcentratorVisible
790 Are itemconcentrator mapsymbols visible to players?
792 -/+asteroidConcentratorVisible
794 Are asteroidconcentrator mapsymbols visible to players?
796 -wormholeStableTicks <real>
798 Number of ticks wormholes will keep the same destination.
800 -defaultsFileName or defaults <string>
802 The filename of the defaults file to read on startup. [ Flags:
804 command, invisible ]
805 -passwordFileName <string>
807 The filename of the password file to read on startup. [ Flags:
809 command, defaults, invisible ]
810 -motdFileName or motd <string>
812 The filename of the MOTD file to show to clients when they join.
814 [ Flags: command, defaults, invisible ]
815 -scoreTableFileName or scoretable <string>
817 The filename for the score table to be dumped to. This is a
819 placeholder option which doesn't do anything. [ Flags: command,
820 defaults, invisible ]
821 -adminMessageFileName or adminMessage <string>
823 The name of the file where player messages for the server admin‐
825 istrator will be saved. For the messages to be saved the file
826 must already exist. Players can send these messages by writing
827 to god. [ Flags: command, defaults, invisible ]
828 -adminMessageFileSizeLimit or adminMessageLimit <integer>
830 The maximum size in bytes of the admin message file. [ Flags:
832 command, defaults, invisible ]
833 -rankFileName <string>
835 The filename for the XML file to hold server ranking data. To
837 reset the ranking, delete this file. [ Flags: command,
838 defaults, invisible ]
839 -rankWebpageFileName or rankWebpage <string>
841 The filename for the webpage with the server ranking list. [
843 Flags: command, defaults, invisible ]
844 -rankWebpageCSS or rankCSS <string>
846 The URL of an optional style sheet for the ranking webpage. [
848 Flags: command, defaults, invisible ]
849 -framesPerSecond or FPS <integer>
851 The number of frames per second the server should strive for.
853 -gameSpeed <real>
855 Rate at which game events happen. The gameSpeed specifies how
857 many ticks of game time elapse each second. A value of 0 means
858 that the value of gameSpeed should be equal to the value of FPS.
859 -/+allowSmartMissiles or allowSmarts
861 Should smart missiles be allowed?
863 -/+allowHeatSeekers or allowHeats
865 Should heatseekers be allowed?
867 -/+allowTorpedoes or allowTorps
869 Should torpedoes be allowed?
871 -/+allowNukes or nukes
873 Should nuclear weapons be allowed?
875 -/+allowClusters or clusters
877 Should cluster weapons be allowed?
879 -/+allowModifiers or modifiers
881 Should the weapon modifiers be allowed?
883 -/+allowLaserModifiers or lasermodifiers
885 Can lasers be modified to be a different weapon?
887 -/+allowShipShapes or ShipShapes
889 Are players allowed to define their own ship shape?
891 -/+playersOnRadar or playersRadar
893 Are players visible on the radar.
895 -/+missilesOnRadar or missilesRadar
897 Are missiles visible on the radar.
899 -/+minesOnRadar or minesRadar
901 Are mines visible on the radar.
903 -/+nukesOnRadar or nukesRadar
905 Are nukes visible or highlighted on the radar.
907 -/+treasuresOnRadar or treasuresRadar
909 Are treasure balls visible or highlighted on the radar.
911 -/+asteroidsOnRadar or asteroidsRadar
913 Are asteroids visible on the radar.
915 -/+distinguishMissiles
917 Are different types of missiles distinguished (by length).
919 -maxMissilesPerPack <integer>
921 The number of missiles gotten by picking up one missile item.
923 -maxMinesPerPack <integer>
925 The number of mines gotten by picking up one mine item.
927 -/+identifyMines
929 Are mine owner's names displayed.
931 -/+shieldedItemPickup or shieldItem
933 Can items be picked up while shields are up?
935 -/+shieldedMining or shieldMine
937 Can mines be thrown and placed while shields are up?
939 -/+laserIsStunGun or stunGun
941 Is the laser weapon a stun gun weapon?
943 -nukeMinSmarts <integer>
945 The minimum number of missiles needed to fire one nuclear mis‐
947 sile.
948 -nukeMinMines <integer>
950 The minimum number of mines needed to make a nuclear mine.
952 -nukeClusterDamage <real>
954 How much each cluster debris does damage wise from a nuke mine.
956 This helps to reduce the number of particles caused by nuclear
957 mine explosions, which improves server response time for such
958 explosions.
959 -nukeDebrisLife <real>
961 Life of nuke debris, in ticks.
963 -mineFuseTicks <real>
965 Number of ticks after which owned mines become deadly (0=never).
967 -mineLife <real>
969 Life of mines in ticks.
971 -minMineSpeed <real>
973 Minimum speed of mines.
975 -missileLife <real>
977 Life of missiles in ticks.
979 -baseMineRange <real>
981 Minimum distance from base mines may be used (unit is blocks).
983 -mineShotDetonateDistance <real>
985 How close must a shot be to detonate a mine? Set this to 0 to
987 turn it off.
988 -shotKillScoreMult <real>
990 Multiplication factor to scale score for shot kills.
992 -torpedoKillScoreMult <real>
994 Multiplication factor to scale score for torpedo kills.
996 -smartKillScoreMult <real>
998 Multiplication factor to scale score for smart missile kills.
1000 -heatKillScoreMult <real>
1002 Multiplication factor to scale score for heatseeker kills.
1004 -clusterKillScoreMult <real>
1006 Multiplication factor to scale score for cluster debris kills.
1008 -laserKillScoreMult <real>
1010 Multiplication factor to scale score for laser kills.
1012 -tankKillScoreMult <real>
1014 Multiplication factor to scale score for tank kills.
1016 -runoverKillScoreMult <real>
1018 Multiplication factor to scale score for player runovers.
1020 -ballKillScoreMult <real>
1022 Multiplication factor to scale score for ball kills.
1024 -explosionKillScoreMult <real>
1026 Multiplication factor to scale score for explosion kills.
1028 -shoveKillScoreMult <real>
1030 Multiplication factor to scale score for shove kills.
1032 -crashScoreMult <real>
1034 Multiplication factor to scale score for player crashes.
1036 -mineScoreMult <real>
1038 Multiplication factor to scale score for mine hits.
1040 -selfKillScoreMult <real>
1042 Multiplication factor to scale score for killing yourself.
1044 -selfDestructScoreMult <real>
1046 Multiplication factor to scale score for self-destructing.
1048 -unownedKillScoreMult <real>
1050 Multiplication factor to scale score for being killed by aster‐
1052 oids or other objects without an owner.
1053 -cannonKillScoreMult <real>
1055 Multiplication factor to scale score for being killed by can‐
1057 nons.
1058 -movingItemProb <real>
1060 Probability for an item to appear as moving.
1062 -randomItemProb <real>
1064 Probability for an item to appear random. Random items change
1066 their appearance every frame, so players cannot tell what item
1067 they have until they get it.
1068 -dropItemOnKillProb <real>
1070 Probability for dropping an item (each item) when you are
1072 killed.
1073 -detonateItemOnKillProb <real>
1075 Probability for undropped items to detonate when you are killed.
1077 -destroyItemInCollisionProb <real>
1079 Probability for items (some items) to be destroyed in a colli‐
1081 sion.
1082 -asteroidItemProb <real>
1084 Probability for an asteroid to release items when it breaks.
1086 -asteroidMaxItems <integer>
1088 The maximum number of items a broken asteroid can release.
1090 -itemProbMult or itemProbFact <real>
1092 Item Probability Factor scales all item probabilities.
1094 -cannonItemProbMult <real>
1096 Average number of items a cannon gets per minute.
1098 -maxItemDensity <real>
1100 Maximum density for items (max items per block).
1102 -asteroidProb <real>
1104 Probability for an asteroid to appear.
1106 -maxAsteroidDensity <real>
1108 Maximum density [0.0-1.0] for asteroids (max asteroids per
1110 block.
1111 -itemConcentratorRadius or itemConcentratorRange <real>
1113 Range within which an item concentrator can create an item.
1115 Sensible values are in the range 1.0 to 20.0 (unit is 35 pix‐
1116 els). If there are no item concentrators, items might popup
1117 anywhere. Some clients draw item concentrators as three rotat‐
1118 ing triangles.
1119 -itemConcentratorProb <real>
1121 The chance for an item to appear near an item concentrator. If
1123 this is less than 1.0 or there are no item concentrators, items
1124 may also popup where there is no concentrator nearby.
1125 -asteroidConcentratorRadius or asteroidConcentratorRange <real>
1127 Range within which an asteroid concentrator can create an aster‐
1129 oid. Sensible values are in the range 1.0 to 20.0 (unit is 35
1130 pixels). If there are no such concentrators, asteroids can
1131 popup anywhere. Some clients draw these concentrators as three
1132 rotating squares.
1133 -asteroidConcentratorProb <real>
1135 The chance for an asteroid to appear near an asteroid concentra‐
1137 tor. If this is less than 1.0 or there are no asteroid concen‐
1138 trators, asteroids may also appear where there is no concentra‐
1139 tor nearby.
1140 -rogueHeatProb <real>
1142 Probability that unclaimed missile packs will go rogue.
1144 -rogueMineProb <real>
1146 Probability that unclaimed mine items will activate.
1148 -itemEnergyPackProb <real>
1150 Probability for an energy pack to appear.
1152 -itemTankProb <real>
1154 Probability for an extra tank to appear.
1156 -itemECMProb <real>
1158 Probability for an ECM item to appear.
1160 -itemArmorProb <real>
1162 Probability for an armor item to appear.
1164 -itemMineProb <real>
1166 Probability for a mine item to appear.
1168 -itemMissileProb <real>
1170 Probability for a missile item to appear.
1172 -itemCloakProb <real>
1174 Probability for a cloak item to appear.
1176 -itemSensorProb <real>
1178 Probability for a sensor item to appear.
1180 -itemWideangleProb <real>
1182 Probability for a wideangle item to appear.
1184 -itemRearshotProb <real>
1186 Probability for a rearshot item to appear.
1188 -itemAfterburnerProb <real>
1190 Probability for an afterburner item to appear.
1192 -itemTransporterProb <real>
1194 Probability for a transporter item to appear.
1196 -itemMirrorProb <real>
1198 Probability for a mirror item to appear.
1200 -itemDeflectorProb <real>
1202 Probability for a deflector item to appear.
1204 -itemHyperJumpProb <real>
1206 Probability for a hyperjump item to appear.
1208 -itemPhasingProb <real>
1210 Probability for a phasing item to appear.
1212 -itemLaserProb <real>
1214 Probability for a Laser item to appear.
1216 -itemEmergencyThrustProb <real>
1218 Probability for an Emergency Thrust item to appear.
1220 -itemTractorBeamProb <real>
1222 Probability for a Tractor Beam item to appear.
1224 -itemAutopilotProb <real>
1226 Probability for an Autopilot item to appear.
1228 -itemEmergencyShieldProb <real>
1230 Probability for an Emergency Shield item to appear.
1232 -initialFuel <integer>
1234 How much fuel players start with.
1236 -initialTanks <integer>
1238 How many tanks players start with.
1240 -initialECMs <integer>
1242 How many ECMs players start with.
1244 -initialArmor or initialArmors <integer>
1246 How much armor players start with.
1248 -initialMines <integer>
1250 How many mines players start with.
1252 -initialMissiles <integer>
1254 How many missiles players start with.
1256 -initialCloaks <integer>
1258 How many cloaks players start with.
1260 -initialSensors <integer>
1262 How many sensors players start with.
1264 -initialWideangles <integer>
1266 How many wideangles players start with.
1268 -initialRearshots <integer>
1270 How many rearshots players start with.
1272 -initialAfterburners <integer>
1274 How many afterburners players start with.
1276 -initialTransporters <integer>
1278 How many transporters players start with.
1280 -initialMirrors <integer>
1282 How many mirrors players start with.
1284 -initialDeflectors <integer>
1286 How many deflectors players start with.
1288 -initialHyperJumps <integer>
1290 How many hyperjumps players start with.
1292 -initialPhasings <integer>
1294 How many phasing devices players start with.
1296 -initialLasers <integer>
1298 How many lasers players start with.
1300 -initialEmergencyThrusts <integer>
1302 How many emergency thrusts players start with.
1304 -initialTractorBeams <integer>
1306 How many tractor/pressor beams players start with.
1308 -initialAutopilots <integer>
1310 How many autopilots players start with.
1312 -initialEmergencyShields <integer>
1314 How many emergency shields players start with.
1316 -maxFuel <integer>
1318 Upper limit on the amount of fuel per player.
1320 -maxTanks <integer>
1322 Upper limit on the number of tanks per player.
1324 -maxECMs <integer>
1326 Upper limit on the number of ECMs per player.
1328 -maxMines <integer>
1330 Upper limit on the number of mines per player.
1332 -maxMissiles <integer>
1334 Upper limit on the number of missiles per player.
1336 -maxCloaks <integer>
1338 Upper limit on the number of cloaks per player.
1340 -maxSensors <integer>
1342 Upper limit on the number of sensors per player.
1344 -maxWideangles <integer>
1346 Upper limit on the number of wides per player.
1348 -maxRearshots <integer>
1350 Upper limit on the number of rearshots per player.
1352 -maxAfterburners <integer>
1354 Upper limit on the number of afterburners per player.
1356 -maxTransporters <integer>
1358 Upper limit on the number of transporters per player.
1360 -maxArmor or maxArmors <integer>
1362 Upper limit on the amount of armor per player.
1364 -maxMirrors <integer>
1366 Upper limit on the number of mirrors per player.
1368 -maxDeflectors <integer>
1370 Upper limit on the number of deflectors per player.
1372 -maxPhasings <integer>
1374 Upper limit on the number of phasing devices per players.
1376 -maxHyperJumps <integer>
1378 Upper limit on the number of hyperjumps per player.
1380 -maxEmergencyThrusts <integer>
1382 Upper limit on the number of emergency thrusts per player.
1384 -maxLasers <integer>
1386 Upper limit on the number of lasers per player.
1388 -maxTractorBeams <integer>
1390 Upper limit on the number of tractorbeams per player.
1392 -maxAutopilots <integer>
1394 Upper limit on the number of autopilots per player.
1396 -maxEmergencyShields <integer>
1398 Upper limit on the number of emergency shields per player.
1400 -gameDuration or time <real>
1402 The duration of the game in minutes (aka. pizza mode).
1404 -/+baselessPausing
1406 Should paused players keep their bases? Can only be used on
1408 teamplay maps for now.
1409 -survivalScore <real>
1411 Multiplicator for quadratic score increase over time survived
1413 with lowered shield
1414 -pauseTax <real>
1416 How many points to subtract from pausing players each second.
1418 -friction <real>
1420 Fraction of velocity ship loses each frame.
1422 -blockFriction <real>
1424 Fraction of velocity ship loses each frame when it is in fric‐
1426 tion blocks.
1427 -/+blockFrictionVisible
1429 Are friction blocks visible? If true, friction blocks show up
1431 as decor; if false, they don't show up at all.
1432 -coriolis <real>
1434 The clockwise angle (in degrees) a ship's velocity turns each
1436 time unit.
1437 -checkpointRadius <real>
1439 How close you have to be to a checkpoint to register - in
1441 blocks.
1442 -raceLaps <integer>
1444 How many laps per race.
1446 -/+loseItemDestroys
1448 Destroy item that player drops. Otherwise drop it.
1450 -/+useDebris
1452 Are debris particles created where appropriate? Value affect
1454 ship exhaust sparks and cluster debris. To disallow cluster
1455 weapons but not sparks, set allowClusters off.
1456 -/+useWreckage
1458 Do destroyed ships leave wreckage?
1460 -maxOffensiveItems <integer>
1462 How many offensive items a player can carry.
1464 -maxDefensiveItems <integer>
1466 How many defensive items a player can carry.
1468 -maxRoundTime <integer>
1470 The maximum duration of each round, in seconds.
1472 -roundsToPlay or numRounds <integer>
1474 The number of rounds to play.
1476 Unlimited if 0.
1477 -maxVisibleObject or maxVisibleObjects <integer>
1479 What is the maximum number of objects a player can see.
1481 -/+pLockServer
1483 Whether the server is prevented from being swapped out of mem‐
1485 ory. [ Flags: command, defaults ]
1486 -/+sound
1488 Does the server send sound events to players that request sound.
1490 -timerResolution <integer>
1492 If set to nonzero xpilots will requests signals from the OS at
1494 1/timerResolution second intervals. The server will then com‐
1495 pute a new frame FPS times out of every timerResolution signals.
1496 [ Flags: command, defaults ]
1497 -password <string>
1499 The password needed to obtain operator privileges. If specified
1501 on the command line, on many systems other users will be able to
1502 see the password. Therefore, using the password file instead is
1503 recommended. [ Flags: command, passwordfile, defaults, invisi‐
1504 ble ]
1505 -clientPortStart <integer>
1507 Use UDP ports clientPortStart - clientPortEnd (for firewalls) [
1509 Flags: command, defaults ]
1510 -clientPortEnd <integer>
1512 Use UDP ports clientPortStart - clientPortEnd (for firewalls) [
1514 Flags: command, defaults ]
1515 -maxPauseTime <integer>
1517 The maximum time a player can stay paused for, in seconds.
1519 After being paused this long, the player will be kicked off.
1520 Setting this option to 0 disables the feature.
1521 -maxIdleTime <integer>
1523 The maximum time a player can stay idle, in seconds. After hav‐
1525 ing idled this long, the player will be paused. Setting this
1526 option to 0 disables the feature.
1527 -maxClientsPerIP or maxPerIP <integer>
1529 Maximum number of clients per IP address allowed to connect.
1531 This prevents unfriendly players from occupying all the bases,
1532 effectively "kicking" paused players and denying other players
1533 to join. Setting this to 0 means any number of clients from the
1534 same IP address can join. [ Flags: command, defaults ]
1535 -playerLimit <integer>
1537 Allow playerLimit players to enter at once. If set to 0, allow
1539 10 more players than there are bases. (If baselessPausing is
1540 off, more than bases cannot enter.) During game, cannot be set
1541 higher than the starting value.
1542 -recordMode <integer>
1544 If this is set to 1 when the server starts, the game is saved in
1546 the file specified by recordFileName. If set to 2 at startup,
1547 the server replays the recorded game. Joining players are spec‐
1548 tators who can watch the recorded game from anyone's viewpoint.
1549 Can be set to 0 in the middle of a game to stoprecording. [
1550 Flags: command, defaults, invisible ]
1551 -recordFileName or recordFile <string>
1553 Name of the file where server recordings are saved. [ Flags:
1555 command, defaults, invisible ]
1556 -recordFlushInterval or recordWait <integer>
1558 If set to a nonzero value x, the server will flush all recording
1560 data in memory to the record file at least once every x seconds.
1561 This is useful if you want to replay the game on another server
1562 while it is still being played. There is a small overhead (some
1563 dozens of bytes extra recording file size) for each flush.
1564 -/+constantScoring
1566 Whether the scores given from various things are fixed.
1568 -/+zeroSumScoring or zeroSum
1570 Use Zero sum scoring? [ Flags: command ]
1572 -/+elimination
1574 Race mode where the last player drops out each lap.
1576 -dataURL <string>
1578 URL where the client can get extra data for this map.
1580 -/+polygonMode
1582 Force use of polygon protocol when communicating with clients?
1584 (useful for debugging if you want to see the polygons created in
1585 the blocks to polygons conversion function).
1586 -/+fastAim
1588 When calculating a frame, turn the ship before firing. This
1590 means you can change aim one frame faster. Added this option to
1591 see how much difference changing the order would make.
1592 -/+ngControls
1594 Enable improved precision steering and aiming of main gun.
1596 -/+legacyMode
1598 Try to emulate classic xpilot behavior.
1600 -constantSpeed or oldThrust <real>
1602 Make ship move forward at a constant speed when thrust key is
1604 held down, in addition to the normal acceleration. The constant
1605 speed is proportional to the product of the acceleration of the
1606 ship (varying with ship mass and afterburners) and the value of
1607 this option. Note that this option is quite unphysical and can
1608 using it can cause weird effects (with bounces for example).
1609 Low values close to 0.5 (maybe in the range 0.3 to 1) for this
1610 option can be used if you want to increase ship agility without
1611 increasing speeds otherwise. This can improve gameplay for exam‐
1612 ple on the Blood's Music map. Higher values make the ship behav‐
1613 iour visibly weird.
1614 -turnPushPersistence or pushPersist <real>
1616 How much of the turnpush to remain as player velocity. (0.0-1.0)
1618 -turnGrip or turnPushGrip <real>
1620 How much of of the turnPush should pull the ship sideways by
1622 gripping to the friction of the wall?. (0.0-1.0)
1623 -thrustWidth or sprayWidth <real>
1625 Width of thrust spark spray 0.0-1.0 where 1.0 means 180 degrees.
1627 -thrustMass or sparkWeight <real>
1629 Weight of thrust sparks.
1631 -sparkSpeed or sparkVel <real>
1633 Multiplier affecting avg. speed (relative ship) of thrust
1635 sparks.
1636 -/+ballStyles
1638 Send ball styles to clients.
1640 -/+ignoreMaxFPS
1642 Ignore client maxFPS requests and always send all frames. This
1644 is a hack for demonstration purposes to allow changing the
1645 server FPS when there are old clients with broken maxFPS han‐
1646 dling. Those clients could be better dealt with separately.
1647 This option will be removed in the future (hopefully).
1648 -pausedFramesPerSecond or pausedFPS <integer>
1650 Maximum FPS shown to paused players. 0 means full framerate.
1652 Can be used to reduce server bandwidth consumption.
1653 -waitingFramesPerSecond or waitingFPS <integer>
1655 Maximum FPS shown to players in waiting state. 0 means full
1657 framerate. Can be used to limit bandwidth used. Waiting players
1658 are those that have just joined a game and have to wait until
1659 next round starts. Note that in clients, a W is shown next to
1660 waiting players' names in the score list.
1661 -deadFramesPerSecond or deadFPS <integer>
1663 Maximum FPS shown to players in dead state. 0 means full fram‐
1665 erate. Can be used to limit bandwidth used. This option should
1666 only be used if pausedFPS and waitingFPS options don't limit
1667 bandwidth usage enough. Dead players are those that have played
1668 this round but have run out of lives. Note that in clients, a D
1669 is shown next to dead players' names in the score list.
1670 -/+teamcup
1672 Is this a teamcup match?. [ Flags: command, any, invisible ]
1674 -teamcupName <string>
1676 The name of the teamcup (used only if teamcup is true). [
1678 Flags: command, any, invisible ]
1679 -teamcupMailAddress <string>
1681 The mail address where players should send match results. [
1683 Flags: command, any, invisible ]
1684 -teamcupScoreFileNamePrefix <string>
1686 First part of file name for teamcup score files. The whole
1688 filename will be this followed by the match number. [ Flags:
1689 command, any, invisible ]
1690 -teamcupMatchNumber or match <integer>
1692 The number of the teamcup match. [ Flags: command ]
1694 -mainLoopTime <real>
1696 Duration of last Main_loop() function call (in milliseconds).
1698 This option is read only. [ Flags: command ]
1699 -cellGetObjectsThreshold or cellThreshold <integer>
1701 Use Cell_get_objects if there is this many objects or more.
1703 The probabilities are in the range [0.0-1.0] and they refer to
1705 the probability that an event will occur in a block per second.
1706 Boolean options are turned off by using +<option>.
1707 Please refer to the manual pages, xpilot-ng-server(6), xpi‐
1709 lot-ng-x11(6) and xpilot-ng-sdl(6) for more specific help.
1710 XPilot NG 4.7.2 comes with ABSOLUTELY NO WARRANTY; for details
1712 see the provided COPYING file.
1713 XPilot NG 4.7.2
1715xpilot.sourceforge.net August 2006 XPILOT-NG-SERVER(6)