This wiki is archived and useful information is being migrated to the main bzflag.org website
Difference between revisions of "Teleporter"
m (Added History, added categories, put in some misc. information.) |
(→Code: added wiki table) |
||
(34 intermediate revisions by 11 users not shown) | |||
Line 1: | Line 1: | ||
− | A Teleporter is a [[BZW]] map structure that defines a object which transports the user to another teleporter in a different part of the world/map. | + | A [[Teleporter]] is a [[BZW]] map structure that defines a object which transports the user to another teleporter in a different part of the world/map. |
+ | To be used effectively, one or more teleporters must be combined with [[link|links]]. | ||
==Code== | ==Code== | ||
+ | [[Image:Teleporter.jpg|frame|right|Teleporter with the default textures]] | ||
The code for a teleporter object is as follows | The code for a teleporter object is as follows | ||
{| | {| | ||
| | | | ||
− | teleporter | + | teleporter example_teleporter_name |
− | + | ||
position 0.0 0.0 0.0 | position 0.0 0.0 0.0 | ||
− | size | + | size 0.125 5 20 |
rotation 0.0 | rotation 0.0 | ||
border 1.12 | border 1.12 | ||
end | end | ||
|} | |} | ||
+ | |||
Valid parameters for a teleporter are | Valid parameters for a teleporter are | ||
− | + | {|{{Prettytable}} | |
− | + | |- | |
− | + | | {{Hl3}} |'''Parameter''' | |
− | + | | {{Hl3}} |'''Description''' | |
− | + | |- | |
+ | | '''name''' || defines a name for the teleport (3.0+ only - put the name after the word 'teleporter' in 2.0). This is used when [[Link|linking]] teleporters together. | ||
+ | |- | ||
+ | | '''position''' || defines the center of the teleporter in X and Y and the bottom of the teleporter in Z. | ||
+ | |- | ||
+ | | '''rotation''' || defines a rotation around the Z axis for the teleporter, in degrees. | ||
+ | |- | ||
+ | | '''size''' || defines the distance from the center to the side of the teleporter in X and Y, and the total height of the teleporter in Z. | ||
+ | |- | ||
+ | | '''border''' || defines the yellow caution border around the teleporter entry point. | ||
+ | |} | ||
− | Note: Teleporters are entered through | + | Note: Teleporters are entered through X. As such, it is recommended to keep X fairly small (.125 works well). However, if X is zero, it will cause BZFlag bugs. If you need to enter a teleport from Y, rotating it 90 degrees is the suggested solution. X shouldn't be larger than the border size either, or else the shimmering portal will extend outside the teleporter frame, and create an invisible wall in between. Teleports are 2-sided, not 4. |
− | == | + | ==Appearance== |
Teleporters appear with a yellow/black caution texture on the outer border of the object and with a pulsing texture in the middle. | Teleporters appear with a yellow/black caution texture on the outer border of the object and with a pulsing texture in the middle. | ||
+ | |||
+ | #Teleporters may be textured with a magic material name , LinkMaterial. | ||
+ | #There is no need for "matref LinkMaterial" in the teleporter definition. | ||
+ | |||
+ | dynamicColor | ||
+ | name LinkDynCol | ||
+ | red limits 0 0.25 | ||
+ | red sinusoid 2 0 1 | ||
+ | green limits 0 0.25 | ||
+ | green sinusoid 2 0.666667 1 | ||
+ | blue limits 0 0.25 | ||
+ | blue sinusoid 2 1.33333 1 | ||
+ | alpha limits 0.75 0.75 | ||
+ | end | ||
+ | textureMatrix | ||
+ | name LinkTrix | ||
+ | shift 0 -0.05 | ||
+ | center 0 0 | ||
+ | end | ||
+ | material | ||
+ | name LinkMaterial | ||
+ | nolighting | ||
+ | addtexture telelink.png | ||
+ | texmat LinkTrix | ||
+ | dyncol LinkDynCol | ||
+ | end | ||
==History== | ==History== | ||
− | The teleporters first appeared in | + | The teleporters first appeared in BZFlag 1.0.0. In [[BZFlag 2.0.0]], they were redesigned, introducing the name field, making link creation easier for designers. |
==Editor Support== | ==Editor Support== | ||
Supported by all known editors. | Supported by all known editors. | ||
+ | |||
[[category:Map Making]] | [[category:Map Making]] | ||
[[category:Map Objects]] | [[category:Map Objects]] |
Latest revision as of 03:47, 3 December 2016
A Teleporter is a BZW map structure that defines a object which transports the user to another teleporter in a different part of the world/map. To be used effectively, one or more teleporters must be combined with links.
Contents
Code[edit]
The code for a teleporter object is as follows
teleporter example_teleporter_name position 0.0 0.0 0.0 size 0.125 5 20 rotation 0.0 border 1.12 end |
Valid parameters for a teleporter are
Parameter | Description |
name | defines a name for the teleport (3.0+ only - put the name after the word 'teleporter' in 2.0). This is used when linking teleporters together. |
position | defines the center of the teleporter in X and Y and the bottom of the teleporter in Z. |
rotation | defines a rotation around the Z axis for the teleporter, in degrees. |
size | defines the distance from the center to the side of the teleporter in X and Y, and the total height of the teleporter in Z. |
border | defines the yellow caution border around the teleporter entry point. |
Note: Teleporters are entered through X. As such, it is recommended to keep X fairly small (.125 works well). However, if X is zero, it will cause BZFlag bugs. If you need to enter a teleport from Y, rotating it 90 degrees is the suggested solution. X shouldn't be larger than the border size either, or else the shimmering portal will extend outside the teleporter frame, and create an invisible wall in between. Teleports are 2-sided, not 4.
Appearance[edit]
Teleporters appear with a yellow/black caution texture on the outer border of the object and with a pulsing texture in the middle.
#Teleporters may be textured with a magic material name , LinkMaterial. #There is no need for "matref LinkMaterial" in the teleporter definition. dynamicColor name LinkDynCol red limits 0 0.25 red sinusoid 2 0 1 green limits 0 0.25 green sinusoid 2 0.666667 1 blue limits 0 0.25 blue sinusoid 2 1.33333 1 alpha limits 0.75 0.75 end textureMatrix name LinkTrix shift 0 -0.05 center 0 0 end material name LinkMaterial nolighting addtexture telelink.png texmat LinkTrix dyncol LinkDynCol end
History[edit]
The teleporters first appeared in BZFlag 1.0.0. In BZFlag 2.0.0, they were redesigned, introducing the name field, making link creation easier for designers.
Editor Support[edit]
Supported by all known editors.