{"name":"getHitPointDamage","operator":null,"title":"getHitPointDamage","type":"command","url":"https://community.bistudio.com/wiki/getHitPointDamage","revid":377769,"updated":"2026-01-03T01:32:16Z","groups":["Object Manipulation"],"status":"ok","replaced_by":[],"games":[{"game":"tkoh","name":"Take On Helicopters","version":"1.00"},{"game":"arma3","name":"Arma 3","version":"0.50"}],"since":{"game":"tkoh","name":"Take On Helicopters","version":"1.00"},"arma3_since":"0.50","branch":null,"locality":{"argument":"global","effect":null,"server_exec":false},"exec":null,"description":"Return current level of damage in range 0..1 for a specific Hit Point (specified by its config class).\nIf you need to get damage of a selection instead of hit point, use getHit.","syntaxes":[{"syntax":"vehicle getHitPointDamage hitPointName","since":null,"effect":null,"exec":null,"params":[{"name":"vehicle","type":"Object","optional":false,"default":null,"description":"vehicle to be queried","types":["Object"],"since":null,"text":"vehicle : Object - vehicle to be queried"},{"name":"hitPointName","type":"String","optional":false,"default":null,"description":"name of the Hit Point class","types":["String"],"since":null,"text":"hitPointName: String - name of the Hit Point class"}],"returns":{"type":"Number","types":["Number"],"description":"before Arma 3 v1.94, Nothing was returned when an invalid selection was provided (now returns `0`)","text":"Number - before Arma 3 v1.94, Nothing was returned when an invalid *selection* was provided (now returns `0`)"},"form":"binary","operator":null,"left":{"text":"vehicle","types":["Object"]},"right":{"text":"hitPointName","types":["String"]}}],"examples":[{"text":"```sqf\nvehicle player getHitPointDamage \"hitEngine\";\n```","code":["vehicle player getHitPointDamage \"hitEngine\";"]}],"multiplayer":null,"problems":null,"aliases":[],"see_also":["setHitPointDamage","getAllHitPointsDamage","setHit","getHit","setDamage","damage","getHitIndex","setHitIndex"],"notes":[{"user":"Joris","date":"2011-11-25T15:06:00Z","text":"Common ObjectRTD Take On Helicopters Hit Points:\n- HitEngine (engine #1)\n- HitEngine2 (engine #2)\n- HitEngine3 (engine #3)\n- HitHRotor (main rotor)\n- HitVRotor (tail rotor)\n- HitBatteries (electrical systems)\n- HitLight (landing light)\n- HitHydraulics (entire hydraulics system)\n- HitTransmission (engine transmission)\n- HitGear (landing gear)\n- HitFuel (all fuel tanks)\n- HitHStabilizerL1 (first left horizontal stabilizer)\n- HitHStabilizerR1 (first right horizontal stabilizer)\n- HitVStabilizer1 (first vertical stabilizer)\n- HitTail (tail boom)\n- HitPitotTube (all pitot tubes)\n- HitStaticPort (all static ports)\n- HitStarter1 (starter for engine #1)\n- HitStarter2 (starter for engine #2)\n- HitStarter3 (starter for engine #3)\n- HitAvionics\n- HitHull\n- HitMissiles\n- HitRGlass\n- HitLGlass\n- HitGlass1\n- HitGlass2\n- HitGlass3\n- HitGlass4\n- HitGlass5\n- HitGlass6"},{"user":"K.J.","date":"2017-03-04T01:29:00Z","text":"Note that vehicles with multiple turrets have multiple HitTurret and HitGun classes that can't be distinguished based on the Hitpoint class name. They can only be distinguished by their selection names.\nThe selection names do not necessarily correspond to a common nomenclature, especially for mod vehicles. There can also be multiple empty Hitpoint Class names on a vehicle or infantry unit.\nThey can be hitpoints for vehicle headlights or be the result of a bad config/model, as hitpoints that have an undefined named selection in their config class or are missing their named selection in the model will result in an empty HitPoint class name."},{"user":"X3KJ","date":"2018-10-05T23:12:00Z","text":"Note: Since arma3tanks DLC, Turrets of vanilla vehicles no longer have identical Hitpoint Classes for multiple Turrets.\nMod vehicles may still have the old issue, but they produces error messages in RPT if they still do (and thus should be enough motivation to fix them)."}],"categories":["Arma 3: Scripting Commands","Command Group: Object Manipulation","Introduced with Take On Helicopters version 1.00","Scripting Commands","Take On Helicopters: New Scripting Commands","Take On Helicopters: Scripting Commands"]}