XPILOT-NG-SERVER(6)

📦
version 4.7.3 · 2 versions
, in fedora 43, fedora 44

✨ NAME ✨

xpilot-ng-server — server for multiplayer space war game. periodt. 🚀💖

🛰️ SYNOPSIS 🛰️

xpilot-ng-server [ options ]

fr fr, that's the whole summoning spell. You run it, you hand it some options, and it does server things for a multiplayer space war game. ✨

💖 DESCRIPTION 💖

First up, the legal tea, no cap:

Copyright © 1991-2005 by Bjørn Stabell, Ken Ronny Schouten, Bert Gijsbers, Dick Balaska, Uoti Urpala, Juha Lindström, Kristian Söderblom and Erik Andersson. XPilot NG 4.7.2 comes with ABSOLUTELY NO WARRANTY; for details see the provided COPYING file.

Option flags specify where an option can be used and whether it is visible or not. Default flags are "any" if not otherwise specified by one or more of these keywords:

  • command — May be specified on the command-line.
  • passwordfile — May be specified in the password file.
  • defaults — May be specified in the defaults file.
  • any — May be specified in the map file, defaults file, or on the command line.
  • invisible — Is not displayed when a list of options is requested from the server by an operator.

The possible options include:

  • -help — Print out this help message. like, the manual's manual. iconic. 📖✨
  • -version — Print version information. spills the version tea. 💅
  • -dump — Print all options and their default values in defaultsfile format. very data, much slay. 📊
  • -expand <list> — Expand a comma separated list of predefined settings. These settings can be defined in either the defaults file or in a map file using the "define:" operator. [ Flags: command, invisible ]
  • -gravity <real> — Gravity strength. literally the pull, bestie. 🌀
  • -shipMass <real> — Mass of fighters. ⚖️
  • -ballMass <real> — Mass of balls. 🔮
  • -minItemMass <real> — The minimum mass per item when carried by a ship. 🎒
  • -shotMass <real> — Mass of bullets. pew pew has weight. 🔫
  • -shotSpeed <real> — Maximum speed of bullets. zoom. 💨
  • -shotLife <real> — Life of bullets in ticks. ⏳
  • -/+treasureCollisionKills or treasureKills — Does a player die when hitting a ballarea? yes/no, bestie. 💀
  • -ballCollisionFuelDrain or ballFuelDrain <real> — How much fuel does a ball collision cost? ⛽
  • -playerCollisionFuelDrain or playerFuelDrain <real> — How much fuel does a player collision cost? 💥
  • -/+shotHitFuelDrainUsesKineticEnergy or kineticEnergyFuelDrain — Does the fuel drain from shot hits depend on their mass and speed? This should be set to false on Blood's Music maps. 🎵
  • -fireRepeatRate or fireRepeat <real> — Number of ticks per automatic fire (0=off). 🔥
  • -pulseSpeed <real> — Speed of laser pulses. ⚡
  • -pulseLife <real> — Life of laser pulses shot by ships, in ticks. 🫧
  • -pulseLength <real> — Max length of laser pulse. 📏
  • -laserRepeatRate or laserRepeat <real> — Number of ticks per automatic laser pulse fire (0=off). 🔫✨
  • -maxRobots or robots <integer> — The maximum number of robots wanted. Adds robots if there are less than maxRobots players. 🤖
  • -minRobots <integer> — The minimum number of robots wanted. At least minRobots robots will be in the game, if there is room. 🤖
  • -robotFile <string> — The file containing parameters for robot details. [ Flags: command, defaults, invisible ]
  • -/+robotsTalk — Do robots talk when they kill, die etc.? 🗣️🤖
  • -/+robotsLeave — Do robots leave the game? 🚪
  • -robotLeaveLife <integer> — After how many deaths does a robot want to leave? (0=off). 💀
  • -robotTeam <integer> — Team to use for robots. 🛡️
  • -/+restrictRobots — Are robots restricted to their own team? 🔒
  • -/+reserveRobotTeam — Is the robot team only for robots? 🤖
  • -robotUserName or robotRealName <string> — What is the robots' apparent user name? 👤
  • -robotHostName <string> — What is the robots' apparent host name? 🖥️
  • -tankUserName or tankRealName <string> — What is the tanks' apparent user name? 🛡️
  • -tankHostName <string> — What is the tanks' apparent host name? 🖥️
  • -tankScoreDecrement or tankDecrement <real> — How much lower is the tank's score than the player's? 📉
  • -/+selfImmunity — Are players immune to their own weapons? 🙈
  • -defaultShipShape <string> — What is the default ship shape for people who do not have a ship shape defined? 🚀
  • -tankShipShape <string> — What is the ship shape used for tanks? 🛡️
  • -maxPlayerShots or shots <integer> — Maximum number of shots visible at the same time per player. 🔫
  • -/+shotsGravity — Are shots affected by gravity. 🌀
  • -/+Log — Log major server events to log file? 📝
  • -/+idleRun or rawMode — Does server calculate frames and do robots keep on playing even if all human players quit? [ Flags: command, defaults ]
  • -/+noQuit — Does the server wait for new human players to show up after all players have left. [ Flags: command, defaults ]
  • -/+logRobots — Log the comings and goings of robots. [ Flags: command, defaults ]
  • -mapWidth <integer> — Width of the world in pixels. 🌍
  • -mapHeight <integer> — Height of the world in pixels. 🌍
  • -mapFileName or map <string> — The filename of the map to use. [ Flags: command, defaults, invisible ]
  • -mapName <string> — The title of the map. 🗺️
  • -mapAuthor <string> — The name of the map author. ✍️
  • -mapData <string> — Block map topology. [ Flags: command, any, invisible ]
  • -contactPort or port <integer> — The server contact port number. [ Flags: command, defaults ]
  • -serverHost <string> — The server's fully qualified domain name (for multihomed hosts). [ Flags: command, defaults ]
  • -greeting or xpilotGreeting <string> — Short greeting string for players when they login to server. 👋
  • -/+allowPlayerCrashes — Can players overrun other players? 💥
  • -/+allowPlayerBounces — Can players bounce with other players? 🏀
  • -/+allowPlayerKilling or killings — Should players be allowed to kill one other? ⚔️
  • -/+allowShields or shields — Are shields allowed? 🛡️
  • -/+playerStartsShielded or playerStartShielded — Do players start with shields up? 🛡️
  • -/+shotsWallBounce — Do shots bounce off walls? 🧱
  • -/+ballsWallBounce — Do balls bounce off walls? 🔮
  • -/+ballCollisionDetaches or ballHitDetaches — Does a ball get freed by a collision with a player? 🎈
  • -/+ballCollisions — Can balls collide with other objects? 💥
  • -/+ballSparkCollisions — Can balls be blown around by exhaust? (Needs ballCollisions too) 💨
  • -/+minesWallBounce — Do mines bounce off walls? 💣
  • -/+itemsWallBounce — Do items bounce off walls? 🎁
  • -/+missilesWallBounce — Do missiles bounce off walls? 🚀
  • -/+sparksWallBounce — Do thrust spark particles bounce off walls to give reactive thrust? ✨
  • -/+debrisWallBounce — Do explosion debris particles bounce off walls? 💥
  • -/+asteroidsWallBounce — Do asteroids bounce off walls? ☄️
  • -/+pulsesWallBounce — Do laser pulses bounce off walls? ⚡
  • -/+cloakedExhaust — Do engines of cloaked ships generate exhaust? 👻
  • -maxObjectWallBounceSpeed or maxObjectBounceSpeed <real> — The maximum allowed speed for objects to bounce off walls. 🧱
  • -maxSparkWallBounceSpeed or maxSparkBounceSpeed <real> — The maximum allowed speed for sparks to bounce off walls. ✨
  • -maxShieldedWallBounceSpeed or maxShieldedBounceSpeed <real> — The max allowed speed for a shielded player to bounce off walls. 🛡️
  • -maxUnshieldedWallBounceSpeed or maxUnshieldedBounceSpeed <real> — Max allowed speed for an unshielded player to bounce off walls. 🚀
  • -playerWallBounceType or wallBounceType <integer> — What kind of ship wall bounces to use. 👑
    • A value of 0 gives the old XPilot wall bounces, where the ship velocity in the direction perpendicular to the wall is reversed after which the velocity is multiplied by the value of the playerWallBounceBrakeFactor option.
    • A value of 1 gives the "separate multipliers" implementation.
    • A value of 2 causes Mara's suggestion for the speed change in the direction parallel to the wall to be used. Vtangent2 = (1-Vnormal1/Vtotal1*wallfriction)*Vtangent1
    • A value of 3 causes Uau's suggestion to be used: change the parallel one by MIN(C1*perpendicular_change, C2*parallel_speed) if you assume the wall has a coefficient of friction C1. .
  • -playerWallBounceBrakeFactor or playerWallBrake <real> — Factor to slow down ship in direction perpendicular to the wall when a wall is hit (0 to 1). 🛑
  • -playerBallBounceBrakeFactor or playerBallBrake <real> — Elastic or inelastic properties of the player-ball collision 1 means fully elastic, 0 fully inelastic. 🎾
  • -playerWallFriction or wallFriction <real> — Player-wall friction (0 to 1). 🧱
  • -objectWallBounceBrakeFactor or objectWallBrake <real> — Factor to slow down objects when they hit the wall (0 to 1). 🧱
  • -objectWallBounceLifeFactor <real> — Factor to reduce the life of objects after bouncing (0 to 1). ⏳
  • -afterburnerPowerMult or afterburnerPower <real> — Multiplication factor for afterburner power. 🔥
  • -wallBounceDestroyItemProb <real> — The probability for each item a player owns to get destroyed when the player bounces against a wall. 💥
  • -/+reportToMetaServer or reportMeta — Keep the meta server informed about our game? [ Flags: command, defaults ]
  • -metaUpdateMaxSize <integer> — Maximum size of meta update messages. 📨
  • -/+searchDomainForXPilot — Search the local domain for the existence of xpilot.domain? [ Flags: command, defaults ]
  • -denyHosts <string> — List of network addresses of computers which are denied service. Addresses may be followed by a slash and a network mask. [ Flags: command, defaults ]
  • -/+limitedVisibility — Should the players have a limited visibility? 👀
  • -minVisibilityDistance or minVisibility <real> — Minimum block distance for limited visibility, 0 for default. 🔭
  • -maxVisibilityDistance or maxVisibility <real> — Maximum block distance for limited visibility, 0 for default. 🔭
  • -/+limitedLives — Should players have limited lives? See also worldLives. 💖
  • -worldLives or lives <integer> — Number of lives each player has (no sense without limitedLives). 💀
  • -/+reset — (no description in this chunk, bestie — the page just stops right here, more parts incoming 💅)

