This wiki is archived and useful information is being migrated to the main bzflag.org website

Editing Wwzones

Jump to: navigation, search

Warning: The database has been locked for maintenance, so you will not be able to save your edits right now. You may wish to copy and paste your text into a text file and save it for later.

The administrator who locked it offered this explanation: Archived wiki

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
Latest revision Your text
Line 1: Line 1:
#REDIRECT [[Plug-ins]]
+
Wwzones is a standard [[Plug-ins|plug-in]] that is shipped with the [[BZFlag Source]] code. The plugin fires a map defined world weapon whenever a player is in a map defined volume.
 +
 
 +
It can be used for landmines, booby traps, clearing campers in difficult locations, general amusement, etc.
 +
 
 +
Multiple zones with different weapons, etc. may be used in same map file.
 +
 
 +
=Usage=
 +
 
 +
The general form of a wwzone [[BZW]] map entry looks like the following:
 +
 +
wwzone
 +
  cylinder <X> <Y> <Zmin> <Zmax> <radius>
 +
  zoneweapon <flagType> <lifetime> <X> <Y> <Z> <tilt> <direction> <shotID> <nowiki><DT></nowiki>
 +
  playermessage <message>
 +
  servermessage <message>
 +
  infomessage
 +
  repeat <seconds>
 +
  timedelay <seconds>
 +
end
 +
 
 +
or with a bbox instead of a cylinder
 +
 
 +
wwzone
 +
  bbox <Xmin> <Xmax> <Ymin> <Ymax> <Zmin> <Zmax>
 +
  zoneweapon <flagType> <lifetime> <X> <Y> <Z> <tilt> <direction> <shotID> <nowiki><DT></nowiki>
 +
  playermessage <message>
 +
  servermessage <message>
 +
  infomessage
 +
  repeat <seconds>
 +
  timedelay <seconds>
 +
end
 +
 
 +
=Parameters=
 +
 
 +
===bbox / cylinder===
 +
 
 +
 
 +
These define the volume on the map that will trigger a world weapon whenever players enter it.
 +
 
 +
bbox <Xmin> <Xmax> <Ymin> <Ymax> <Zmin> <Zmax>
 +
 
 +
or
 +
 
 +
cylinder <X> <Y> <Zmin> <Zmax> <radius>
 +
 
 +
===zoneweapon===
 +
 
 +
This defines the world weapon.<br />
 +
 
 +
zoneweapon <flagType> <lifetime> <X> <Y> <Z> <tilt> <direction> <shotID> <nowiki><DT></nowiki>
 +
 
 +
 +
<properties>
 +
flagType=The [http://bzflag.org/documentation/flags FlagCode] of the weapon to be used.  This must be a valid weapon.
 +
lifetime=Defines the lifetime of the weapon's shots in seconds.
 +
X Y Z=The position of the weapon.  The xy-plane is the ground, and z is up.
 +
tilt=The tilt of the weapon, measured from the ground.  Units are degrees.
 +
direction=Defines the direction of the weapon in the xy-plane (the ground).  Units are degrees.
 +
shotID=All shots have an integer ID.  This is the ID to be used for this shot.  If this is 0, a shot ID will be automatically generated.
 +
DT= Defines the initial delay time of the world weapon in seconds.
 +
</properties>
 +
 
 +
===playermessage===
 +
 
 +
If used (optional), this sends a custom message to a player when he or she triggers the world weapon.
 +
 
 +
  playermessage "your message here"
 +
 
 +
===servermessage===
 +
 
 +
If used (optional), this sends a custom message to all players when a world weapon is triggered.
 +
 
 +
servermessage "your message here"
 +
 
 +
===infomessage===
 +
 
 +
If used (optional), this will issue a standard message to all players, stating which type of world weapon was triggered by whom.  This message cannot be customized.
 +
 
 +
infomessage
 +
 
 +
===repeat===
 +
 
 +
If used (optional), this will repeat weapon fire while a player is in the defined volume.  The parameter <seconds> defines the repeat time of the weapon (minimum 0.1 seconds).  If <seconds> not specified, the default is 0.5 seconds.  If repeat is not included in definition, the weapon will only fire once when a player enters the zone.
 +
 
 +
repeat <seconds>
 +
 
 +
===timedelay===
 +
If used (optional), this will delay the initial fire of the world weapon by the specified number of seconds.
 +
 
 +
timedelay <seconds>
 +
 
 +
=Examples=
 +
 
 +
In the following example, a cuboid-shaped wwzone with the dimensions 50 x 50 x 1 and centered at (-50, 50, 1) is created.  If a player remains in the defined zone for at least two seconds, a [[ShockWave]] weapon will fire in (approximately) 0.25 second intervals thereafter.  The [[ShockWave]] world weapon is positioned at the coordinates (0, 0, 1), and the message, "You triggered Shockwave!" will be sent to the player who triggers it.
 +
{|
 +
|
 +
wwzone
 +
  bbox -80 -30 -80 -30 0 2
 +
  zoneweapon SW 1 0 0 1 0 0 0 0
 +
  playermessage "You triggered Shockwave!
 +
  repeat .25
 +
  timedelay 2
 +
end
 +
|}
 +
 
 +
This will fire a laser in 0.5 second intervals while a player is in the volume defined by the bbox.  In this example, the volume is a rectangular box with the dimensions 50 x 50 x 1 centered at the coordinates (50, 50, 1).  The laser is positioned at the coordinates (5, 5, 1) and is tilted up 45 degrees from the xy-plane (the ground) with a heading of 25 degrees.  When initially triggered, the message, "Laserz rule!" is sent to all players.
 +
{|
 +
|
 +
wwzone
 +
  bbox 30 80 30 80 0 2
 +
  zoneweapon L 1 5 5 1 45 25 0 0
 +
  servermessage "Laserz rule!"
 +
  repeat
 +
end
 +
|}
 +
 
 +
In this example, a cylindrical wwzone that fires a Guided Missile is defined.  The defined volume has a radius of 20 [[World units]], a height of six, and is centered at the coordinates (50, -50, 3).  The weapon is centered at (0, 0, 1) with both the tilt and heading set to 0 degrees.  If a player remains in this volume for one second, the weapon will fire only once, and when it is triggered, the message, "GM triggered by <callsign>" is sent to all players.
 +
{|
 +
|
 +
wwzone
 +
  cylinder 50 -50 0 6 20
 +
  zoneweapon GM 1 0 0 1 0 0 0 0
 +
  infomessage
 +
  timedelay 1
 +
end
 +
|}
 +
 
 +
=External Links=
 +
* http://my.bzflag.org/bb/viewtopic.php?f=79&t=9949&p=98931&hilit=wwzones#p98931 Wwzones plugin page.
 +
 
 +
[[Category:Development]]
 +
[[Category:Plug-Ins]]

Please note that all contributions to BZFlagWiki may be edited, altered, or removed by other contributors. If you do not want your writing to be edited mercilessly, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource (see BZFlagWiki:Copyrights for details). Do not submit copyrighted work without permission!

To edit this page, please answer the question that appears below (more info):

Cancel | Editing help (opens in new window)