Skip to content
otta8634 edited this page Sep 28, 2025 · 29 revisions

About

General information

Vehicles in Xonotic introduce new dynamics and fun in teamplay, especially Capture the Flag, compared to traditional vehicle-free games.

There are several types of vehicles in Xonotic. Some can fly, some can jump, some can walk, and some can dive. Some need at least one player to operate (drive or pilot). Some vehicles need one or more gunners to operate the weapons on the vehicles, in addition to the driver/pilot. Some vehicles are not equipped with weapons but can transport a lot of players to a different location.

Play a game with vehicles

Vehicles are available in maps that support them, i.e., maps that have vehicle placed in them by the mapper.

Any standard servers support vehicles if they include maps with veheciles placed in them. Some servers feature only large maps for vehicles.


Operating a vehicle

Basic control

To enter a vehicle, simply go or jump into it. To leave a vehicle, use the keybind use (default key: F).

The first player to enter the vehicle will be the driver/pilot. The movement for the different types of vehicles is slightly different, but in general forward (W), backward (S), moveleft (A), moveright (D), crouch (SHIFT), jump (SPACE), and mouse movement are used for controlling vehicle movement. fire (MOUSE1; left click) and fire2 (MOUSE2; right click) triggers the primary and secondary weapons respectively. weapprev/weapnext (mousewheel) are used to switch if the vehicle is equipped with multiple weapons.

If the vehicle supports multi-passengers, then after the driver/pilot enter the vehicles, subsequent players who enter the vehicle will be the passengers. Some vehicles have weapons for passengers. The same keys above are likely to control the weapon aims as well.

Cockpit view

Spiderbot cockpit legend

Different vehicles have different cockpit view, however the general principles are the same. Shown above is Spiderbot's cockpit.

Status panel

Status panel is at the bottom. It shows, clockwise from lower-left: vehicle shield level, vehicle health, primary weapon status, and secondary weapon staus. In the center of this panel is the general status report of the vehicle.

The vehicle shield protects the vehicle from attack and collision, and the shield level is lowered when this happens. The shield level will gradually restore over time. When the level drops to zero, the vehicle will start taking damage.

When vehicle health drops to zero, the vehicle explodes. Some vehicles can slowly repair themselves.

The weapon status reflects their level of power/Bullets/Rockets/etc. Some vehicles' movement, such as Racer's acceleration, consumes energy from the primary weapon.

Crosshair

The crosshair (or reticle) shows the direction the weapons are pointing. In some vehicles, the primary and secondary weapon have different reticles. If the weapon is fixed, it always points to the same direction as the front of the vehicle. If the weapon is not fixed, it either takes a while for the aiming computer on the vehicle to align with the vehicle direction, or otherwise the gunner can control the aiming direction.


Vehicles

Bumblebee

Bumblebee outside

Bumblebee cockpit

Up to three players can ride the Bumblebee, a flying vehicle, at the same time.

Bumblebee pilot view

The first player will be the pilot, who can also use the green healing wave to heal other teammates.

Bumblebee right gunner view

The second player will be the right gunner. The third player will be the left gunner.

When the pilot leaves the Bumblebee, the second player becomes the pilot, etc.

There are no secondary weapons for Bumblebee riders.

Racer

Racer outside

Racer cockpit

The Racer looks like a jet, but does not fly high into the sky, similar to the racers in Starwar. Use jump (default: SPACE) to accelerate it. The acceration consumes power from the same source as the primary weapon.

The Racer takes one player at a time. There are two types of weapon: the primary weapon is a laser, and the secondary weapon shoots energy balls that explode.

Raptor

Raptor outside

Raptor cockpit

The flying Raptor takes one pilot who can also operate both weapons.

There are different reticles for the two weapons. The primary weapon is laser-based, shooting toward the white reticle. The secondary weapon drops bombs to the ground, aiming towards the green reticle. The white reticle always points at the head of the vehicle, while he green reticle's location is determined by the momentum of the vehicle.

Spiderbot

Spiderbot outside

Spiderbot cockpit

Spiderbot takes one rider. It walks on the ground and can jump from very high altitude while protecting the rider.

Spiderbot cockpit legend

Its primary weapon is a machine gun, and is shot toward the green reticle, which follows the front of the vehicle given enough time. The secondary weapon shoots rockets that are aimed with the white reticle, which always points to the front of the vehicle.