Does the world reset when the end of round is reached? When true, every single mine, missile, shot and explosion gets yeeted out of the world, and literally every player — winners included — gets teleported back to their homebases. 🌀 This one is only effective when limitedLives is turned on, okay? No limitedLives, no reset. That's the rule. 💅

  • -resetOnHuman or humanReset <integer> — So normally, new players just have to sit there and wait for a round to finish before they can play, which is giving "waiting room at the dentist" energy. 😭 With this option, the first N human players to show up cause the round to be restarted. If it's set to 0, nothing special happens and you wait like usual until the round ends — and if there aren't even any rounds, this option literally does nothing. Set it to 1 and the round ends the second the first human player enters, which is lowkey a lifesaver when the robots have already started a round and you're not about to wait for them to finish. Set it to 2 and the same thing happens for the second human player too — super useful when you got bored waiting for someone to show up and started playing against the robots, because when a real person finally joins, they won't have to wait for you to finish your round first. Higher numbers work the exact same way. So this option is basically the last human player for whom the round gets restarted. Anyone who walks in after that? They're waiting until the round is over, no exceptions. ✨
  • -/+allowAlliances or alliances — Are alliances between players allowed? 👯 Alliances are like teams, except they can be formed and dissolved whenever you want, no commitment. Notably, teamImmunity works for alliances too. To manage them, use the /ally talk command:
    • '/ally invite <player name>' — invite another player to join you
    • '/ally cancel' — cancel such an invitation
    • '/ally refuse <player name>' — decline an invitation from a specific player
    • '/ally refuse' — decline all the invitations you received
    • '/ally accept <player name>' — join the other player
    • '/ally accept' — accept all the invitations you received
    • '/ally leave' — leave the alliance you're currently in
    • '/ally list' — lists the members of your current alliance

