#summary List of all gear types

This is a list of (hopefully) all gear types, along with a short description and the meaning of severval fields.

The columns “Pos”, “Tag”, “Timer” and “Health” show the meaning of the gear’s field for the listed gear type. The word “ignored” means that the field in question is not relevant to gears of the gear type. See also `GetGearPos`, `SetGearPos`, `GetTag`, `SetTag`, `GetTimer`, `SetTimer`, `GetHealth`, `SetHealth` in [LuaAPI].

Please note this list is still mostly TODO. The categories presented here are purely for a better overview here; they do not neccessarily reflect anything in the actual game’s source code.

== List of gear types ==

=== Land objects ===

This is a list of gears which usually stay on the land for a long time and stay for several rounds and can’t normally directly placed by players.

|| *Gear type* || *Description* || *Pos* || *Tag* || *Timer* || *Health* ||

|| `gtCase` || An ammo, utility or health crate || crate type: 1=ammo crate, 2=health crate, 4=utility crate || _ignored_ || Used for appear animation || Amount of health contained in a health crate ||

|| `gtExplosives` || An explosive barrel || _ignored_ || _ignored_ || _ignored_ || Barrel health; takes damage like a hedgehog. Starts at 60, explodes at 0. ||

|| `gtFlake` || A snowflake which might become part of the terrain || TODO || TODO || TODO || TODO ||

|| `gtFlame` || A flame || TODO || between 0-32 (TODO) || TODO || TODO ||

|| `gtGrave` || A grave from a dead hedgehog || _ignored_ || _ignored_ || _ignored_ || Used when being resurrected. ||

|| `gtHedgehog` || A hedgehog || TODO || used for animation. `0` = no animation plays. Other value: animation plays || TODO || Hedgehog's health ||

|| `gtPortal` || A portal from the portable portal device || _ignored_ || Portal state. 0=orange flying, 1=orange placed, 2=blue flying, 3=blue placed  || Remaining existance time (portals will disappear after end of turn). || TODO ||

|| `gtTarget` || A target, useful in target practice missions || TODO || TODO || TODO || TODO ||

=== Utilities ===

A list of “utility” gears.

|| *Gear type* || *Description* || *Pos* || *Tag* || *Timer* || *Health* ||

|| `gtGirder` || A girder (construction) || TODO || TODO || TODO || TODO ||

|| `gtJetpack` || A flying saucer || TODO || TODO || TODO || Amount of fuel. `2000` denotes 100% fuel. ||

|| `gtLandGun` || The land spray tool || TODO || power of land spray (`5`-`20`) || TODO || Amount of fuel. `1000` denotes 100% fuel. ||

|| `gtParachute` || A parachute || TODO || TODO || TODO || TODO ||

|| `gtResurrector` || Resurrection || TODO || TODO || TODO || TODO ||

|| `gtRope` || A rope || TODO || Rope style: 0=classic white segments, 1=simple line which can be colored with `SetGearValues` tint || TODO || TODO ||

|| `gtSwitcher` || Switch hedgehog || TODO || TODO || TODO || TODO ||

|| `gtTardis` || A !TimeBox || TODO || TODO || TODO || TODO ||

|| `gtTeleport` || Teleportation || TODO || TODO || TODO || TODO ||

=== Weapons and main projectiles ===

List of weapons which can be directly used or launched by the players.

If not noted otherwise, all times are in milliseconds.

|| *Gear type* || *Description* || *Pos* || *Tag* || *Timer* || *Health* ||

|| `gtAirAttack` || The airplane of an airborne attack || Type of airborne attack: 0=Air Attack, 1=Mine Strike, 2=Napalm, 3=Drill Strike || Direction of airplane (`-1` = left, `1` = right) || TODO || Number of bombs left (default: 6) ||

|| `gtAirMine` || An air mine || Air friction. Higher values mean slower movement || TODO || Detonation timer (after activation). || TODO ||

|| `gtBallGun` || A ballgun || TODO || TODO || Remaining usage time, default is 5001. One ball is fired every 100ms. || TODO ||

