Added 'punch2' 'shoot' animations, 'double_melee_attack' flag and tweaks to api

1 files changed, 18 insertions, 11 deletions

diff --git a/api.txt b/api.txt
index 93c4500..475b9a0 100644
--- a/api.txt
+++ b/api.txt
@@ -80,6 +80,7 @@ This functions registers a new mob as a Minetest entity.
             'explode' follows player in range and will flash and explode when in reach
             'dogshoot' shoots arrows when in range and one on one attack when in reach
         'custom_attack' is a function that is called when mob is in range to attack player, parameters are (self, to_attack)
+        'double_melee_attack' if false then api will choose randomly between 'punch' and 'punch2' attack animations
         'on_blast' is called when TNT explodes near mob, function uses (object, damage) and returns (do_damage, do_knockback, drops)
         'explosion_radius' radius of explosion attack (defaults to 1)
         'arrow' if the attack_type is "shoot" or "dogshoot" then the entity name of the arrow is required
@@ -97,17 +98,23 @@ This functions registers a new mob as a Minetest entity.
             'explode' sound when exploding
             'distance' maximum distance sounds are heard from (default is 10)
         'animation' a table with the animation ranges and speed of the model
-            'stand_start'
-            'stand_end'
-            'walk_start'
-            'walk_end'
-            'run_start'
-            'run_end'
-            'punch_start'
-            'punch_end'
-            'speed_normal'
-            'speed_run' used when mob runs behind player to make animation faster
-            'speed_punch' used when mob punches player to make animation faster
+            'stand_start' start frame of stand animation
+            'stand_end' end frame of stand animation
+            'walk_start' start frame of walk animation
+            'walk_end' end frame of walk animation
+            'run_start' start frame of run animation
+            'run_end' end frame of run animation
+            'punch_start' start frame of punch animation
+            'punch_end' end frame of punch animation
+            'punch2_start' start frame of alt.punch animation
+            'punch2_end' end frame of alt.punch animation
+            'shoot_start' start frame of shoot animation
+            'shoot_end' end frame of shoot animation
+            'speed_normal' normal animation speed
+            'speed_run' running animation speed
+            'speed_punch' punching animation speed
+            'speed_punch2' alternative punching animation speed
+            'speed_shoot' shooting animation speed
         'replace_what' group if items to replace e.g. {"farming:wheat_8", "farming:carrot_8"}
         'replace_with' replace with what e.g. "air" or in chickens case "mobs:egg"
         'replace_rate' how random should the replace rate be (typically 10)