BZFlagWiki - User contributions [en]

Content Restrictions

2012-02-13T19:12:30Z

KTL: /*formatting*/

BZFlag offers a content restriction feature that can be used to limit what various clients will download.

The primary use of these restrictions is to limit the downloads of images so that parents can prevent inappropriate images being shown to their children.

==Defaults==
By default there is a single level of content restriction in place. Only images hosted on the [http://images.bzflag.org/submitimages/ BZFlag image submission system] will be allowed. This system has a 'family friendly' [http://images.bzflag.org/submitimages/tos.php content policy] and all images are reviewed manually by project staff to ensure that they follow the policy and are properly licensed.

==Configuring Content Restrictions==
Content restrictions are controlled by the file '''DownloadAccess.txt'''. This file will be created the first time a client joins a server that has external images. If the file does not exist a user can simply create it.

===Location===
The location of the file depends on the operating system that the client is installed on:
* Windows: OSDRIVE:\Users\USERNAME\AppData\Local\BZFlag\2.4\DownloadAccess.txt
* OS X: ~/Library/Application Support/BZFlag/DownloadAccess.txt
* Linux: ~/.bzf/DownloadAccess.txt

===Default Contents===
By default the file for 2.4 contains:
allow *.bzflag.org
deny *

===Modification===
The file can be edited in a normal text editor, such as ''Notepad'' or ''TextEdit''.

If the user would like to add additional sites to the allowed list they can simply add a new line before the '''deny''' section as follows

allow url.to.the.site.com

If the user would like to allow all sites they can simply add a wildcard instead of a site name and remove the '''deny''' section.

allow *

Another option to allow all servers is to delete the contents of the file and make it empty.

===Parental Security===
Parents may wish to secure the file from editing in order to prevent a child from circumventing any restrictions. Securing the file involves setting the child's user account in such a way that it does not have permission to edit the file. This method varies by OS and can be found using simple internet searches.

[[Category:Client]]

Content Restrictions

2012-02-13T18:19:09Z

KTL: formatting

There are limitations on the origin of images that can be displayed by a fresh installation of BZFlag. These can be configured by the user.

==Default Content Restrictions==

By default the game-client will only allow downloading images from the [http://images.bzflag.org official BZFlag image-server]. Those images all comply with a strict policy that can be found at the [http://images.bzflag.org/submitimages/tos.php BZFlag Image Uploader Terms Of Service].

Map creators can upload image-files to this server through the [http://images.bzflag.org/submitimages/ BZFlag Image Uploader].
This procedure has a few drawbacks however:
* Images need to get explicitly allowed by a moderator before they get in, this is a slow process. This way it becomes impractical to have dynamic content.
* Each image needs to have some license associated with it. Map makers often just want to make a map without being bothered by the legal aspects of it.

==Configuring Content Restrictions==
Each BZFlag client-installation has a file called DownloadAccess.txt which controls what servers are allowed to serve images.

===Location of the DownloadAccess-file===
Depending on your platform the location differs:

* Windows: My Documents\My BZFlag Files\DownloadAccess.txt
* OS X: ~/Library/Application Support/BZFlag/DownloadAccess.txt
* Linux: ~/.bzf/DownloadAccess.txt

===Modifying the DownloadAccess-file===
A simple text-editor can be used to modify this file. On windows the program "notepad" will do just fine.
If you do not want any content-restrictions at all you can replace the whole content of the file with the line
allow *
If you only want to allow a specific server then add '''on top of the file''' the line
allow some.image.server

Content Restrictions

2012-02-13T18:15:59Z

KTL: info about downloadaccess

There are limitations on the origin of images that can be displayed by a fresh installation of BZFlag. These can be configured by the user.

==Default Content Restrictions==

By default the game-client will only allow downloading images from the [http://images.bzflag.org official BZFlag image-server]. Those images all comply with a strict policy that can be found at the [http://images.bzflag.org/submitimages/tos.php BZFlag Image Uploader Terms Of Service].

Map creators can upload image-files to this server through the [http://images.bzflag.org/submitimages/ BZFlag Image Uploader].
This procedure has a few drawbacks however:
- Images need to get explicitly allowed by a moderator before they get in, this is a slow process. This way it becomes impractical to have dynamic content.
- Each image needs to have some license associated with it. Map makers often just want to make a map without being bothered by the legal aspects of it.

==Configuring Content Restrictions==
Each BZFlag client-installation has a file called DownloadAccess.txt which controls what servers are allowed to serve images.

===Location of the DownloadAccess-file===
Depending on your platform the location differs:
* Windows: My Documents\My BZFlag Files\DownloadAccess.txt
* OS X: ~/Library/Application Support/BZFlag/DownloadAccess.txt
* Linux: ~/.bzf/DownloadAccess.txt

===Modifying the DownloadAccess-file===
A simple text-editor can be used to modify this file. On windows the program "notepad" will do just fine.
If you do not want any content-restrictions at all you can replace the whole content of the file with the line
allow *
If you only want to allow a specific server then add '''on top of the file''' the line
allow some.image.server

Skybox

2011-02-07T23:10:57Z

KTL: /* working skybox, hopefully good newlines */

Skyboxes replace the normal scenery of BZFlag.

The material names needed to create a skybox are:
* LeftSkyboxMaterial
* RightSkyboxMaterial
* TopSkyboxMaterial
* BottomSkyboxMaterial
* FrontSkyboxMaterial
* BackSyboxMaterial

==Working with Skyboxes.==

Unless all six images load correctly, no skybox will be displayed. For this reason it is recommended to start with a working skybox, and change one texture at a time, testing each image one at a time. Colors are applied to this test world to assist in identifying left/right and front/back materials.
Image size will be automatically scaled to fit. Maximum default image size for clients is 1024 by 1024 pixels. Power-of-two pixel dimensions are recommended, but not required. You will notice a thin black line in the corners, this is a bug. This thin black line is not seen on GNU/Linux. It may only be on Mac OSX.

It is important to have 6 _different_ materials. Even if they all should look the same make them differ using for example the ambient or shader properties.

==Code==

{|
|
world
name SkyboxMaterialTest
size 230
end
options
-set _drawCelestial 0
-set _drawClouds 0
-set _drawGround 1
-set _drawGroundLights 0
-set _drawMountains 0
-set _wallHeight 0
end
# For reference, Include the other two "Magic" Material names.
# TeleMaterial will be available in BZFlag version 3.0
# teleporter texture
material
name LinkMaterial
addtexture http://cbg.bzflag.org/images/Panzer/borg/blackholes/nebula4.PNG
end
# -set _drawGround 0 will disable the GroundMaterial
material
name GroundMaterial
addtexture http://cbg.bzflag.org/images/Panzer/borg/blackholes/nebula4.PNG
end
#Space Skybox
material
name skyboxBase
color 1 1 .99999999
end
material
name LeftSkyboxMaterial
matref skyboxBase
texture http://images.bzflag.org/llegendary/Optic%20Delusion_skybox1.png
diffuse red
end
material
name FrontSkyboxMaterial
matref skyboxBase
texture http://images.bzflag.org/llegendary/Optic%20Delusion_skybox2.png
diffuse yellow
end
material
name RightSkyboxMaterial
matref skyboxBase
texture http://images.bzflag.org/llegendary/Optic%20Delusion_skybox4.png
diffuse green
end
material
name BackSkyboxMaterial
matref skyboxBase
texture http://images.bzflag.org/llegendary/Optic%20Delusion_skybox5.png
diffuse blue
end
material
name TopSkyboxMaterial
matref skyboxBase
texture http://images.bzflag.org/llegendary/Optic%20Delusion_skybox3.png
diffuse purple
end
material
name BottomSkyboxMaterial
matref skyboxBase
texture http://images.bzflag.org/llegendary/Optic%20Delusion_skybox6.png
diffuse white
end
#End Space Skybox

|}

Skybox

2011-02-07T23:08:59Z

KTL: Undo revision 7410 by KTL (Talk)

Skyboxes replace the normal scenery of BZFlag.

The material names needed to create a skybox are:
* LeftSkyboxMaterial
* RightSkyboxMaterial
* TopSkyboxMaterial
* BottomSkyboxMaterial
* FrontSkyboxMaterial
* BackSyboxMaterial

==Working with Skyboxes.==

Unless all six images load correctly, no skybox will be displayed. For this reason it is recommended to start with a working skybox, and change one texture at a time, testing each image one at a time. Colors are applied to this test world to assist in identifying left/right and front/back materials.
Image size will be automatically scaled to fit. Maximum default image size for clients is 1024 by 1024 pixels. Power-of-two pixel dimensions are recommended, but not required. You will notice a thin black line in the corners, this is a bug. This thin black line is not seen on GNU/Linux. It may only be on Mac OSX.

It is important to have 6 _different_ materials. Even if they all should look the same make them differ using for example the ambient or shader properties.

==Code==

{|
|
world
name SkyboxMaterialTest
size 230
end
options
-set _drawCelestial 0
-set _drawClouds 0
-set _drawGround 1
-set _drawGroundLights 0
-set _drawMountains 0
-set _wallHeight 0
end
# For reference, Include the other two "Magic" Material names.
# TeleMaterial will be available in BZFlag version 3.0
# teleporter texture
material
name LinkMaterial
addtexture http://cbg.bzflag.org/images/Panzer/borg/blackholes/nebula4.PNG
end
# -set _drawGround 0 will disable the GroundMaterial
material
name GroundMaterial
addtexture http://cbg.bzflag.org/images/Panzer/borg/blackholes/nebula4.PNG
end
#Space Skybox
material
name skyboxBase
color 1 1 .99999999
end
material
name LeftSkyboxMaterial
matref skyboxBase
texture http://cbg.bzflag.org/images/Panzer/borg/borgskybox/skybox1.png
diffuse red
end
material
name FrontSkyboxMaterial
matref skyboxBase
texture http://cbg.bzflag.org/images/Panzer/borg/borgskybox/skybox2.png
diffuse yellow
end
material
name RightSkyboxMaterial
matref skyboxBase
texture http://cbg.bzflag.org/images/Panzer/borg/borgskybox/skybox4.png
diffuse green
end
material
name BackSkyboxMaterial
matref skyboxBase
texture http://cbg.bzflag.org/images/Panzer/borg/borgskybox/skybox5.png
diffuse blue
end
material
name TopSkyboxMaterial
matref skyboxBase
texture http://cbg.bzflag.org/images/Panzer/borg/borgskybox/skybox3.png
diffuse purple
end
material
name BottomSkyboxMaterial
matref skyboxBase
texture http://cbg.bzflag.org/images/Panzer/borg/borgskybox/skybox6.png
diffuse white
end
#End Space Skybox

|}

Skybox

2011-02-07T23:06:05Z

KTL: /* working skybox now*/

Skyboxes replace the normal scenery of BZFlag.

The material names needed to create a skybox are:
* LeftSkyboxMaterial
* RightSkyboxMaterial
* TopSkyboxMaterial
* BottomSkyboxMaterial
* FrontSkyboxMaterial
* BackSyboxMaterial

==Working with Skyboxes.==

Unless all six images load correctly, no skybox will be displayed. For this reason it is recommended to start with a working skybox, and change one texture at a time, testing each image one at a time. Colors are applied to this test world to assist in identifying left/right and front/back materials.
Image size will be automatically scaled to fit. Maximum default image size for clients is 1024 by 1024 pixels. Power-of-two pixel dimensions are recommended, but not required. You will notice a thin black line in the corners, this is a bug. This thin black line is not seen on GNU/Linux. It may only be on Mac OSX.

It is important to have 6 _different_ materials. Even if they all should look the same make them differ using for example the ambient or shader properties.

==Code==

{|
|
world
name SkyboxMaterialTest
size 230
end
options
-set _drawCelestial 0
-set _drawClouds 0
-set _drawGround 0
-set _drawGroundLights 0
-set _drawMountains 0
-set _wallHeight 0
-set _skyColor black

end
#http://trepan.bzflag.bz/horizontal_gradient_blue_begin_red_and_transparant_end.png
# For reference, Include the other two "Magic" Material names.
# TeleMaterial will be available in BZFlag version 3.0
# teleporter texture

material
name GroundMaterial
texture caution
end

material
name LeftSkyboxMaterial
texture http://images.bzflag.org/llegendary/Optic%20Delusion_skybox1.png
ambient 0.9 0.0 0.0 1.0
end

material
name FrontSkyboxMaterial
texture http://images.bzflag.org/llegendary/Optic%20Delusion_skybox2.png
ambient 0.8 0.0 0.0 1.0
end

material
name RightSkyboxMaterial
texture http://images.bzflag.org/llegendary/Optic%20Delusion_skybox3.png
ambient 0.7 0.0 0.0 1.0
end

material
name BackSkyboxMaterial
texture http://images.bzflag.org/llegendary/Optic%20Delusion_skybox4.png
ambient 0.5 0.0 0.0 1.0
end

material
name TopSkyboxMaterial
texture http://images.bzflag.org/llegendary/Optic%20Delusion_skybox5.png
ambient 0.4 0.0 0.0 1.0
end

material
name BottomSkyboxMaterial
texture http://images.bzflag.org/llegendary/Optic%20Delusion_skybox6.png
ambient 0.3 0.0 0.0 1.0
end

#End Space Skybox

|}

Skybox

2011-02-07T22:57:00Z

KTL: /* got to be unique materials. */

Skyboxes replace the normal scenery of BZFlag.

The material names needed to create a skybox are:
* LeftSkyboxMaterial
* RightSkyboxMaterial
* TopSkyboxMaterial
* BottomSkyboxMaterial
* FrontSkyboxMaterial
* BackSyboxMaterial

==Working with Skyboxes.==

Unless all six images load correctly, no skybox will be displayed. For this reason it is recommended to start with a working skybox, and change one texture at a time, testing each image one at a time. Colors are applied to this test world to assist in identifying left/right and front/back materials.
Image size will be automatically scaled to fit. Maximum default image size for clients is 1024 by 1024 pixels. Power-of-two pixel dimensions are recommended, but not required. You will notice a thin black line in the corners, this is a bug. This thin black line is not seen on GNU/Linux. It may only be on Mac OSX.

It is important to have 6 _different_ materials. Even if they all should look the same make them differ using for example the ambient or shader properties.

==Code==

{|
|
world
name SkyboxMaterialTest
size 230
end
options
-set _drawCelestial 0
-set _drawClouds 0
-set _drawGround 1
-set _drawGroundLights 0
-set _drawMountains 0
-set _wallHeight 0
end
# For reference, Include the other two "Magic" Material names.
# TeleMaterial will be available in BZFlag version 3.0
# teleporter texture
material
name LinkMaterial
addtexture http://cbg.bzflag.org/images/Panzer/borg/blackholes/nebula4.PNG
end
# -set _drawGround 0 will disable the GroundMaterial
material
name GroundMaterial
addtexture http://cbg.bzflag.org/images/Panzer/borg/blackholes/nebula4.PNG
end
#Space Skybox
material
name skyboxBase
color 1 1 .99999999
end
material
name LeftSkyboxMaterial
matref skyboxBase
texture http://cbg.bzflag.org/images/Panzer/borg/borgskybox/skybox1.png
diffuse red
end
material
name FrontSkyboxMaterial
matref skyboxBase
texture http://cbg.bzflag.org/images/Panzer/borg/borgskybox/skybox2.png
diffuse yellow
end
material
name RightSkyboxMaterial
matref skyboxBase
texture http://cbg.bzflag.org/images/Panzer/borg/borgskybox/skybox4.png
diffuse green
end
material
name BackSkyboxMaterial
matref skyboxBase
texture http://cbg.bzflag.org/images/Panzer/borg/borgskybox/skybox5.png
diffuse blue
end
material
name TopSkyboxMaterial
matref skyboxBase
texture http://cbg.bzflag.org/images/Panzer/borg/borgskybox/skybox3.png
diffuse purple
end
material
name BottomSkyboxMaterial
matref skyboxBase
texture http://cbg.bzflag.org/images/Panzer/borg/borgskybox/skybox6.png
diffuse white
end
#End Space Skybox

|}

Server Variables

2009-08-09T02:18:45Z

KTL: adding _rejumpTime

The BZFlag Server (BZFS) allows administrators to configure a large number of gameplay and configuration settings from within the client. The /set command in-game allows users with the appropriate permissions to change these values. These may also be known as BZDB variables and "/set variables" depending on who you speak with.

Unless otherwise noted, time values are measured in seconds, distances in [[world units]], and speeds in [[world units]] per second.

{{InfoBox|Note|Some values, such as _worldSize, only take affect at server start since they affect the world file that is generated. It is recommended to apply these in the map file so they are loaded with the map.}}
{|{{Prettytable}}
|-
|{{Hl3}}|'''Name'''
|{{Hl3}}|'''Default'''
|{{Hl3}}|'''Description'''
|-
| _agilityAdVel || 2.25 || Multiplies _tankSpeed for tanks holding Agility flag for a specified amount of time (_agilityTimeWindow)
|-
| _agilityTimeWindow || 1 || The amount of time (in seconds)that the tank will have the speed specified by _agilityAdVel
|-
| _agilityVelDelta || 0.3 ||
|-
| _angleTolerance || 0.05 || If a tank has turned more than it was expected to, plus this tolerance, a new update is sent so the other clients are aware of the change in heading
|-
| _angularAd || 1.5 || Multiplies _tankAngVel to determine how fast tanks can turn while holding the Quick Turn flag
|-
| _avenueSize || 2*_boxBase || Space to leave between objects in random maps?
|-
| _baseSize || 60 || Width and Depth (bases have constant height) of the square bases for CTF games
|-
| _boxBase || 30 || Width and Depth of boxes on a random map?
|-
| _boxHeight || 6*_muzzleHeight || Height of boxes on a random map?
|-
| _burrowDepth || 1.32 || Determines how far down tanks drop when they have the Burrow Flag. Making this much lower makes it below the floor, and impossible to kill the tank without something like a ShockWave flag!
|-
| _burrowSpeedAd || .8 || Multiplied by _tankSpeed to determine how fast tanks holding the Burrow Flag move.
|-
| _burrowAngularAd || .55 || Multiplied by _tankAngVel to determine how fast tanks can turn while holding the Burrow flag.
|-
| _coldetDepth || 6 ||
|-
| _coldetElements || 4 ||
|-
| _countdownResumeTime || 5 || This enforces a delay when resuming a paused countdown. If the argument is lower or equal to 0 then resuming is instantly, otherwise it is delayed according to the value (in seconds). ''Available in 2.1 and later''
|-
| _cullDepth || 6 ||
|-
| _cullDist || fog || Far plane culling distance ('fog' uses the fog parameters).
|-
| _cullElements || 16 ||
|-
| _cullOccluders || 0 ||
|-
| _disableBots || none || A value of 1 in this variable does not allow autopilot or bots on the server, equivalent to the old -prohibitbots command line option.
|-
| _drawCelestial || 1 || Draw the stars, sun, and moon.
|-
| _drawClouds || 1 || Draw the clouds.
|-
| _drawGround || 1 || Draw the ground plane.
|-
| _drawMountains || 1 || Draw the mountains.
|-
| _drawSky || 1 || Draw the sky pyramid.
|-
| _explodeTime || 5 || After a tank is killed, this is how long it takes to blow up, and then "respawn". Larger values translates into longer explosions and more client processor time. Note that an explosion is invisible if you are inside it, so large values may make it invisible up close, and extremely large values may make explosions entirely invisible.
|-
| _flagAltitude || 11 || The height that the flag flies up when dropped and the height that a flag spawns at.
|-
| _flagEffectTime || 0.64 || How much time it takes for the flag to go into effect.
|-
| _flagHeight || 10 || The height of the flag (not its pole).
|-
| _flagPoleWidth || 0.025 || The diameter of the flag pole.
|-
| _flagPoleSize || 0.8 || The height of the flag pole.
|-
| _flagRadius || 2.5 || Determines how close a tank must be to a flag to pick it up.
|-
| _fogMode || none || Valid values: linear, exp, or exp2.
|-
| _fogDensity || 0.001 || Used for exp and exp2 fog modes.
|-
| _fogStart || 0.5*_worldSize || Used for linear fog mode, the distance where fog begins to occlude vision.
|-
| _fogEnd || _worldSize || Used for linear fog mode, the distance where the fog occludes everything.
|-
| _fogColor || "0.25 0.25 0.25" || RGB or black, red, blue (alpha is ignored).
|-
| _friction || 0 || Zero is normal friction, the closer to 0 the harder it is to start and stop, and the higher the number the easier it is to start and stop.
|-
| _gmActivationTime || 0.5 || The amount of time (in seconds) it takes for a Guided Missile to become active after it is fired. Any contact under this time will not result in detonation (setting it too low could cause its owner to run into its own GM and be blown up!
|-
| _gmAdLife || 0.95 || Multiplied by _shotRange to determine the distance guided missiles will go.
|-
| _gmTurnAngle || 0.628319 || The angle at which a Guided Missile will turn to follow its target. (Measured in radians)
|-
| _gravity || -9.8 || The rate at which a tank will fall (or be kept from jumping) Measured in [[World units]]/Seconds^2. Setting this to a zero or positive value will result in tanks being unable to stay down and will float away.
|-
| _handicapScoreDiff || 50 || How much of a score difference (from the leader?) there must be for a player to get a handicap
|-
| _handicapVelAd || 2 || Player with handicap will receive this much more (_tankSpeed + _handicapVelAd) velocity than the normal _tankSpeed value. ''**Note: These could be factors rather than additions''
|-
| _handicapAngAd || 1.5 || Player with handicap will receive this much more (_angularAd + _handicapAngAd) turning ability than the normal _angularAd. ''**Note: These could be factors rather than additions''
|-
| _handicapShotAd || 1.75 || ''**Note: These could be factors rather than additions''
|-
| _identifyRange || 50 || If a flag is this distance or closer to a tank carrying the Identify (ID) flag, it will display the closest flag's type.
|-
| _inertiaAngular || 38 || Sets the maximum angular acceleration. Available in version 3.0. Replaces the "-a" option.
|-
| _inertiaLinear || 45 || Sets the maximum linear acceleration. Available in version 3.0. Replaces the "-a" option.
|-
| _jumpVelocity || 19 || The speed a tank moves vertically while jumping.
|-
| _laserAdVel || 1000 || The length of each laser shot. Laser's aren't exactly "infinite" as their description states, they go on for as long as this variable states.
|-
| _laserAdRate || 0.5 || Multiplied by _rFireAdRate to determine the firing rate for a laser.
|-
| _laserAdLife || 0.1 || The amount of time (in seconds) that a laser remains after being fired.
|-
| _latitude || 37.5 || The latitude at which the world exists. This affects the timezone.
|-
| _lgGravity|| 12.7 || Modifies the gravity for owners of the Low Gravity flag. Similar to the _gravity variable. ''Available starting in version 2.1''
|-
| _lockOnAngle || 0.15 || Angle (in radians) in relation to tanks heading (positive or negative) that will allow a Guided Missile to lock onto a target.
|-
| _longitude || 122 || The longitude at which the world exists. This affects the timezone.
|-
| _lRAdRate || 0.5 ||
|-
| _maxBumpHeight || 0.33 || Any difference between the surface a tank is on and the top surface of an object the tank runs into that is less than this value will allow the tank to simply move up to the object rather than being stopped by it.
|-
| _maxFlagGrabs || 4.0 || How many times a flag can be dropped before it respawns. At the first spawn, flags are assigned a random # between 1 and _maxFlagGrabs. Each grab reduces that number by 1, until zero is reached, then the flag spawns at a new location. Flags will always respawn no matter how many flag grabs they have left if dropped over an 'unsafe' zone.
|-
| _maxLOD || 32767 || The max level of detail to allow.
|-
| _mirror || none || Options: '''white''', '''black''', '''red''', '''blue''', '''pink''', '''purple''', '''orange''', etc... ("black 0.75" is a good setting, some invalid options such as '''mirror''' will give a mirror look)
|-
| _momentumLinAcc || 1 || Momentum flag's effect on going forwards and backwards.
|-
| _momentumAngAcc || 1 || Momentum flag's effect on turning.
|-
| _momentumFriction || 0 || Friction (same as _friction) when holding the Momentum flag.
|-
| _mGunAdVel || 1/_mGunAdRate || The speed of the machine gun's bullets.
|-
| _mGunAdRate || 10 || _reloadTime divided by _mGunAdRate gives how long machine gun bullets take to reload.
|-
| _mGunAdLife || 1.5 || Multiplied by _shotRange to determine the distance machine gun bullets go.
|-
| _muzzleFront || _tankRadius + 0.1 || Location of muzzle of tank (affects bullets and player camera location).
|-
| _muzzleHeight || 1.57 || See _muzzleFront.
|-
| _noClimb || 1 || Allow or disallow climbing on sloped surfaces. A value of 0 allows, 1 disallows.
|-
| _noShadows || 0 || Enables of disables shadows. A value of 0 allows, 1 disallows.
|-
| _noSmallPackets || 0 ||
|-
| _notRespondingTime || 5 || The amount of time (in seconds) the server should wait before reporting a tank as not responding.
|-
| _obeseFactor || 2.5 || Multiplier of normal size that determines how big a tank gets when carrying the Obese flag.
|-
| _pauseDropTime || 15 || The amount of time (in seconds) that a tank needs to be paused before its flag is dropped automatically.
|-
| _positionTolerance || 0.09 ||
|-
| _pyrBase || 4 * _tankHeight || Base size of pyramids generated by the default random map generator.
|-
| _pyrHeight || 5 * _tankHeight || Height of pyramids generated by the default random map generator.
|-
| _radarLimit || _worldSize || The maximum area that the radar can see (when not rotated).
|-
| _rainBaseColor || none || When _rainType = rain, sets color of the bottom of raindrops.
|-
| _rainDensity || none || Determines how many drops of rain are in the space defined by _rainSpread.
|-
| _rainEndZ || none || The height above the ground where rain should stop falling.
|-
| _rainMaxPuddleTime || none || The amount of time (in seconds) a rain puddle should exist before disappearing.
|-
| _rainPuddleSpeed || none || The speed at which puddles should spread out.
|-
| _rainPuddleColor || none || Color of rain puddles. none means no puddle.
|-
| _rainPuddleTexture ||none || Texture of puddles. Best to leave default.
|-
| _rainRoofs || 1 || '''0''' rain falls through everything '''1''' rain hits buildings, but puddles are only on the ground '''2''' rain hits buildings, and creates puddles on them
|-
| _rainSpread || none || The radius from center of map where rain will fall.
|-
| _rainSpeed || none || The speed at which the rain falls.
|-
| _rainSpeedMod || none || Randomizes _rainSpeed by adding/subtracting up to this number from each raindrop's speed
|-
| _rainSpins || none || '''0''' Rain does not spin as it falls '''1''' Rain spins as it falls.
|-
| _rainStartZ || none || The height above ground that rain should fall from.
|-
| _rainTexture || none || The name of the texture in data directory. ''Works with _rainTypes of frog, particle, bubble, snow, fatrain''
|-
| _rainTopColor ||none || When _rainType = rain, sets color of the top of raindrops.
|-
| _rainType || none || Adjusts all _rain* and _use* variables automatically Valid Options : '''frog''', '''particle''', '''rain''', '''bubble''', '''snow''', '''fatrain'''
|-
| _rejoinTime || _explodeTime || The number of seconds before clients can rejoin a game, after they leave.
|-
| _rejumpTime || 0.01 || From version 3.0. Time a tank has to wait before he can jump again after landing. Any value higher than 0 will make it difficult to jump away from sloped faces like pyramids.
|-
| _reloadTime || _shotRange/_shotSpeed || Time between shot reloads, note that this can cut shot range short.
|-
| _rFireAdVel || 1.5 || Multiplied by _shotSpeed to determine the speed of the rapid fire bullets.
|-
| _rFireAdRate || 2 || The reload time (in seconds) for rapid fire bullets.
|-
| _rFireAdLife || 1/_rFireAdRate || How long the rapid fire bullets last.
|-
| _shieldFlight || 2.7 || The amount of time (in seconds) that a shield flag floats in the air (after you drop it) before coming down again.
|-
| _shockAdLife || 0.2 || The amount of time (in seconds) that a shockwave lasts.
|-
| _shockInRadius || _tankLength || The starting radius of the shockwave. Negative values will make the shockwave shrink and expand.
|-
| _shockOutRadius || 60 || The outer radius of the shockwave. If greater than _shockInRadius, the shockwave expands outward. If less than _shockInRadius, the shockwave starts big and shrinks inward.
|-
| _shotRadius || 0.5 || For collision detection.
|-
| _shotRange || 350 || Range of shots, note that they can be cut short by _reloadTime.
|-
| _shotSpeed || 100 || Speed of shots.
|-
| _shotTailLength || 4 ||
|-
| _shotsKeepVerticalVelocity || 0 || If '''0''', shots always move straight in relation to the ground. If '''1''', shots are affected vertically by the tank's speed, and can fly up and down. Lasers are also affected.
|-
| _skyColor || white || Sets the sky to a specific color.
|-
| _srRadiusMult || 2 || Radius of steamroller effect.
|-
| _squishFactor || 1 || How much tanks squish when landing.
|-
| _squishTime || 1 || How much squishy time you get after falling to the ground.
|-
| _syncTime || 1 || Whether or not to sync the players time with the servers'.
|-
| _syncLocation || 0 || Whether or not to sync the location time with the servers'.
|-
| _tankAngVel || 0.785398 || How fast the tank can turn.
|-
| _tankExplosionSize || 3.5 * _tankLength || How large the tank's explosion is.
|-
| _tankHeight || 2.05 || The height of the tank.
|-
| _tankLength || 6 || The length of the tank.
|-
| _tankRadius || 0.72 * _tankLength || The radius of the tank.
|-
| _tankSpeed || 25 || The speed of the tank
|-
| _tankWidth || 2.8 || The width of the tank.
|-
| _targetingAngle || 0.3|| Something to do with GM...
|-
| _teleportBreadth || 4.48|| Random maps?
|-
| _teleportHeight || 10.08 || See _teleportBreadth.
|-
| _teleportTime || 1 ||
|-
| _teleportWidth || 1.12 || See _teleportHeight.
|-
| _thiefAdLife || 0.05 || The amount of time (in seconds) that a thief shot lasts.
|-
| _thiefAdRate || 12 || The amount of time (in seconds) that the Thief "shot" reloads.
|-
| _thiefAdShotVel || 8 || The speed of thief.
|-
| _thiefTinyFactor || 0.5|| Multiplied by the normal tank size to shrink a tank carrying the thief flag.
|-
| _thiefVelAd || 1.67 || Multiplied by _tankSpeed to determine how fast tanks holding the thief goes.
|-
| _thiefDropTime || reloadTime * 0.5 ||The amount of time you must wait to fire a shot after stealing a flag.
|-
| _tinyFactor || 0.4 || Multiplied by the normal tank size to shrink a tank carrying the tiny flag.
|-
| _trackFade || 3 || The amount of time (in seconds) before track marks fade.
|-
| _updateThrottleRate || 30 ||
|-
| _useLineRain || none || '''0''' Rain is not a vertical line '''1''' Rain is vertical lines, smoothly shaded from _rainTopColor to _rainBaseColor
|-
| _useRainPuddles || none || '''0''' Rain does not create puddles '''1''' Rain creates puddles
|-
| _useRainBillboards || none || '''0''' Rain is lines or polygons '''1''' Rain is billboards, textured and look the same from all angles
|-
| _velocityAd || 1.5 || Multiplies _tankSpeed to determine the speed of a tank carrying the high speed (V) flag
|-
| _wallHeight || 3 * _tankHeight|| The outer wall height.
|-
| _weapons || 1 || Used with world weapons, '''0''' world weapons will not fire '''1''' world weapons will fire
|-
| _wideAngleAng || 1.745329 || The viewing angle when a tank has the Wide Angle bad flag.
|-
| _wingsGravity || _gravity || How much gravity affects tanks with the WG flag.
|-
| _wingsJumpCount || 1 || The number of jumps a tank with the wings flag can do before returning to the ground.
|-
| _wingsJumpVelocity || _jumpVelocity || The initial velocity of a jump with wings, in [[world units]]/sec.
|-
| _wingsSlideTime || 0 || When in the air, the tanks will slide for this long.
|-
| _worldSize || 400 || The size of the world. This should not be set during play, as the walls will not move for currently connected players. Setting this larger will allow tanks to go outside the map, and setting it smaller will cause tanks to be kicked for leaving the world boundaries.
|}

[[Category:Server]]

Server Variables

2009-08-05T00:23:50Z

KTL:

The BZFlag Server (BZFS) allows administrators to configure a large number of gameplay and configuration settings from within the client. The /set command in-game allows users with the appropriate permissions to change these values. These may also be known as BZDB variables and "/set variables" depending on who you speak with.

Unless otherwise noted, time values are measured in seconds, distances in [[world units]], and speeds in [[world units]] per second.

{{InfoBox|Note|Some values, such as _worldSize, only take affect at server start since they affect the world file that is generated. It is recommended to apply these in the map file so they are loaded with the map.}}
{|{{Prettytable}}
|-
|{{Hl3}}|'''Name'''
|{{Hl3}}|'''Default'''
|{{Hl3}}|'''Description'''
|-
| _agilityAdVel || 2.25 || Multiplies _tankSpeed for tanks holding Agility flag for a specified amount of time (_agilityTimeWindow)
|-
| _agilityTimeWindow || 1 || The amount of time (in seconds)that the tank will have the speed specified by _agilityAdVel
|-
| _agilityVelDelta || 0.3 ||
|-
| _angleTolerance || 0.05 || If a tank has turned more than it was expected to, plus this tolerance, a new update is sent so the other clients are aware of the change in heading
|-
| _angularAd || 1.5 || Multiplies _tankAngVel to determine how fast tanks can turn while holding the Quick Turn flag
|-
| _avenueSize || 2*_boxBase || Space to leave between objects in random maps?
|-
| _baseSize || 60 || Width and Depth (bases have constant height) of the square bases for CTF games
|-
| _boxBase || 30 || Width and Depth of boxes on a random map?
|-
| _boxHeight || 6*_muzzleHeight || Height of boxes on a random map?
|-
| _burrowDepth || 1.32 || Determines how far down tanks drop when they have the Burrow Flag. Making this much lower makes it below the floor, and impossible to kill the tank without something like a ShockWave flag!
|-
| _burrowSpeedAd || .8 || Multiplied by _tankSpeed to determine how fast tanks holding the Burrow Flag move.
|-
| _burrowAngularAd || .55 || Multiplied by _tankAngVel to determine how fast tanks can turn while holding the Burrow flag.
|-
| _coldetDepth || 6 ||
|-
| _coldetElements || 4 ||
|-
| _countdownResumeTime || 5 || This enforces a delay when resuming a paused countdown. If the argument is lower or equal to 0 then resuming is instantly, otherwise it is delayed according to the value (in seconds). ''Available in 2.1 and later''
|-
| _cullDepth || 6 ||
|-
| _cullDist || fog || Far plane culling distance ('fog' uses the fog parameters).
|-
| _cullElements || 16 ||
|-
| _cullOccluders || 0 ||
|-
| _disableBots || none || A value of 1 in this variable does not allow autopilot or bots on the server, equivalent to the old -prohibitbots command line option.
|-
| _drawCelestial || 1 || Draw the stars, sun, and moon.
|-
| _drawClouds || 1 || Draw the clouds.
|-
| _drawGround || 1 || Draw the ground plane.
|-
| _drawMountains || 1 || Draw the mountains.
|-
| _drawSky || 1 || Draw the sky pyramid.
|-
| _explodeTime || 5 || After a tank is killed, this is how long it takes to blow up, and then "respawn". Larger values translates into longer explosions and more client processor time. Note that an explosion is invisible if you are inside it, so large values may make it invisible up close, and extremely large values may make explosions entirely invisible.
|-
| _flagAltitude || 11 || The height that the flag flies up when dropped and the height that a flag spawns at.
|-
| _flagEffectTime || 0.64 || How much time it takes for the flag to go into effect.
|-
| _flagHeight || 10 || The height of the flag (not its pole).
|-
| _flagPoleWidth || 0.025 || The diameter of the flag pole.
|-
| _flagPoleSize || 0.8 || The height of the flag pole.
|-
| _flagRadius || 2.5 || Determines how close a tank must be to a flag to pick it up.
|-
| _fogMode || none || Valid values: linear, exp, or exp2.
|-
| _fogDensity || 0.001 || Used for exp and exp2 fog modes.
|-
| _fogStart || 0.5*_worldSize || Used for linear fog mode, the distance where fog begins to occlude vision.
|-
| _fogEnd || _worldSize || Used for linear fog mode, the distance where the fog occludes everything.
|-
| _fogColor || "0.25 0.25 0.25" || RGB or black, red, blue (alpha is ignored).
|-
| _friction || 0 || Zero is normal friction, the closer to 0 the harder it is to start and stop, and the higher the number the easier it is to start and stop.
|-
| _gmActivationTime || 0.5 || The amount of time (in seconds) it takes for a Guided Missile to become active after it is fired. Any contact under this time will not result in detonation (setting it too low could cause its owner to run into its own GM and be blown up!
|-
| _gmAdLife || 0.95 || Multiplied by _shotRange to determine the distance guided missiles will go.
|-
| _gmTurnAngle || 0.628319 || The angle at which a Guided Missile will turn to follow its target. (Measured in radians)
|-
| _gravity || -9.8 || The rate at which a tank will fall (or be kept from jumping) Measured in [[World units]]/Seconds^2. Setting this to a zero or positive value will result in tanks being unable to stay down and will float away.
|-
| _handicapScoreDiff || 50 || How much of a score difference (from the leader?) there must be for a player to get a handicap
|-
| _handicapVelAd || 2 || Player with handicap will receive this much more (_tankSpeed + _handicapVelAd) velocity than the normal _tankSpeed value. ''**Note: These could be factors rather than additions''
|-
| _handicapAngAd || 1.5 || Player with handicap will receive this much more (_angularAd + _handicapAngAd) turning ability than the normal _angularAd. ''**Note: These could be factors rather than additions''
|-
| _handicapShotAd || 1.75 || ''**Note: These could be factors rather than additions''
|-
| _identifyRange || 50 || If a flag is this distance or closer to a tank carrying the Identify (ID) flag, it will display the closest flag's type.
|-
| _inertiaAngular || 38 || Sets the maximum angular acceleration. Available in version 3.0. Replaces the "-a" option.
|-
| _inertiaLinear || 45 || Sets the maximum linear acceleration. Available in version 3.0. Replaces the "-a" option.
|-
| _jumpVelocity || 19 || The speed a tank moves vertically while jumping.
|-
| _laserAdVel || 1000 || The length of each laser shot. Laser's aren't exactly "infinite" as their description states, they go on for as long as this variable states.
|-
| _laserAdRate || 0.5 || Multiplied by _rFireAdRate to determine the firing rate for a laser.
|-
| _laserAdLife || 0.1 || The amount of time (in seconds) that a laser remains after being fired.
|-
| _latitude || 37.5 || The latitude at which the world exists. This affects the timezone.
|-
| _lgGravity|| 12.7 || Modifies the gravity for owners of the Low Gravity flag. Similar to the _gravity variable. ''Available starting in version 2.1''
|-
| _lockOnAngle || 0.15 || Angle (in radians) in relation to tanks heading (positive or negative) that will allow a Guided Missile to lock onto a target.
|-
| _longitude || 122 || The longitude at which the world exists. This affects the timezone.
|-
| _lRAdRate || 0.5 ||
|-
| _maxBumpHeight || 0.33 || Any difference between the surface a tank is on and the top surface of an object the tank runs into that is less than this value will allow the tank to simply move up to the object rather than being stopped by it.
|-
| _maxFlagGrabs || 4.0 || How many times a flag can be dropped before it respawns. At the first spawn, flags are assigned a random # between 1 and _maxFlagGrabs. Each grab reduces that number by 1, until zero is reached, then the flag spawns at a new location. Flags will always respawn no matter how many flag grabs they have left if dropped over an 'unsafe' zone.
|-
| _maxLOD || 32767 || The max level of detail to allow.
|-
| _mirror || none || Options: '''white''', '''black''', '''red''', '''blue''', '''pink''', '''purple''', '''orange''', etc... ("black 0.75" is a good setting, some invalid options such as '''mirror''' will give a mirror look)
|-
| _momentumLinAcc || 1 || Momentum flag's effect on going forwards and backwards.
|-
| _momentumAngAcc || 1 || Momentum flag's effect on turning.
|-
| _momentumFriction || 0 || Friction (same as _friction) when holding the Momentum flag.
|-
| _mGunAdVel || 1/_mGunAdRate || The speed of the machine gun's bullets.
|-
| _mGunAdRate || 10 || _reloadTime divided by _mGunAdRate gives how long machine gun bullets take to reload.
|-
| _mGunAdLife || 1.5 || Multiplied by _shotRange to determine the distance machine gun bullets go.
|-
| _muzzleFront || _tankRadius + 0.1 || Location of muzzle of tank (affects bullets and player camera location).
|-
| _muzzleHeight || 1.57 || See _muzzleFront.
|-
| _noClimb || 1 || Allow or disallow climbing on sloped surfaces. A value of 0 allows, 1 disallows.
|-
| _noShadows || 0 || Enables of disables shadows. A value of 0 allows, 1 disallows.
|-
| _noSmallPackets || 0 ||
|-
| _notRespondingTime || 5 || The amount of time (in seconds) the server should wait before reporting a tank as not responding.
|-
| _obeseFactor || 2.5 || Multiplier of normal size that determines how big a tank gets when carrying the Obese flag.
|-
| _pauseDropTime || 15 || The amount of time (in seconds) that a tank needs to be paused before its flag is dropped automatically.
|-
| _positionTolerance || 0.09 ||
|-
| _pyrBase || 4 * _tankHeight || Base size of pyramids generated by the default random map generator.
|-
| _pyrHeight || 5 * _tankHeight || Height of pyramids generated by the default random map generator.
|-
| _radarLimit || _worldSize || The maximum area that the radar can see (when not rotated).
|-
| _rainBaseColor || none || When _rainType = rain, sets color of the bottom of raindrops.
|-
| _rainDensity || none || Determines how many drops of rain are in the space defined by _rainSpread.
|-
| _rainEndZ || none || The height above the ground where rain should stop falling.
|-
| _rainMaxPuddleTime || none || The amount of time (in seconds) a rain puddle should exist before disappearing.
|-
| _rainPuddleSpeed || none || The speed at which puddles should spread out.
|-
| _rainPuddleColor || none || Color of rain puddles. none means no puddle.
|-
| _rainPuddleTexture ||none || Texture of puddles. Best to leave default.
|-
| _rainRoofs || 1 || '''0''' rain falls through everything '''1''' rain hits buildings, but puddles are only on the ground '''2''' rain hits buildings, and creates puddles on them
|-
| _rainSpread || none || The radius from center of map where rain will fall.
|-
| _rainSpeed || none || The speed at which the rain falls.
|-
| _rainSpeedMod || none || Randomizes _rainSpeed by adding/subtracting up to this number from each raindrop's speed
|-
| _rainSpins || none || '''0''' Rain does not spin as it falls '''1''' Rain spins as it falls.
|-
| _rainStartZ || none || The height above ground that rain should fall from.
|-
| _rainTexture || none || The name of the texture in data directory. ''Works with _rainTypes of frog, particle, bubble, snow, fatrain''
|-
| _rainTopColor ||none || When _rainType = rain, sets color of the top of raindrops.
|-
| _rainType || none || Adjusts all _rain* and _use* variables automatically Valid Options : '''frog''', '''particle''', '''rain''', '''bubble''', '''snow''', '''fatrain'''
|-
| _rejoinTime || _explodeTime || The number of seconds before clients can rejoin a game, after they leave.
|-
| _reloadTime || _shotRange/_shotSpeed || Time between shot reloads, note that this can cut shot range short.
|-
| _rFireAdVel || 1.5 || Multiplied by _shotSpeed to determine the speed of the rapid fire bullets.
|-
| _rFireAdRate || 2 || The reload time (in seconds) for rapid fire bullets.
|-
| _rFireAdLife || 1/_rFireAdRate || How long the rapid fire bullets last.
|-
| _shieldFlight || 2.7 || The amount of time (in seconds) that a shield flag floats in the air (after you drop it) before coming down again.
|-
| _shockAdLife || 0.2 || The amount of time (in seconds) that a shockwave lasts.
|-
| _shockInRadius || _tankLength || The starting radius of the shockwave. Negative values will make the shockwave shrink and expand.
|-
| _shockOutRadius || 60 || The outer radius of the shockwave. If greater than _shockInRadius, the shockwave expands outward. If less than _shockInRadius, the shockwave starts big and shrinks inward.
|-
| _shotRadius || 0.5 || For collision detection.
|-
| _shotRange || 350 || Range of shots, note that they can be cut short by _reloadTime.
|-
| _shotSpeed || 100 || Speed of shots.
|-
| _shotTailLength || 4 ||
|-
| _shotsKeepVerticalVelocity || 0 || If '''0''', shots always move straight in relation to the ground. If '''1''', shots are affected vertically by the tank's speed, and can fly up and down. Lasers are also affected.
|-
| _skyColor || white || Sets the sky to a specific color.
|-
| _srRadiusMult || 2 || Radius of steamroller effect.
|-
| _squishFactor || 1 || How much tanks squish when landing.
|-
| _squishTime || 1 || How much squishy time you get after falling to the ground.
|-
| _syncTime || 1 || Whether or not to sync the players time with the servers'.
|-
| _syncLocation || 0 || Whether or not to sync the location time with the servers'.
|-
| _tankAngVel || 0.785398 || How fast the tank can turn.
|-
| _tankExplosionSize || 3.5 * _tankLength || How large the tank's explosion is.
|-
| _tankHeight || 2.05 || The height of the tank.
|-
| _tankLength || 6 || The length of the tank.
|-
| _tankRadius || 0.72 * _tankLength || The radius of the tank.
|-
| _tankSpeed || 25 || The speed of the tank
|-
| _tankWidth || 2.8 || The width of the tank.
|-
| _targetingAngle || 0.3|| Something to do with GM...
|-
| _teleportBreadth || 4.48|| Random maps?
|-
| _teleportHeight || 10.08 || See _teleportBreadth.
|-
| _teleportTime || 1 ||
|-
| _teleportWidth || 1.12 || See _teleportHeight.
|-
| _thiefAdLife || 0.05 || The amount of time (in seconds) that a thief shot lasts.
|-
| _thiefAdRate || 12 || The amount of time (in seconds) that the Thief "shot" reloads.
|-
| _thiefAdShotVel || 8 || The speed of thief.
|-
| _thiefTinyFactor || 0.5|| Multiplied by the normal tank size to shrink a tank carrying the thief flag.
|-
| _thiefVelAd || 1.67 || Multiplied by _tankSpeed to determine how fast tanks holding the thief goes.
|-
| _thiefDropTime || reloadTime * 0.5 ||The amount of time you must wait to fire a shot after stealing a flag.
|-
| _tinyFactor || 0.4 || Multiplied by the normal tank size to shrink a tank carrying the tiny flag.
|-
| _trackFade || 3 || The amount of time (in seconds) before track marks fade.
|-
| _updateThrottleRate || 30 ||
|-
| _useLineRain || none || '''0''' Rain is not a vertical line '''1''' Rain is vertical lines, smoothly shaded from _rainTopColor to _rainBaseColor
|-
| _useRainPuddles || none || '''0''' Rain does not create puddles '''1''' Rain creates puddles
|-
| _useRainBillboards || none || '''0''' Rain is lines or polygons '''1''' Rain is billboards, textured and look the same from all angles
|-
| _velocityAd || 1.5 || Multiplies _tankSpeed to determine the speed of a tank carrying the high speed (V) flag
|-
| _wallHeight || 3 * _tankHeight|| The outer wall height.
|-
| _weapons || 1 || Used with world weapons, '''0''' world weapons will not fire '''1''' world weapons will fire
|-
| _wideAngleAng || 1.745329 || The viewing angle when a tank has the Wide Angle bad flag.
|-
| _wingsGravity || _gravity || How much gravity affects tanks with the WG flag.
|-
| _wingsJumpCount || 1 || The number of jumps a tank with the wings flag can do before returning to the ground.
|-
| _wingsJumpVelocity || _jumpVelocity || The initial velocity of a jump with wings, in [[world units]]/sec.
|-
| _wingsSlideTime || 0 || When in the air, the tanks will slide for this long.
|-
| _worldSize || 400 || The size of the world. This should not be set during play, as the walls will not move for currently connected players. Setting this larger will allow tanks to go outside the map, and setting it smaller will cause tanks to be kicked for leaving the world boundaries.
|}

[[Category:Server]]

BZFlag 2.99

2009-08-04T23:48:57Z

KTL: /* Acceleration */

BZFlag version 3.0 is the next planned release of BZFlag.

==Overview==
Version 3.0 is currently in development and marked as version v2.99.x. Upon release it will be marked as version v3.0. The primary goals for this version are improved server side stability and security in an effort to minimize the impact of clients that have been modified to provide their users benefit ( aka, cheating ). Additional efforts are being made to extend the server side customization of the game. v3.0 will be completely incompatible with all previous versions of the game. Users of v3.0 will only be able to play on 3.0 servers. This is similar to how v2.0 was incompatible with 1.10.

==Development==
Development began on 3.0 on October 25th 2005. After an initial rush of changes, development stalled, as a number of bugs were found in the current release build of the time ([[BZFlag 2.0.4|v2.0.4]]). These bugs and problems, as well as a number of graphical changes from [[trepan]] necessitated the release of compatible [[BZFlag 2.0.6|v2.0.6]], [[BZFlag 2.0.8|v2.0.8]], and [[BZFlag 2.0.10|v2.0.10]] releases.

==Version Number Change==
v3.0 is the first version to use the new version numbering system. The 3.0 release initially began as the 2.1 development line, with the intent of being released as version 2.2. Part of the way through development, however, the [[Versions|versioning]] number scheme changed and the development revision changed from 2.1 to 2.99. With previous releases the minor version number in the version triplet (major.minor.revision) represented protocol and client compatibility. With 3.0 compatibility is instead reflected in the major version number. This new scheme gives more "room" to deal with minor packaging revisions and patch release updates.

==Features==
v3.0 has a number of features that make for a much improved gameplay experience.

===Fonts===
The font system has been replaced and now uses standard TrueType fonts([http://en.wikipedia.org/wiki/TrueType TTF]). This offers a number of advantages over the older bitmap based font system, including support for unicode character sets.

Users can now set the default fonts that they wish to use on a per-locale basis so they can use the best fonts for their character set. (More info on how?)

===Server Side Logic===
A number of gameplay features have been moved from the client to the server, to ensure more consistent gameplay over the internet, including;
* Flag operations (pickup, capture, identify, etc)
* Pause/unpause
* Shot type

===Game state and security checks===
Many changes and enhancements have been made to the network protocol to prevent errors in the network message stream or shared game state.

===BZW Format===
*Links can now be included in groups, with relative naming.
*Mesh faces can now be used as teleportation link sources (with numerous options)
*Mesh faces can now be used as team bases (must be flat tops).
*Mesh faces can now be used as zones (must be flat tops).
*Meshes can now contain weapon objects.
*World Text objects have been added (with numerous options)
*Dynamic Colors now use a simpler format.
*Solid objects can now specify the 'ricochet' property individually.

===Graphics===
Changes have been made to the graphical quality settings. What was Experimental quality in 2.0.12 is now High quality. Medium quality is between the old High and Medium, and Low has remained mostly unchanged.

The new Experimental mode includes new shot and flag graphics.

===New Server List===
The list of servers has been enhanced to allow tabbed browsing as well as improved searching and sorting.

===HUD Markers===
If HUD markers showing flag position, GM lockon are now shown to players. THe name and team of the closest target is also shown, helping prevent teamkills. Servers can turn off this feature for all players if desired.

===BZFS API===
The [[BZFS API]] has been reviewed and re-factored for 3.0 and includes a number of new events and functions.

====Server Side Players====
The API has experimental support for server side players (bots).

====Custom Flag Names====
The API may define new custom flag names using any strings desired. The ammount of logic that can be processed for custom flags is limited.

====HTTP based plug-ins====
The networking system for BZFS now allows for the support of HTTP (and other ) connections. A number of plugins have been made to take advantage of this new feature, such as;
* [[Fastmap]]
* [[Webadmin]]
* [[Webreport]]
* [[Webstats]]

====BZFS API Versioning====
The versioning system in the BZFS API has been redone, and now event data classes are versioned for forward computability. Custom plug-ins that were written for v2.0.x must be updated to use the new classnames before they will work with v3.0.x. This should only be a one time change as the new classes are versioned and will remain the same in future releases. All standard plug-ins that ship with the bzflag source code have been updated.

===Lua BZFS API===
The lua scripting language (http://lua.org), is now built into the bzfs executable, and exposes almost all of the features from the C++ BZFS API (and a few that the C++ API does not have). It has the advantages of being easier to learn and write than comparable C++ code, and it can be embedded in world files. The main disadvantage is that it is not as fast as native c++ code.

===Server Administration===
Some changes have been made to help you server administrators.

The [[Webadmin]] plug-in allows server owners to manage many aspects of the server from a standard web browsers.

====Local Authentication====
Local authentication ( '''/identify''' ), has been removed from the game, servers can use global authentication services for all authentication needs.

===Gameplay Changes===
A number of changes have been made to the game that will subtly affect gameplay.
====Acceleration====
Tank acceleration is now always on. The "-a" server option has been removed, and the acceleration values are pulled from BZDB variables. These variables are _inertiaLinear and _inertiaAngular.

====Lag Compensation====
Clients now use a synced timestmap and attempt to compensate tank positions for lag. This can change the way the game feels for players that are used to "leading" the target based on it's lag.

====Hit Volume====
The volume that defines a "hit" on a tank has been changed. It is now a box around the tank that can be adjusted by the server using BZDB variables.

====No TK Option====
A server can define an option that will allow players to not be killed if a team-mates shot hits them

===Build System===
Much effort has been put into making the bzflag source tree easier to compile on various OSs. The makefile build system has been updated and attempts to detect as many items as possible from the host System. The windows build system has been updated to be compatible with Visual Studio 2008 Express Edition that is freely available. When possible, copies of third party libraries are included with the source code.

===Bug Fixes===
A student is being paid as part of the Google Summer of Code program to evaluate and fix the backlog of reported bugs in the software. This will have the overall effect of increasing the stability of the game.

===ChangeLog===
A full list of changes can be found in the [http://bzflag.svn.sourceforge.net/viewvc/*checkout*/bzflag/trunk/bzflag/NEWS NEWS] file in the [[BZFlag Source]] code in [[BZFlag SVN|SVN]].

==Known Issues==
A lot of stuff needs testing, and probably doesn't work.

==Release Date==
As is always the case for major updates to BZFlag, '''''3.0 will be released when it is done'''''. At present, a major effort is being made to release sometime in the third quarter of the year.

==Misconceptions about V3.0==
There have been a few misconceptions in the community regarding what this new version will and will not do. Most of this is simply due to the exceptionally long development time, or comments being taken out of context.

'''V3 will do everything Server Side, including shots'''

This is untrue. While more things have been moved to the server, shoots and hits are still handled by the client. Shots and hits will not be moved to the server until the code can be shown to maintain the level of response time that players have come to expect.

'''V3 will use more bandwith and be laggy'''

V3 does a better job of handling network traffic to and from players. Many messages have been reduced in size. Server side handling of some events, (like flag grabs) have actually removed some messages from the network stream. Network performance should be similar to V2.x. In some cases, lag compensation may even improve apparent performance.

==See also==
[[Versions]]

[[V3RCChecklist]]

[[Category:Versions]]