hurt #

Prototypevoid hurt(int active_sprite, int damage)

hurt() damages active_sprite with damage amount of damage. Note that it will damage an exact amount, but it does take defense into account. Also, there is still a chance of 1 damage if the defense of active_sprite is higher than int damage.

If the active_sprite receives damage, blood spurts are added, free of charge.

This function will trigger the hit() procedure of active_sprite (even if no damage is dealt), unless active_sprite is set to nohit

hurt() can be used to add damage to a previous attack, and the engine will treat it all as one attack (This will even cause only one damage text sprite to appear with hurt factored in).
For this to work, hurt() must be run inside a sprite's hit procedure, before any function that causes the script to "yield the floor", such as wait(), say(), say_stop(), or similar commands.

If using it this way, you must briefly enable nohit for the active_sprite, run the hurt command, and then disable nohit again, otherwise hurt will trigger the hit procedure again, looping it infinitely.

This is much simpler than it sounds, and visualised below in DinkC format, you can see it has it's useful applications. In this example we are giving a random chance for a critical hit, which will add to the damage dealt by the player:

//script attached to an editor place enemy. 
//Hitpoints, brain, base walk and touch damage have been set in the editor.

void main(void)
{
 //declaring local variable required for critical hit chance
 int &crit;
}

void hit(void)
{
 //Give a 1 in 10 chance of critical hit. 
 &crit = random(10, 1);
 if (&crit == 1)
 {
  //get a random value between 5 and 10 to add as critical damage bonus
  &crit = random(6, 5);

  //briefly disable nohit so hurt doesn't trigger the hit procedure again
  //this brief change is too quick to affect or interrupt anything else, so this is safe to do.
  sp_nohit(&current_sprite, 1);
  
  //apply the extra damage using hurt()
  hurt(&current_sprite, &crit);
  
  //disable nohit again
  sp_nohit(&current_sprite, 0);
 }
}