|| `gtBee` || Homing bee || TODO || wheather the bee is underwater (`0` = no, `1` = yes) || Used for pre-homing time and max. flight timer after started homing || TODO ||

|| `gtBirdy` || Birdy || TODO || facing direction (`-1` = left, `1` = right) || TODO || “Flapping energy” left, default is 2000. This “energy” works exactly like for the flying saucer. ||

|| `gtBlowTorch` || A blowtorch || TODO || TODO || Remaining usage time in ms, default is 7500. || TODO ||

|| `gtClusterBomb` || A cluster bomb || TODO || TODO || TODO || TODO ||

|| `gtCake` || A cake || TODO || A timer used for several animations. The final animation (sit down) will cause the cake to explode when the tag reaches `2250`. || TODO || Remaining walking time, default is 2048. Note: the cake uses its own time unit. ||

|| `gtDEagleShot` || A shot from a Desert Eagle || TODO || TODO || TODO || How deep the bullet digs into land. Default: 50. ||

|| `gtDrill` || Drill rocket || TODO || Used for drill strike. If `1`, then first impact occoured already || Detonation timer || TODO ||

|| `gtDynamite` || A dynamite || TODO || Displayed animation frame. || Detonation timer. Default: 5000 || TODO ||

|| `gtFirePunch` || Shoryuken || TODO || Y coordinate || TODO || TODO ||

|| `gtFlamethrower` || A flamethrower || TODO || power of flamethrower (`5`-`20`) || TODO || Remaining fuel. `500` is for 100% fuel. ||

|| `gtGasBomb` || An old limburger || TODO || TODO || Detonation timer. || TODO ||

|| `gtGrenade` || A grenade || TODO || TODO || Detonation timer. || TODO ||

|| `gtHammer` || A hammer || TODO || TODO || TODO || TODO ||

|| `gtHellishBomb` || A hellish hand-grenade || TODO || TODO || Detonation timer. Default: 5000 || TODO ||

|| `gtIceGun` || A freezer || TODO || TODO || TODO || Remaining fuel. `1000` is for 100% fuel ||

|| `gtKamikaze` || An ongoing kamikaze || TODO || TODO || TODO || Remaining travel range. Default: 2048 ||

|| `gtKnife` || A cleaver || TODO || TODO || TODO || TODO ||

|| `gtPiano` || Piano from piano strike || Number of remaining terrain bounces. Default: 5 || TODO || TODO || TODO ||

|| `gtPickHammer` || A pickhammer || TODO || TODO || Remaining usage time. Default: 4000 || TODO ||

|| `gtRCPlane` || A RC plane || TODO || dX speed??? || Remaining fly time. Default: 15000 || Number of missiles on board. Default: 3 ||

|| `gtMolotov` || A molotov cocktail || TODO || TODO || TODO || TODO ||

|| `gtMortar` || A mortar || TODO || TODO || TODO || TODO ||

|| `gtMine` || A mine || TODO || TODO || Detonation timer (after activation). || If `0`, mine is a dud. ||

|| `gtSeduction` || Seduction || TODO || TODO || TODO || TODO ||

|| `gtShell` || A bazooka shell (projectile) || TODO || TODO || TODO || TODO ||

|| `gtShotgunShot` || A shot from a shotgun || TODO || TODO || TODO || TODO ||

|| `gtShover` || Used by baseball bat. || TODO || TODO || TODO || TODO ||

|| `gtSineGunShot` || A shot from the sine gun || TODO || TODO || TODO || TODO ||

|| `gtSMine` || A sticky mine || TODO || TODO || Detonation timer after it was activated. Default: 500 || TODO ||

|| `gtSniperRifleShot` || A shot from the sniper rifle || TODO || TODO || TODO || How deep the bullet digs into land. Default: 50 ||

|| `gtSnowball` || A mudball || TODO || TODO || TODO || TODO ||

|| `gtWatermelon` || A watermelon bomb, still intact || TODO || TODO || Detonation timer. || TODO ||

|| `gtWhip` || A whip || TODO || TODO || TODO || TODO ||

=== Secondary projectiles ===

Projectiles that can’t be directly fired but are generated by other weapon gears.