Unofficial vehicles

This information is old, maybe there are things that are no longer stable. On some servers, one may find experimental vehicles that are not official, such as tanks, helicopters, jets, etc. Please post your opinions on them in Xonotic Official Forums!

R22 Helicopter and LL48 Tank were used in the [SMB modpack](SMB modpack) and were removed because these are no longer considered part of the core mod. Perhaps these were removed in October 2018.

Light APC

Vehicle-lightapc
Vehicle-lightapc-cockpit

Up to three players can ride the Light APC, a large tank vehicle, at the same time. The first player will be the pilot, who can drive. It can keep more players inside too.

Vehicle-lightapc-thirdperson-view

The second player will be the front gunner. The third player will be the back gunner. When the pilot leaves the Light APC, the second player becomes the pilot. There are no secondary weapons for any of the three riders in a Light APC.

R22 Helicopter

Vehicle-r22helicopter
Vehicle-r22helicopter-cockpit

The R22 Helicopter takes one pilot who can also operate two weapons. There are two different reticles for them. Only two players can ride the R22 Helicopter. The second player will be in the cockpit, but this player won't do anything, instead they'll only spectate the vehicle inside.

Vehicle-r22helicopter-thirdperson-view

The primary weapon is a machine gun and is shot toward the green reticle. The secondary weapon fires remote-controlled missiles that target any nearby object around the front, dropping towards the ground in the direction of the green reticle. The white reticle always points at the head of the vehicle. The green reticle is projected by the momentum of the vehicle. The movement controls are the same as in a Raptor.

LL48 Tank

Vehicle-ll48tank
Vehicle-ll48tank-cockpit

LL48 Tank takes one rider. It walks on the ground and can jump from very high altitude while protecting the rider.

Vehicle-ll48tank-thirdperson-view

Its primary weapon is the HLAC, aiming towards the orange reticle, which follows the front of the vehicle, similar to the Light APC front gunner. The secondary weapon is the Tank Cannonball, aimed with the red reticle, which always points to the front of the vehicle. Reloading ammo takes a bit of time for the Tank Cannonball. Press SHIFT to move the secondary weapon down and press SPACE to move it up.


Notes for mappers

Vehicle class names for mappers:

  • Bumblebee: vehicle_bumblebee
  • Racer: vehicle_racer
  • Raptor: vehicle_raptor
  • Spiderbot: vehicle_spiderbot

Unofficial vehicle class names:

  • Light APC: vehicle_lightapc
  • R22 Helicopter: vehicle_r22heli
  • LL48 Tank: vehicle_tankll48

Notes for developers

ons/dom is UNSUPPORTED, as in targeting vehicles with those ents - this is in development.

Maps needed, as and ctf for now - I can't take this much further w/o play testing on a larger scale.

Sources

  • Official vehicles source codes are in this directory.
  • There are unofficial vehicles source codes stored in the SMB modpack.
  • Some unofficial vehicles are in the jeff-modpack.

Remember if you have them installed in the game, to activate those unofficial vehicles:

  • g_vehicles 1 // activate the vehicles in the game
  • set g_vehicles_extra 1 // activate the unofficial vehicles in the game
  • set g_vehicle_tankll48 1 // activate LL48 Tank vehicle in the game
  • set g_vehicle_r22heli 1 // activate R22 Helicopter in the game
  • set g_vehicle_lightapc 1 // activate Light APC in the game
  • set g_vehicles_enter 0 // activate enter inside vehicle automatically instead pressing the key to enter inside
  • set g_vehicles_vortex_damagerate 2
  • set g_vehicle_r22heli_shield_regen 20 // energy regeneration quantity
  • set g_vehicle_r22heli_shield 600 // energy shield
  • set g_vehicle_r22heli_health_regen 15 // health regeneration quantity
  • set g_vehicle_r22heli_speed_forward 2500 // R22 Helicopter speed when it's moving forward
  • set g_vehicle_tankll48_health 3500 // LL48 Tank health quantity
  • set g_vehicle_tankll48_cannon_damage 2000 // LL48 Tank Cannon damage quantity
  • It's recommended testing those vehicles in a map called mars and with mapinfo and entity files.

Clone this wiki locally