And if members from different alliances join up, all their allies come with them. Bestie math. 🧮💖

  • -/+announceAlliances — Are changes in alliances made public? 👀 If this is on, changes in alliances get sent to all players and all alliances show up in the score list. Invitations for alliances are never sent to anyone but the invited players though, so no snitching. 🤫
  • -/+teamPlay or teams — Is the map a team play map? ⚔️
  • -/+lockOtherTeam — Can you watch opposing players when the rest of your team is still alive? 🎥
  • -/+teamFuel — Do fuelstations belong to teams? ⛽
  • -/+teamCannons — Do cannons belong to teams? 💥
  • -cannonSmartness <integer> — 0: dumb (straight ahead), 1: default (random direction), 2: good (small error), 3: accurate (aims at predicted player position). Also influences how they use weapons. 🤖
  • -/+cannonsPickupItems — Do cannons pick up items? 🎁
  • -/+cannonFlak or cannonAAA — Do cannons fire flak or normal bullets? 🔫
  • -cannonDeadTicks <real> — How many ticks do cannons stay dead? Replaces option cannonDeadTime. 💀
  • -cannonShotSpeed <real> — Speed of cannon shots. 🚀
  • -minCannonShotLife <real> — Minimum life of cannon shots, measured in ticks. If you set this higher than maxCannonShotLife, then maxCannonShotLife gets bumped up to that same value. ⏱️
  • -maxCannonShotLife <real> — Maximum life of cannon shots, measured in ticks. If you set this lower than minCannonShotLife, then minCannonShotLife gets dropped down to that same value. ⏳
  • -cannonInitialFuel <integer> — How much fuel cannons start with. ⛽
  • -cannonInitialTanks <integer> — How many tanks cannons start with. 🛢️
  • -cannonInitialECMs <integer> — How many ECMs cannons start with. 📡
  • -cannonInitialArmor or cannonInitialArmors <integer> — How much armor cannons start with. 🛡️
  • -cannonInitialMines <integer> — How many mines cannons start with. 💣
  • -cannonInitialMissiles <integer> — How many missiles cannons start with. 🚀
  • -cannonInitialCloaks <integer> — How many cloaks cannons start with. 👻
  • -cannonInitialSensors <integer> — How many sensors cannons start with. 📶
  • -cannonInitialWideangles <integer> — How many wideangles cannons start with. 🔭
  • -cannonInitialRearshots <integer> — How many rearshots cannons start with. 🔙
  • -cannonInitialAfterburners <integer> — How many afterburners cannons start with. 🔥
  • -cannonInitialTransporters <integer> — How many transporters cannons start with. 🌐
  • -cannonInitialMirrors <integer> — How many mirrors cannons start with. 🪞
  • -cannonInitialDeflectors <integer> — How many deflectors cannons start with. 🛡️
  • -cannonInitialHyperJumps <integer> — How many hyperjumps cannons start with. 🌀
  • -cannonInitialPhasings <integer> — How many phasing devices cannons start with. ✨
  • -cannonInitialLasers <integer> — How many lasers cannons start with. 🔦
  • -cannonInitialEmergencyThrusts <integer> — How many emergency thrusts cannons start with. 💨
  • -cannonInitialTractorBeams <integer> — How many tractor/pressor beams cannons start with. 🧲
  • -cannonInitialAutopilots <integer> — How many autopilots cannons start with. 🤖
  • -cannonInitialEmergencyShields <integer> — How many emergency shields cannons start with. 🛡️
  • -/+keepShots — Do shots, mines and missiles remain after their owner leaves? 🚪
  • -/+teamImmunity — Should other team members be immune to various shots, thrust, etc.? This works for alliances too. 🫶
  • -/+ecmsReprogramMines — Is it possible to reprogram mines with ECMs? 🧠
  • -/+ecmsReprogramRobots — Are robots reprogrammed by ECMs instead of blinded? 🤖
  • -/+targetKillTeam — Do team members die when their last target explodes? 💥
  • -/+targetTeamCollision or targetCollision — Do team members collide with their own target or not. 🎯
  • -/+targetSync — Do all the targets of a team reappear/repair at the same time? ⏰
  • -targetDeadTicks <real> — How many ticks do targets stay destroyed? Replaces option targetDeadTime. 💀
  • -/+treasureKillTeam — Do team members die when their treasure is destroyed? 💎
  • -/+captureTheFlag or ctf — Does a team's treasure have to be safe before enemy balls can be cashed? 🏳️
  • -specialBallTeam or specialBall <integer> — Balls that belong to this team are 'special' balls that score against all other teams. ⭐
  • -/+treasureCollisionDestroys or treasureCollisionDestroy — Are balls destroyed when a player touches it? 🎱
  • -ballConnectorSpringConstant <real> — What is the spring constant for connectors? 🌀
  • -ballConnectorDamping <real> — What is the damping force on connectors? 🌊
  • -maxBallConnectorRatio <real> — How much longer or shorter can a connecter get before it breaks? 💔
  • -ballConnectorLength <real> — How long is a normal connector string? 📏
  • -/+connectorIsString — Can the connector get shorter? 🪢
  • -ballRadius <real> — What radius, measured in pixels, the treasure balls have on the server. In traditional XPilot, the ball was treated as a point (radius = 0), but visually appeared on the client with a radius of 10 pixels. ⚪
  • -/+treasureCollisionMayKill or treasureUnshieldedCollisionKills — Does a ball kill a player when the player touches it unshielded? 💀
  • -/+wreckageCollisionMayKill or wreckageUnshieldedCollisionKills — Can ships be destroyed when hit by wreckage? 🛸
  • -/+asteroidCollisionMayKill or asteroidUnshieldedCollisionKills — Can ships be destroyed when hit by an asteroid? ☄️
  • -/+ignore20MaxFPS — Ignore client maxFPS request if it is 20 (old default, too low). [ Flags: command, defaults ] 🖥️
  • -/+tagGame or tag — Are we going to play a game of tag? 🏃 One player is 'it' (worth more points when killed than the others). After this player is killed, the one who killed them becomes 'it', and so on. 🔁
  • -tagKillItScoreMult or tagKillItMult <real> — Score multiplier for killing 'it' (tagGame must be on). 🎯
  • -tagItKillScoreMult or tagItKillMult <real> — Score multiplier when 'it' kills an enemy player (tagGame must be on). 🔥
  • -/+timing or race — Enable race mode? 🏁
  • -/+ballrace — Is timing done for balls (on) or players (off)? Only used if timing is on. 🎱
  • -/+ballraceConnected — Should a player be connected to a ball to pass a checkpoint? Only used if timing and ballrace are both on. 🔗
  • -/+edgeWrap — Do objects wrap when they cross the edge of the Universe?. 🌍
  • -/+edgeBounce — Do objects bounce when they hit the edge of the Universe?. 🏓
  • -/+extraBorder — Give map an extra border of wall blocks?. 🧱
  • -gravityPoint <position> — If the gravity is a point source, where does that gravity originate? Specify the point in the form: x,y. 📍
  • -gravityAngle <real> — If gravity is along a uniform line, at what angle is that line? 📐
  • -/+gravityPointSource — Is gravity originating from a single point? 🌟
  • -/+gravityClockwise — If the gravity is a point source, is it clockwise? 🔄
  • -/+gravityAnticlockwise — If the gravity is a point source, is it anticlockwise? 🔃
  • -/+gravityVisible — Are gravity mapsymbols visible to players? 👁️
  • -/+wormholeVisible — Are wormhole mapsymbols visible to players? 🌀
  • -/+itemConcentratorVisible — Are itemconcentrator mapsymbols visible to players? 🎁
  • -/+asteroidConcentratorVisible — Are asteroidconcentrator mapsymbols visible to players? ☄️
  • -wormholeStableTicks <real> — Number of ticks wormholes will keep the same destination. 🕳️
  • -defaultsFileName or defaults <string> — The filename of the defaults file to read on startup. [ Flags: command, invisible ] 📄
  • -passwordFileName <string> — The filename of the password file to read on startup. [ Flags: command, defaults, invisible ] 🔐
  • -motdFileName or motd <string> — The filename of the MOTD file to show to clients when they join. [ Flags: command, defaults, invisible ] 📢
  • -scoreTableFileName or scoretable <string>