|| *Gear type* || *Description* || *Pos* || *Tag* || *Timer* || *Health* ||

|| `gtAirBomb` || A bomb from the air attack or the RC plane || TODO || TODO || TODO || TODO ||

|| `gtBall` || A ball from the ball gun || TODO || Color: `0a=red, `1`=green, `2`=cyan, `3`=yellow, `4`=violet, `5`=pink, `6`=orange, `7`=lime, `8`=white || Detonation timer. Default: 5s || TODO ||

|| `gtCluster` || A cluster from the cluster bomb or the mortar || TODO || TODO || TODO || TODO ||

|| `gtEgg` || An egg from Birdy || TODO || TODO || TODO || TODO ||

|| `gtHammerHit` || A hit from the hammer. || TODO || TODO || How deep a successful hammer hit dig into land. Default: 125 || TODO ||

|| `gtMelonPiece` || A cluster from a watermelon bomb || TODO|| TODO || TODO || TODO ||

|| `gtNapalmBomb` || A bomb from the napalmn strike, will burst into fire || TODO || TODO || TODO || TODO ||

|| `gtPoisonCloud` || A poisonous cloud, makes hedgehogs sick on contact || TODO || TODO || Remaining “life time”, default: 5000 || TODO ||

=== Other ===

|| *Gear type* || *Description* || *Pos* || *Tag* || *Timer* || *Health* ||

|| `gtAddAmmo` || Used to add some weapon or utilty to a hedgehog. The gear is added when a crate has been collected. || TODO || TODO || TODO || TODO ||

|| `gtATStartGame` || TODO || TODO || TODO || TODO || TODO ||

|| `gtATFinishGame` || TODO || TODO || TODO || TODO || TODO ||

|| `gtGenericFaller` || TODO || TODO || TODO || TODO || TODO ||

|| `gtWaterUp` || If added, water will rise. || _ignored_ || Number of pixels the water still has to rise. By default, the tag will have an initial value of `47`. The gear will be removed when the tag equals `0`. || TODO || TODO ||

== Gear-specific variables ==

=== `gtBirdy` ===

The number of eggs is stored in the gear's `FlightTime` (default: 2).

=== `gtFlame` ===

If `FlightTime` is set to 0, the flames can hurt hedgehogs in mid-air, but they won't otherwise.

== Source ==

Here is an excerpt from the Hedgewars source code:

{{{

    TGearType = (gtFlame, gtHedgehog, gtMine, gtCase, gtExplosives, // these gears should be avoided when searching a spawn place

        gtGrenade, gtShell, gtGrave, gtBee, // 8

        gtShotgunShot, gtPickHammer, gtRope, // 11

        gtDEagleShot, gtDynamite, gtClusterBomb, gtCluster, gtShover, // 16

        gtFirePunch, gtATStartGame, // 18

        gtATFinishGame, gtParachute, gtAirAttack, gtAirBomb, gtBlowTorch, // 23

        gtGirder, gtTeleport, gtSwitcher, gtTarget, gtMortar, // 28

        gtWhip, gtKamikaze, gtCake, gtSeduction, gtWatermelon, gtMelonPiece, // 34

        gtHellishBomb, gtWaterUp, gtDrill, gtBallGun, gtBall, gtRCPlane, // 40

        gtSniperRifleShot, gtJetpack, gtMolotov, gtBirdy, // 44

        gtEgg, gtPortal, gtPiano, gtGasBomb, gtSineGunShot, gtFlamethrower, // 50

        gtSMine, gtPoisonCloud, gtHammer, gtHammerHit, gtResurrector, // 55

        gtNapalmBomb, gtSnowball, gtFlake, {gtStructure,} gtLandGun, gtTardis, // 61

        gtIceGun, gtAddAmmo, gtGenericFaller, gtKnife); // 65

}}}

For a current list of the gears look at `hedgewars/uTypes.pas` at

the `TGearType` enumeration.

http://hg.hedgewars.org/hedgewars/file/default/hedgewars/uTypes.pas#l92

Note: `gtBomb` and `gtShell` were named `gtAmmo_Bomb` and `gtAmmo_Grenade` before 0.9.14.