Function ApplyDamageToPlayer

Descent3/damage.cpp:806–955

Applies damage to a player object, returns false if damage wasn't applied due to things like invunerability

//	Applies damage to a player object, returns false if damage wasn't applied due to things like
//	invunerability
bool ApplyDamageToPlayer(object *playerobj, object *killer, int damage_type, float damage_amount, int server_says,
                         int weapon_id, bool playsound) {
  if (!playerobj || playerobj->type != OBJ_PLAYER) {
    // bail it's not a player (no damage should be applied to ghosts or observer's either
    return false;
  }

  //	apply damage to the current player!
  object *weapon_obj = NULL;

  if (killer != NULL && killer->type == OBJ_WEAPON) {
    weapon_obj = killer;
    killer = ObjGetUltimateParent(killer);

    if (!(Game_mode & GM_MULTI) || ((Game_mode & GM_MULTI) && Netgame.local_role == LR_SERVER))
      weapon_id = weapon_obj->id;
    if ((Game_mode & GM_MULTI) && Netgame.local_role == LR_CLIENT && !server_says && (Netgame.flags & NF_PEER_PEER))
      weapon_id = weapon_obj->id;
  }

  if ((Players[playerobj->id].flags & PLAYER_FLAGS_DYING) || (Players[playerobj->id].flags & PLAYER_FLAGS_DEAD)) {
    PlayPlayerDamageSound(playerobj, damage_type);
    return false;
  }

  if ((Players[playerobj->id].flags & PLAYER_FLAGS_INVULNERABLE) || ((Player_object->flags & OF_DESTROYABLE) == 0)) {
    if (damage_type != PD_NONE)
      PlayPlayerInvulnerabilitySound(playerobj);

    if (weapon_obj != NULL) {
      Players[playerobj->id].invul_magnitude = 1;
      Players[playerobj->id].invul_vector = weapon_obj->pos - playerobj->pos;
      vm_NormalizeVectorFast(&Players[playerobj->id].invul_vector);
    }
    return false;
  } else {
    if (!(Game_mode & GM_MULTI)) {
      damage_amount *= Players[playerobj->id].armor_scalar;
      damage_amount *= Ships[Players[playerobj->id].ship_index].armor_scalar;

      DecreasePlayerShields(playerobj->id, damage_amount);

      if (damage_amount > 0 && playsound)
        PlayPlayerDamageSound(playerobj, damage_type);

      if (Players[playerobj->id].guided_obj != NULL)
        ReleaseGuidedMissile(playerobj->id);

      if (Players[playerobj->id].user_timeout_obj != NULL)
        ReleaseUserTimeoutMissile(playerobj->id);

      if (weapon_id != 255) {
        if (Weapons[weapon_id].flags & WF_MICROWAVE)
          SetDeformDamageEffect(playerobj);
        if (Weapons[weapon_id].flags & WF_FREEZE)
          ApplyFreezeDamageEffect(playerobj);
        if (Weapons[weapon_id].flags & WF_NAPALM)
          SetNapalmDamageEffect(playerobj, killer, weapon_id);