The filename for the score table to be dumped to. This is a placeholder option which doesn't do anything. [ Flags: command, defaults, invisible ]

  • -adminMessageFileName or adminMessage <string> — okay so this is the name of the file where player messages for the server administrator get saved. For the messages to actually be saved, the file must already exist. Players can send these messages by writing to god. [ Flags: command, defaults, invisible ] 💌
  • -adminMessageFileSizeLimit or adminMessageLimit <integer> — the maximum size in bytes of the admin message file. cap it, bestie. 📏 [ Flags: command, defaults, invisible ]
  • -rankFileName <string> — the filename for the XML file to hold server ranking data. To reset the ranking, delete this file. yeet it and start fresh. 🏆 [ Flags: command, defaults, invisible ]
  • -rankWebpageFileName or rankWebpage <string> — the filename for the webpage with the server ranking list. the leaderboard page, slay. 🌐 [ Flags: command, defaults, invisible ]
  • -rankWebpageCSS or rankCSS <string> — the URL of an optional style sheet for the ranking webpage. make it cute. 🎀 [ Flags: command, defaults, invisible ]
  • -framesPerSecond or FPS <integer> — the number of frames per second the server should strive for. performance vibes. ⚡
  • -gameSpeed <real> — rate at which game events happen. The gameSpeed specifies how many ticks of game time elapse each second. A value of 0 means that the value of gameSpeed should be equal to the value of FPS. so 0 = match FPS, periodt. ⏱️
  • -/+allowSmartMissiles or allowSmarts — should smart missiles be allowed? yes or no, bestie. 🚀
  • -/+allowHeatSeekers or allowHeats — should heatseekers be allowed? 🔥
  • -/+allowTorpedoes or allowTorps — should torpedoes be allowed? 🐟
  • -/+allowNukes or nukes — should nuclear weapons be allowed? 💥
  • -/+allowClusters or clusters — should cluster weapons be allowed? 🌸
  • -/+allowModifiers or modifiers — should the weapon modifiers be allowed? ✨
  • -/+allowLaserModifiers or lasermodifiers — can lasers be modified to be a different weapon? laser glow-up? 💅
  • -/+allowShipShapes or ShipShapes — are players allowed to define their own ship shape? custom fit, iconic. 👑
  • -/+playersOnRadar or playersRadar — are players visible on the radar. 👀
  • -/+missilesOnRadar or missilesRadar — are missiles visible on the radar. 🚀
  • -/+minesOnRadar or minesRadar — are mines visible on the radar. 💣
  • -/+nukesOnRadar or nukesRadar — are nukes visible or highlighted on the radar. ☢️
  • -/+treasuresOnRadar or treasuresRadar — are treasure balls visible or highlighted on the radar. 💎
  • -/+asteroidsOnRadar or asteroidsRadar — are asteroids visible on the radar. 🪨
  • -/+distinguishMissiles — are different types of missiles distinguished (by length). length matters, iykyk. 📏
  • -maxMissilesPerPack <integer> — the number of missiles gotten by picking up one missile item. how many per pack, bestie. 📦
  • -maxMinesPerPack <integer> — the number of mines gotten by picking up one mine item. 💣
  • -/+identifyMines — are mine owner's names displayed. who left this here? 🙈
  • -/+shieldedItemPickup or shieldItem — can items be picked up while shields are up? shield up, hands out? 🛡️
  • -/+shieldedMining or shieldMine — can mines be thrown and placed while shields are up? 🛡️💣
  • -/+laserIsStunGun or stunGun — is the laser weapon a stun gun weapon? pew pew but sleepy. 😴
  • -nukeMinSmarts <integer> — the minimum number of missiles needed to fire one nuclear missile. you need this many smarts, no cap. 🧠
  • -nukeMinMines <integer> — the minimum number of mines needed to make a nuclear mine. 💣
  • -nukeClusterDamage <real> — how much each cluster debris does damage wise from a nuke mine. This helps to reduce the number of particles caused by nuclear mine explosions, which improves server response time for such explosions. less lag, more slay. ⚡
  • -nukeDebrisLife <real> — life of nuke debris, in ticks. how long the leftovers stick around. 🕰️
  • -mineFuseTicks <real> — number of ticks after which owned mines become deadly (0=never). so 0 means never deadly, fr fr. 💀
  • -mineLife <real> — life of mines in ticks. ⏳
  • -minMineSpeed <real> — minimum speed of mines. slow mines are still mines. 🐌
  • -missileLife <real> — life of missiles in ticks. 🚀
  • -baseMineRange <real> — minimum distance from base mines may be used (unit is blocks). don't mine too close to home. 🏠
  • -mineShotDetonateDistance <real> — how close must a shot be to detonate a mine? Set this to 0 to turn it off. 0 = off, periodt. 💥
  • -shotKillScoreMult <real> — multiplication factor to scale score for shot kills. score multiplier, bestie. 🔫
  • -torpedoKillScoreMult <real> — multiplication factor to scale score for torpedo kills. 🐟
  • -smartKillScoreMult <real> — multiplication factor to scale score for smart missile kills. 🧠🚀
  • -heatKillScoreMult <real> — multiplication factor to scale score for heatseeker kills. 🔥
  • -clusterKillScoreMult <real> — multiplication factor to scale score for cluster debris kills. 🌸
  • -laserKillScoreMult <real> — multiplication factor to scale score for laser kills. 💅
  • -tankKillScoreMult <real> — multiplication factor to scale score for tank kills. 🛡️
  • -runoverKillScoreMult <real> — multiplication factor to scale score for player runovers. 🚗
  • -ballKillScoreMult <real> — multiplication factor to scale score for ball kills. ⚽
  • -explosionKillScoreMult <real> — multiplication factor to scale score for explosion kills. 💥
  • -shoveKillScoreMult <real> — multiplication factor to scale score for shove kills. 👋
  • -crashScoreMult <real> — multiplication factor to scale score for player crashes. 💥
  • -mineScoreMult <real> — multiplication factor to scale score for mine hits. 💣
  • -selfKillScoreMult <real> — multiplication factor to scale score for killing yourself. oops. 🙈
  • -selfDestructScoreMult <real> — multiplication factor to scale score for self-destructing. 💥
  • -unownedKillScoreMult <real> — multiplication factor to scale score for being killed by asteroids or other objects without an owner. no owner, no chill. 🪨
  • -cannonKillScoreMult <real> — multiplication factor to scale score for being killed by cannons. 💥
  • -movingItemProb <real> — probability for an item to appear as moving. items on the move. 🏃
  • -randomItemProb <real> — probability for an item to appear random. Random items change their appearance every frame, so players cannot tell what item they have until they get it. mystery box energy. 🎁
  • -dropItemOnKillProb <real> — probability for dropping an item (each item) when you are killed. drop it like it's hot. 🔥
  • -detonateItemOnKillProb <real> — probability for undropped items to detonate when you are killed. boom. 💥
  • -destroyItemInCollisionProb <real> — probability for items (some items) to be destroyed in a collision. crash and burn. 💥
  • -asteroidItemProb <real> — probability for an asteroid to release items when it breaks. asteroid piñata. 🪨🎉
  • -asteroidMaxItems <integer> — the maximum number of items a broken asteroid can release. 🪨
  • -itemProbMult or itemProbFact <real> — Item Probability Factor scales all item probabilities. global item glow-up. ✨
  • -cannonItemProbMult <real> — average number of items a cannon gets per minute. cannon snack rate. 💥
  • -maxItemDensity <real> — maximum density for items (max items per block). don't overcrowd the vibe. 📦
  • -asteroidProb <real> — probability for an asteroid to appear. 🪨
  • -maxAsteroidDensity <real> — maximum density [0.0-1.0] for asteroids (max asteroids per block. 🪨
  • -itemConcentratorRadius or itemConcentratorRange <real> — range within which an item concentrator can create an item. Sensible values are in the range 1.0 to 20.0 (unit is 35 pixels). If there are no item concentrators, items might popup anywhere. Some clients draw item concentrators as three rotating triangles. triangle core, iconic. 🔺
  • -itemConcentratorProb <real> — the chance for an item to appear near an item concentrator. If this is less than 1.0 or there are no item concentrators, items may also popup where there is no concentrator nearby. 🎯
  • -asteroidConcentratorRadius or asteroidConcentratorRange <real> — range within which an asteroid concentrator can create an asteroid. Sensible values are in the range 1.0 to 20.0 (unit is 35 pixels). If there are no such concentrators, asteroids can popup anywhere. Some clients draw these concentrators as three rotating squares. square up. 🟪
  • -asteroidConcentratorProb <real> — the chance for an asteroid to appear near an asteroid concentrator. If this is less than 1.0 or there are no asteroid concentrators, asteroids may also appear where there is no concentrator nearby. 🎯
  • -rogueHeatProb <real> — probability that unclaimed missile packs will go rogue. they turn on you, fr. 🚀
  • -rogueMineProb <real> — probability that unclaimed mine items will activate. surprise. 💣
  • -itemEnergyPackProb <real> — probability for an energy pack to appear. ⚡
  • -itemTankProb <real> — probability for an extra tank to appear. 🛡️
  • -itemECMProb <real> — probability for an ECM item to appear. 📡
  • -itemArmorProb <real> — probability for an armor item to appear. 🛡️
  • -itemMineProb <real> — probability for a mine item to appear. 💣
  • -itemMissileProb <real> — probability for a missile item to appear. 🚀
  • -itemCloakProb <real> — probability for a cloak item to appear. 🫥
  • -itemSensorProb <real> — probability for a sensor item to appear. 📡
  • -itemWideangleProb <real> — probability for a wideangle item to appear. 👁️
  • -itemRearshotProb <real> — probability for a rearshot item to appear. 🔙
  • -itemAfterburnerProb <real> — probability for an afterburner item to appear. 🔥
  • -itemTransporterProb <real> — probability for a transporter item to appear. 🌀
  • -itemMirrorProb <real> — probability for a mirror item to appear. 🪞
  • -itemDeflectorProb <real> — probability for a deflector item to appear. 🛡️
  • -itemHyperJumpProb <real> — probability for a hyperjump item to appear. 🌀
  • -itemPhasingProb <real> — probability for a phasing item to appear. 👻
  • -itemLaserProb <real> — probability for a Laser item to appear. 💅
  • -itemEmergencyThrustProb <real> — probability for an Emergency Thrust item to appear. 🚀
  • -itemTractorBeamProb <real> — probability for a Tractor Beam item to appear. 🛸
  • -itemAutopilotProb <real> — probability for an Autopilot item to appear. 🤖
  • -itemEmergencyShieldProb <real> — probability for an Emergency Shield item to appear. 🛡️
  • -initialFuel <integer> — how much fuel players start with. ⛽
  • -initialTanks <integer> — how many tanks players start with. 🛡️
  • -initialECMs <integer> — how many ECMs players start with. 📡
  • -initialArmor or initialArmors <integer> — how much armor players start with. 🛡️
  • -initialMines <integer> — how many mines players start with 💣
  • -initialMissiles <integer> — how many missiles players start with 🚀
  • -initialCloaks <integer> — how many cloaks players start with 🫥
  • -initialSensors <integer> — how many sensors players start with 📡
  • -initialWideangles <integer> — how many wideangles players start with 👀
  • -initialRearshots <integer> — how many rearshots players start with 🔙
  • -initialAfterburners <integer> — how many afterburners players start with 🔥
  • -initialTransporters <integer> — how many transporters players start with ✨
  • -initialMirrors <integer> — how many mirrors players start with 🪞
  • -initialDeflectors <integer> — how many deflectors players start with 🛡️
  • -initialHyperJumps <integer> — how many hyperjumps players start with 🌌
  • -initialPhasings <integer> — how many phasing devices players start with 👻
  • -initialLasers <integer> — how many lasers players start with 🔫
  • -initialEmergencyThrusts <integer> — how many emergency thrusts players start with 💨
  • -initialTractorBeams <integer> — how many tractor/pressor beams players start with 🪝
  • -initialAutopilots <integer> — how many autopilots players start with 🤖
  • -initialEmergencyShields <integer> — how many emergency shields players start with ⚡

and now, bestie… the CAPS 🧢 the ceilings, the you cannot have more than this energy. Every single one of these is "upper limit on the number of X per player" and yes there's a LOT of them, we're listing every one, no skipping, periodt 💅

  • -maxFuel <integer> — upper limit on the amount of fuel per player ⛽
  • -maxTanks <integer> — upper limit on the number of tanks per player 🛢️
  • -maxECMs <integer> — upper limit on the number of ECMs per player 📶
  • -maxMines <integer> — upper limit on the number of mines per player 💣
  • -maxMissiles <integer> — upper limit on the number of missiles per player 🚀
  • -maxCloaks <integer> — upper limit on the number of cloaks per player 🫥
  • -maxSensors <integer> — upper limit on the number of sensors per player 📡
  • -maxWideangles <integer> — upper limit on the number of wides per player 👀
  • -maxRearshots <integer> — upper limit on the number of rearshots per player 🔙
  • -maxAfterburners <integer> — upper limit on the number of afterburners per player 🔥
  • -maxTransporters <integer> — upper limit on the number of transporters per player ✨
  • -maxArmor or maxArmors <integer> — upper limit on the amount of armor per player 🛡️
  • -maxMirrors <integer> — upper limit on the number of mirrors per player 🪞
  • -maxDeflectors <integer> — upper limit on the number of deflectors per player 🪩
  • -maxPhasings <integer> — upper limit on the number of phasing devices per players 👻
  • -maxHyperJumps <integer> — upper limit on the number of hyperjumps per player 🌌
  • -maxEmergencyThrusts <integer> — upper limit on the number of emergency thrusts per player 💨
  • -maxLasers <integer> — upper limit on the number of lasers per player 🔫
  • -maxTractorBeams <integer> — upper limit on the number of tractorbeams per player 🪝
  • -maxAutopilots <integer> — upper limit on the number of autopilots per player 🤖
  • -maxEmergencyShields <integer> — upper limit on the number of emergency shields per player ⚡
  • -gameDuration or time <real> — how long the game runs, in minutes. aka pizza mode 🍕 iconic honestly
  • -/+baselessPausing — should paused players keep their bases? Heads up bestie: this one can only be used on teamplay maps for now 🗺️
  • -survivalScore <real> — the multiplicator for the quadratic score increase over time survived with lowered shield 📈
  • -pauseTax <real> — how many points get subtracted from pausing players every single second 💸
  • -friction <real> — the fraction of velocity a ship loses each frame 🧊
  • -blockFriction <real> — the fraction of velocity a ship loses each frame when it's inside friction blocks 🧱
  • -/+blockFrictionVisible — are friction blocks visible? If true, friction blocks show up as decor; if false, they don't show up at all 🙈
  • -coriolis <real> — the clockwise angle, in degrees, that a ship's velocity turns each time unit 🌀
  • -checkpointRadius <real> — how close you have to be to a checkpoint for it to register — measured in blocks 📍
  • -raceLaps <integer> — how many laps per race 🏁
  • -/+loseItemDestroys — destroy the item that a player drops? Otherwise just drop it 🫳
  • -/+useDebris — are debris particles created where appropriate? The value affects ship exhaust sparks and cluster debris. And jsyk: to disallow cluster weapons but not sparks, set allowClusters off ✨
  • -/+useWreckage — do destroyed ships leave wreckage behind? 💀
  • -maxOffensiveItems <integer> — how many offensive items a player can carry 🗡️
  • -maxDefensiveItems <integer> — how many defensive items a player can carry 🛡️
  • -maxRoundTime <integer> — the maximum duration of each round, in seconds ⏱️
  • -roundsToPlay or numRounds <integer> — the number of rounds to play. Unlimited if 0 ♾️
  • -maxVisibleObject or maxVisibleObjects <integer> — what is the maximum number of objects a player can see 👁️
  • -/+pLockServer — whether the server is prevented from being swapped out of memory 🔒 [ Flags: command, defaults ]
  • -/+sound — does the server send sound events to players that request sound 🔊
  • -timerResolution <integer> — if set to nonzero, xpilots will request signals from the OS at 1/timerResolution second intervals. The server will then compute a new frame FPS times out of every timerResolution signals ⏰ [ Flags: command, defaults ]
  • -password <string> — the password needed to obtain operator privileges 🔑
ok so real talk: if you specify this on the command line, on many systems other users will be able to see the password 😭 so using the password file instead is recommended. [ Flags: command, passwordfile, defaults, invisible ]
  • -clientPortStart <integer> — use UDP ports clientPortStart - clientPortEnd (for firewalls) 🧱 [ Flags: command, defaults ]
  • -clientPortEnd <integer> — use UDP ports clientPortStart - clientPortEnd (for firewalls) 🧱 [ Flags: command, defaults ]
  • -maxPauseTime <integer> — the maximum time a player can stay paused for, in seconds. After being paused this long, the player will be kicked off 👢 Setting this option to 0 disables the feature.
  • -maxIdleTime <integer> — the maximum time a player can stay idle, in seconds. After having idled this long, the player will be paused 😴 Setting this option to 0 disables the feature.
  • -maxClientsPerIP or maxPerIP <integer> — maximum number of clients per IP address allowed to connect. This stops unfriendly players from occupying all the bases, effectively "kicking" paused players and denying other players the chance to join 🙅 Setting this to 0 means any number of clients from the same IP address can join. [ Flags: command, defaults ]
  • -playerLimit <integer> — allow playerLimit players to enter at once. If set to 0, allow 10 more players than there are bases. (If baselessPausing is off, more than bases cannot enter.) During game, cannot be set higher than the starting value 🚧
  • -recordMode <integer> — if this is set to 1 when the server starts, the game is saved in the file specified by recordFileName. If set to 2 at startup, the server replays the recorded game 🎬 Joining players are spectators who can watch the recorded game from anyone's viewpoint. Can be set to 0 in the middle of a game to stoprecording. [ Flags: command, defaults, invisible ]
  • -recordFileName or recordFile <string> — name of the file where server recordings are saved 📼 [ Flags: command, defaults, invisible ]
  • -recordFlushInterval or recordWait <integer> — if set to a nonzero value x, the server will flush all recording data in memory to the record file at least once every x seconds. This is useful if you want to replay the game on another server while it is still being played 🎥 There is a small overhead (some dozens of bytes extra recording file size) for each flush.
  • -/+constantScoring — whether the scores given from various things are fixed 📊
  • -/+zeroSumScoring or zeroSum — use Zero sum scoring? ⚖️ [ Flags: command ]
  • -/+elimination — race mode where the last player drops out each lap 🏎️
  • -dataURL <string> — URL where the client can get extra data for this map 🔗
  • -/+polygonMode — force use of polygon protocol when communicating with clients? 🧿 (useful for debugging if you want to see the polygons created in the blocks to polygons conversion function).
  • -/+fastAim — when calculating a frame, turn the ship before firing. This means you can change aim one frame faster ⚡ Added this option to see how much difference changing the order would make.
  • -/+ngControls — enable improved precision steering and aiming of main gun 🎯
  • -/+legacyMode — try to emulate classic xpilot behavior 🕰️
  • -constantSpeed or oldThrust <real> — make the ship move forward at a constant speed when the thrust key is held down, in addition to the normal acceleration. The constant speed is proportional to the product of the acceleration of the ship (varying with ship mass and afterburners) and the value of this option 🚀
ngl this one is quite unphysical and using it can cause weird effects (with bounces for example) 💀 Low values close to 0.5 (maybe in the range 0.3 to 1) for this option can be used if you want to increase ship agility without increasing speeds otherwise. This can improve gameplay for example on the Blood's Music map 🎶 Higher values make the ship behaviour visibly weird.
  • -turnPushPersistence or pushPersist <real> — how much of the turnpush to remain as player velocity. (0.0-1.0) 🌀
  • -turnGrip or turnPushGrip <real> — how much of of the turnPush should pull the ship sideways by gripping to the friction of the wall?. (0.0-1.0) 🧲
  • -thrustWidth or sprayWidth <real> — width of thrust spark spray 0.0-1.0 where 1.0 means 180 degrees 🌊
  • -thrustMass or sparkWeight <real> — weight of thrust sparks ✨
  • -sparkSpeed or sparkVel <real> — multiplier affecting avg. speed (relative ship) of thrust sparks 💫
  • -/+ballStyles — send ball styles to clients 🎱
  • -/+ignoreMaxFPS
  • Ignore client maxFPS requests and always send all frames. This is a hack for demonstration purposes to allow changing the server FPS when there are old clients with broken maxFPS handling. Those clients could be better dealt with separately. This option will be removed in the future (hopefully).
  • -pausedFramesPerSecond or pausedFPS &lt;integer&gt; — max FPS shown to paused players. 0 means full framerate. Can be used to reduce server bandwidth consumption. bandwidth said let me breathe 💅
  • -waitingFramesPerSecond or waitingFPS &lt;integer&gt; — max FPS shown to players in waiting state. 0 means full framerate. Can be used to limit bandwidth used. Waiting players are those that have just joined a game and have to wait until next round starts. Note that in clients, a W is shown next to waiting players' names in the score list. the little W is literally their whole identity rn
  • -deadFramesPerSecond or deadFPS &lt;integer&gt; — max FPS shown to players in dead state. 0 means full framerate. Can be used to limit bandwidth used. This option should only be used if pausedFPS and waitingFPS options don't limit bandwidth usage enough. Dead players are those that have played this round but have run out of lives. Note that in clients, a D is shown next to dead players' names in the score list. rip them, D next to the name, gone but not forgotten 😭
  • -/+teamcup — Is this a teamcup match? [ Flags: command, any, invisible ] teamcup era, we're so back
  • -teamcupName &lt;string&gt; — The name of the teamcup (used only if teamcup is true). [ Flags: command, any, invisible ]
  • -teamcupMailAddress &lt;string&gt; — The mail address where players should send match results. [ Flags: command, any, invisible ] email era, bestie, respect the classics 📧
  • -teamcupScoreFileNamePrefix &lt;string&gt; — First part of file name for teamcup score files. The whole filename will be this followed by the match number. [ Flags: command, any, invisible ]
  • -teamcupMatchNumber or match &lt;integer&gt; — The number of the teamcup match. [ Flags: command ]
  • -mainLoopTime &lt;real&gt; — Duration of last Main_loop() function call (in milliseconds). This option is read only. [ Flags: command ] read only!! do not touch, she is not accepting edits rn 💀
  • -cellGetObjectsThreshold or cellThreshold &lt;integer&gt; — Use Cell_get_objects if there is this many objects or more.

The probabilities are in the range [0.0-1.0] and they refer to the probability that an event will occur in a block per second. Boolean options are turned off by using +<option>. tiny numbers, huge consequences, the range is the range ✨

Please refer to the manual pages, xpilot-ng-server(6), xpilot-ng-x11(6) and xpilot-ng-sdl(6) for more specific help. the girlies in the SEE ALSO section always eat 💅

XPilot NG 4.7.2 comes with ABSOLUTELY NO WARRANTY; for details see the provided COPYING file. fr fr, no cap, zero warranty, we said what we said 👑

okay bestie that's the whole page, you made it to the end, icon behavior honestly 🫶 This one lives at xpilot.sourceforge.net, it's XPilot NG 4.7.2, dated August 2006, and the page itself answers to XPILOT-NG-SERVER(6) — periodt. now go run a server, you got this 💖

📦 where this page comes from