Initial commit

api.txt

@@ -0,0 +1,250 @@
+
+MOB API (28th September 2016)
+
+The mob api is a function that can be called on by other mods to add new animals or monsters into minetest.
+
+    minetest.conf settings*
+
+    'enable_damage' if true monsters will attack players (default is true)
+    'only_peaceful_mobs' if true only animals will spawn in game (default is false)
+    'mobs_disable_blood' if false blood effects appear when mob is hit (default is false)
+    'mobs_spawn_protected' if set to 1 then mobs will not spawn in protected areas (default is 0)
+    'remove_far_mobs' if true then mobs that are outside players visual range will be removed (default is false)
+    'mobname_chance' can change specific mob chance rates or set to 0 to disable e.g. mobs_animal:cow_chance = 1000
+    'mob_difficulty' sets difficulty level (health and hit damage multiplied by this number), defaults to 1.0.
+
+
+mobs:register_mob(name, definition)
+
+This functions registers a new mob as a Minetest entity.
+
+    'name' is the name of the mob (e.g. "mobs:dirt_monster")
+    definition is a table with the following fields
+        'type' the type of the mob ("monster", "animal" or "npc")
+        'passive' will mob defend itself, set to false to attack
+        'docile_by_day' when true, mob will not attack during daylight hours unless provoked
+        'attacks_monsters' usually for npc's to attack monsters in area
+        'group_attack' true to defend same kind of mobs from attack in area
+        'attack_animals' true for monster to attack animals as well as player and npc's
+        'attack_specific' has a table of entity names that monsters can attack {"player", "mobs_animal:chicken"}
+        'hp_min' minimum health
+        'hp_max' maximum health (mob health is randomly selected between both)
+        'physical' same is in minetest.register_entity()
+        'collisionbox' same is in minetest.register_entity()
+        'visual' same is in minetest.register_entity()
+        'visual_size' same is in minetest.register_entity()
+        'textures' same is in minetest.register_entity()
+            although you can add multiple lines for random textures {{"texture1.png"},{"texture2.png"}}, 
+        'gotten_texture' alt. texture for when self.gotten value is set to true (used for shearing sheep)
+        'child_texture' texture of mod for when self.child is set to true
+        'mesh' same is in minetest.register_entity()
+        'gotten_mesh' alternative mesh for when self.gotten is true (used for sheep)
+        'makes_footstep_sound' same is in minetest.register_entity()
+        'follow' item when held will cause mob to follow player, can be single string "default:apple" or table {"default:apple", "default:diamond"}
+        'view_range' the range in that the monster will see the playerand follow him
+        'walk_chance' chance of mob walking around
+        'jump_chance' chance of mob jumping around, set above to 0 for jumping mob only
+        'walk_velocity' the velocity when the monster is walking around
+        'run_velocity' the velocity when the monster is attacking a player
+        'runaway' when true mob will turn and run away when punched
+        'stepheight' minimum node height mob can walk onto without jumping (default: 0.6)
+        'jump' can mob jump, true or false
+        'jump_height' height mob can jump, default is 6
+        'fly' can mob fly, true or false (used for swimming mobs also)
+        'fly_in' node name that mob flys inside, e.g "air", "default:water_source" for fish
+        'damage' the damage per second
+        'recovery_time' how much time from when mob is hit to recovery (default: 0.5)
+        'knock_back' strength of knock-back when mob hit (default: 3)
+        'immune_to' table holding special tool/item names and damage the incur e.g.
+            {"default:sword_wood", 0}, {"default:gold_lump", -10} immune to sword, gold lump heals
+        'blood_amount' number of droplets that appear when hit
+        'blood_texture' texture of blood droplets (default: "mobs_blood.png")
+        'drops' is list of tables with the following fields:
+            'name' itemname e.g. default:stone
+            'chance' the inverted chance (same as in abm) to get the item
+            'min' the minimum number of items
+            'max' the maximum number of items
+        'armor' the armor (integer)(3=lowest; 1=highest)(fleshy group is used)
+        'drawtype' "front" or "side" (DEPRECATED, replaced with below)
+        'rotate' set mob rotation, 0=front, 90=side, 180=back, 270=other side
+        'water_damage' the damage per second if the mob is in water
+        'lava_damage' the damage per second if the mob is in lava
+        'light_damage' the damage per second if the mob is in light
+        'fall_damage' will mob be hurt when falling from height
+        'fall_speed' speed mob falls (default: -10 and has to be lower than -2)
+        'fear_height' when mob walks near a drop then anything over this value makes it stop and turn back (default is 0 to disable)
+        'on_die' a function that is called when the mob is killed the parameters are (self, pos)
+        'floats' 1 to float in water, 0 to sink
+        'on_rightclick' its same as in minetest.register_entity()
+        'pathfinding' set to 1 for mobs to use pathfinder feature to locate player, set to 2 so they can build/break also (only works with dogfight attack)
+        'attack_type' the attack type of a monster
+            'dogfight' follows player in range and attacks when in reach
+            'shoot' shoots defined arrows when player is within range
+            '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
+	'dogshoot_switch' allows switching between shoot and dogfight modes inside dogshoot using timer (1 = shoot, 2 = dogfight)
+	'dogshoot_count_max' number of seconds before switching above modes.
+        '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
+        'shoot_interval' the minimum shoot interval
+        'shoot_offset' +/- value to position arrow/fireball when fired
+        'reach' how far a reach this mob has, default is 3
+        'sounds' this is a table with sounds of the mob
+            'random' random sounds during gameplay
+            'war_cry' sound when starting to attack player
+            'attack' sound when attacking player
+            'shoot_attack' sound when attacking player by shooting arrow/entity
+            'damage' sound when being hit
+            'death' sound when killed
+            'jump' sound when jumping
+            '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' 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)
+        'replace_offset' +/- value to check specific node to replace
+
+
+The mob api also has some preset variables and functions that it will remember for each mob
+
+    'self.gotten' this is used for obtaining milk from cow and wool from sheep
+    'self.horny' when animal fed enough it is set to true and animal can breed with same animal
+    'self.child' used for when breeding animals have child, will use child_texture and be half size
+    'self.owner' string used to set owner of npc mobs, typically used for dogs
+    'self.order' set to "follow" or "stand" so that npc will follow owner or stand it's ground
+    'on_die' a function that is called when mob is killed
+    'do_custom' a custom function that is called while mob is active and which has access to all of the self.* variables e.g. (self.health for health or self.standing_in for node status), return with 'false' to skip remainder of mob API.
+
+
+mobs:register_spawn(name, nodes, max_light, min_light, chance, active_object_count, max_height, day_toggle)
+
+mobs:spawn_specfic(name, nodes, neighbors, min_light, max_light, interval, chance, active_object_count, min_height, max_height, day_toggle)
+
+These functions register a spawn algorithm for the mob. Without this function the call the mobs won't spawn.
+
+    'name' is the name of the animal/monster
+    'nodes' is a list of nodenames on that the animal/monster can spawn on top of
+    'neighbors' is a list of nodenames on that the animal/monster will spawn beside (default is {"air"} for mobs:register_spawn)
+    'max_light' is the maximum of light
+    'min_light' is the minimum of light
+    'interval' is same as in register_abm() (default is 30 for mobs:register_spawn)
+    'chance' is same as in register_abm()
+    'active_object_count' mob is only spawned if active_object_count_wider of ABM is <= this
+    'min_height' is the maximum height the mob can spawn
+    'max_height' is the maximum height the mob can spawn
+    'day_toggle' true for day spawning, false for night or nil for anytime
+
+... also a simpler way to handle mob spawns has been added with the mobs:spawn(def) command which uses above names to make settings clearer:
+
+    mobs:spawn({name = "mobs_monster:tree_monster",
+       nodes = {"group:leaves"},
+       max_light = 7,
+    })
+
+
+Players can override the spawn chance for each mob registered by adding a line to their minetest.conf file with a new value, the lower the value the more each mob will spawn e.g.
+
+mobs_animal:sheep_chance 11000 or mobs_monster:sand_monster_chance 100
+
+For each mob that spawns with this function is a field in mobs.spawning_mobs. It tells if the mob should spawn or not. Default is true. So other mods can only use the API of this mod by disabling the spawning of the default mobs in this mod.
+
+
+mobs:register_arrow(name, definition)
+
+This function registers a arrow for mobs with the attack type shoot.
+
+    'name' is the name of the arrow
+    -definition' is a table with the following values:
+        'visual' same is in minetest.register_entity()
+        'visual_size' same is in minetest.register_entity()
+        'textures' same is in minetest.register_entity()
+        'velocity' the velocity of the arrow
+        'drop' if set to true any arrows hitting a node will drop as item
+        'hit_player' a function that is called when the arrow hits a player; this function should hurt the player
+            the parameters are (self, player)
+        'hit_mob' a function that is called when the arrow hits a mob; this function should hurt the mob
+            the parameters are (self, player)
+        'hit_node' a function that is called when the arrow hits a node
+            the parameters are (self, pos, node)
+        'tail' when set to 1 adds a trail or tail to mob arrows
+        'tail_texture' texture string used for above effect
+        'tail_size' has size for above texture (defaults to between 5 and 10)
+    'on_step' is a custom function when arrow is active, nil for default.
+
+
+mobs:register_egg(name, description, background, addegg)
+
+This function registers a spawn egg which can be used by admin to properly spawn in a mob.
+
+    'name' this is the name of your new mob to spawn e.g. "mob:sheep"
+    'description' the name of the new egg you are creating e.g. "Spawn Sheep"
+    'background' the texture displayed for the egg in inventory
+    'addegg' would you like an egg image in front of your texture (1=yes, 0=no)
+    'no_creative' when set to true this stops spawn egg appearing in creative mode for destructive mobs like Dungeon Masters
+
+
+mobs:explosion(pos, radius, fire, smoke)
+
+This function generates an explosion which removes nodes in a specific radius and replace them with fire or air. Protection nodes, obsidian and locked chests will not be destroyed although a normal chest will drop it's contents.
+
+    'pos' centre position of explosion
+    'radius' radius of explosion (typically set to 3)
+    'fire' should fire appear in explosion (1=yes, 0=no)
+    'smoke' should smoke appear in explosion (1=yes, 0=no)
+    'sound' sound played when mob explodes
+
+
+mobs:capture_mob(self, clicker, chance_hand, chance_net, chance_lasso, force_take, replacewith)
+
+This function is generally called inside the on_rightclick section of the mob api code, it provides a chance of capturing the mob by hand, using the net or magic lasso items, and can also have the player take the mob by force if tamed and replace with another item entirely.
+
+    'self' mob information
+    'clicker' player information
+    'chance_hand' chance of capturing mob by hand (1 to 100) 0 to disable
+    'chance_net' chance of capturing mob using net (1 to 100) 0 to disable
+    'chance_lasso' chance of capturing mob using magic lasso (1 to 100) 0 to disable
+    'force_take' take mob by force, even if tamed (true or false)
+    'replacewith' once captured replace mob with this item instead
+
+
+mobs:feed_tame(self, clicker, feed_count, breed)
+
+This function allows the mob to be fed the item inside self.follow be it apple, wheat or whatever a set number of times and be tamed or bred as a result.
+
+    'self' mob information
+    'clicker' player information
+    'feed_count' number of times mob must be fed to tame or breed
+    'breed' true or false stating if mob can be bred and a child created afterwards
+    'tame' true or false stating if mob can be tamed so player can pick them up
+
+
+Useful Internal Variables
+
+    'self.health' contains current health of mob
+    'self.texture_list' contains list of all mob textures
+    'self.child_texture' contains mob child texture when growing up
+    'self.base_texture' contains current skin texture which was randomly selected from textures list
+    'self.gotten' true when sheep have been sheared or cows have been milked, a toggle switch which can be used for many functions
+    'self.child' true when mob is currently a child (when two mobs have bred and current mob is the outcome)
+    'self.hornytimer' background timer that controls breeding functions and mob childhood timings

crafts.lua

@@ -0,0 +1,85 @@
+
+local S = mobs.intllib
+
+-- name tag
+minetest.register_craftitem("mobs:nametag", {
+	description = S("Nametag"),
+	inventory_image = "mobs_nametag.png",
+})
+
+core.register_craft({
+	type = "shapeless",
+	output = "mobs:nametag",
+	recipe = {"default:paper", "dye:black", "farming:string"},
+})
+
+-- leather
+minetest.register_craftitem("mobs:leather", {
+	description = S("Leather"),
+	inventory_image = "mobs_leather.png",
+})
+
+-- raw meat
+minetest.register_craftitem("mobs:meat_raw", {
+	description = S("Raw Meat"),
+	inventory_image = "mobs_meat_raw.png",
+	on_use = minetest.item_eat(3),
+})
+
+-- cooked meat
+minetest.register_craftitem("mobs:meat", {
+	description = S("Meat"),
+	inventory_image = "mobs_meat.png",
+	on_use = minetest.item_eat(8),
+})
+
+minetest.register_craft({
+	type = "cooking",
+	output = "mobs:meat",
+	recipe = "mobs:meat_raw",
+	cooktime = 5,
+})
+
+-- golden lasso
+minetest.register_tool("mobs:magic_lasso", {
+	description = S("Magic Lasso (right-click animal to put in inventory)"),
+	inventory_image = "mobs_magic_lasso.png",
+})
+
+minetest.register_craft({
+	output = "mobs:magic_lasso",
+	recipe = {
+		{"farming:string", "default:gold_lump", "farming:string"},
+		{"default:gold_lump", "default:diamondblock", "default:gold_lump"},
+		{"farming:string", "default:gold_lump", "farming:string"},
+	}
+})
+
+-- net
+minetest.register_tool("mobs:net", {
+	description = S("Net (right-click animal to put in inventory)"),
+	inventory_image = "mobs_net.png",
+})
+
+minetest.register_craft({
+	output = "mobs:net",
+	recipe = {
+		{"default:stick", "", "default:stick"},
+		{"default:stick", "", "default:stick"},
+		{"farming:string", "default:stick", "farming:string"},
+	}
+})
+
+-- shears (right click to shear animal)
+minetest.register_tool("mobs:shears", {
+	description = S("Steel Shears (right-click to shear)"),
+	inventory_image = "mobs_shears.png",
+})
+
+minetest.register_craft({
+	output = 'mobs:shears',
+	recipe = {
+		{'', 'default:steel_ingot', ''},
+		{'', 'group:stick', 'default:steel_ingot'},
+	}
+})

depends.txt

@@ -0,0 +1,3 @@
+default
+invisibility?
+intllib?

description.txt

@@ -0,0 +1 @@
+Adds a mob api for mods to add animals or monsters etc.

init.lua

@@ -0,0 +1,13 @@
+
+local path = minetest.get_modpath("mobs")
+
+-- Mob API
+dofile(path.."/api.lua")
+
+-- Mob Items
+dofile(path.."/crafts.lua")
+
+-- Spawner
+-- dofile(path.."/spawner.lua")
+
+print ("[MOD] Mobs Redo loaded")

license.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016 TenPlus1
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

locale/de.txt

@@ -0,0 +1,38 @@
+# German Translation for mobs_redo mod
+# Deutsche Übersetzung der mobs_redo Mod
+# last update: 2016/June/10
+# Author: Xanthin
+
+#init.lua
+[MOD] Mobs Redo loaded = [MOD] Mobs Redo geladen
+
+#api.lua
+[MOBS] mod profiling enabled, damage not enabled = [MOBS] Modanalyse aktiviert, Schaden deaktiviert
+lifetimer expired, removed @1 = Lebensdauer abgelaufen, @1 wurde entfernt
+[Mobs Redo] @1 has spawning disabled = [Mobs Redo] Spawnen von @1 ist deaktiviert
+[Mobs Redo] Chance setting for @1 is now @2 = [Mobs Redo] Wahrscheinlichkeitswert für @1 ist jetzt @2
+[mobs] @1 failed to spawn at @2 = [mobs] @1 konnte nicht bei @2 spawnen
+Not tamed! = Nicht gezähmt!
+@1 is owner! = @1 ist Besitzer!
+Missed! = Verfehlt!
+@1 at full health (@2) = @1 bei voller Gesundheit (@2)
+@1 has been tamed! = @1 ist gezähmt worden!
+Enter name: = Namen eingeben:
+Rename = Umbenennen
+
+#crafts.lua
+Nametag = Namensschild
+Leather = Leder
+Raw Meat = Rohes Fleisch
+Meat = Fleisch
+Magic Lasso (right-click animal to put in inventory) = Magisches Lasso (Rechtsklick auf Tier,\num es ins Inventar zu legen)
+Net (right-click animal to put in inventory) = Netz (Rechtsklick auf Tier,\num es ins Inventar zu legen)
+Steel Shears (right-click to shear) = Stahlschere (Rechtsklick zum Scheren)
+
+#spawner.lua
+Mob Spawner = Mobspawner
+Mob MinLight MaxLight Amount PlayerDist = Mob MinLicht MaxLicht Menge SpielerEntfng
+Spawner Not Active (enter settings) = Spawner nicht aktiv (Einstellungen eintragen)
+Spawner Active (@1) = Spawner aktiv (@1)
+Mob Spawner settings failed! = Mobspawnereinstellungen gescheitert!
+> name min_light[0-14] max_light[0-14] max_mobs_in_area[0 to disable] distance[1-20] y_offset[-10 to 10] = Name min. Licht[0-14] max. Licht[0-14] max. Mobs in Gebiet[0 zum deaktivieren] Entfernung zum Spieler[1-20] Höhe[-10 bis 10]

locale/pt.txt

@@ -0,0 +1,38 @@
+# Portuguese Translation for mobs_redo mod
+# Tradução em Portugues do mod mobs_redo
+# Ultima revisao: 30/Ago/2016
+# Autor: BrunoMine
+
+#init.lua
+[MOD] Mobs Redo loaded = [MOD] Mobs Redo carregado
+
+#api.lua
+[MOBS] mod profiling enabled, damage not enabled = [MOBS] Mod criador de perfis ativado, dano desabilitado
+lifetimer expired, removed @1 = tempo de vida expirado, @1 removido
+[Mobs Redo] @1 has spawning disabled = [Mobs Redo] @1 teve spawn desabilitado
+[Mobs Redo] Chance setting for @1 is now @2 = [Mobs Redo] Chances para @1 agora vai ser @2
+[mobs] @1 failed to spawn at @2 = [mobs] @1 falhou ao spawnar em @2
+Not tamed! = Indomesticado!
+@1 is owner! = Dono @1!
+Missed! = Faltou!
+@1 at full health (@2) = @1 em plena saude (@2)
+@1 has been tamed! = @1 foi domesticado!
+Enter name: = Insira um nome:
+Rename = Renomear
+
+#crafts.lua
+Nametag = Etiqueta
+Leather = Couro
+Raw Meat = Carne crua
+Meat = Carne
+Magic Lasso (right-click animal to put in inventory) = Laço Magico (clique-direito no animal para por no inventario)
+Net (right-click animal to put in inventory) = Net (clique-direito no animal para por no inventario)
+Steel Shears (right-click to shear) = Tesoura de Aço (clique-direito para tosquiar)
+
+#spawner.lua
+Mob Spawner = Spawnador de Mob
+Mob MinLight MaxLight Amount PlayerDist = Mob LuzMinima LuzMaxima Valor DistJogador
+Spawner Not Active (enter settings) = Spawnador Inativo (configurar)
+Spawner Active (@1) = Spawnador Ativo (@1)
+Mob Spawner settings failed! = Configuraçao de Spawnador do Mob falhou!
+> name min_light[0-14] max_light[0-14] max_mobs_in_area[0 to disable] distance[1-20] y_offset[-10 to 10] = > nome luz_min[0-14] luz_max[0-14] max_mobs_na_area[0 para desabilitar] distancia[1-20] y_offset[-10 a 10]

locale/template.txt

@@ -0,0 +1,36 @@
+# Template for translations of mobs_redo mod
+# last update: 2016/June/10
+
+#init.lua
+[MOD] Mobs Redo loaded = 
+
+#api.lua
+[MOBS] mod profiling enabled, damage not enabled = 
+lifetimer expired, removed @1 = 
+[Mobs Redo] @1 has spawning disabled = 
+[Mobs Redo] Chance setting for @1 is now @2 = 
+[mobs] @1 failed to spawn at @2 = 
+Not tamed! = 
+@1 is owner! = 
+Missed! = 
+@1 at full health (@2) = 
+@1 has been tamed! = 
+Enter name: = 
+Rename = 
+
+#crafts.lua
+Nametag = 
+Leather = 
+Raw Meat = 
+Meat = 
+Magic Lasso (right-click animal to put in inventory) = 
+Net (right-click animal to put in inventory) = 
+Steel Shears (right-click to shear) = 
+
+#spawner.lua
+Mob Spawner = 
+Mob MinLight MaxLight Amount PlayerDist = 
+Spawner Not Active (enter settings) = 
+Spawner Active (@1) = 
+Mob Spawner settings failed! = 
+> name min_light[0-14] max_light[0-14] max_mobs_in_area[0 to disable] distance[1-20] y_offset[-10 to 10] = 

mod.conf

@@ -0,0 +1 @@
+name = mobs

readme.MD

@@ -0,0 +1,64 @@
+
+MOBS REDO for MINETEST
+
+Built from PilzAdam's original Simple Mobs with additional mobs by KrupnoPavel, Zeg9, ExeterDad and AspireMint.
+
+
+This mod contains the API only for adding your own mobs into the world, so please use the additional modpacks to add animals, monsters etc.
+
+
+https://forum.minetest.net/viewtopic.php?f=11&t=9917
+
+
+Crafts:
+
+ - Nametag (paper, black dye, string) can be used right-click on a tamed mob to give them a name.
+ - Nets can be used to right-click tamed mobs to pick them up and place inside inventory as a spawn egg.
+ - Magic Lasso is similar to nets but with a better chance of picking up larger mobs.
+ - Shears are used to right-click sheep and return 1-3 wool.
+
+
+Changelog:
+
+- 1.31- Added 'attack_animals' and 'specific_attack' flags for custom monster attacks, also 'mob_difficulty' .conf setting to make mobs harder.
+- 1.30- Added support for invisibility mod (mobs cant attack what they cant see), tweaked and tidied code
+- 1.29- Split original Mobs Redo into a modpack to make it easier to disable mob sets (animal, monster, npc) or simply use the Api itself for your own mod
+- 1.28- New damage system added with ability for mob to be immune to weapons or healed by them :)
+- 1.27- Added new sheep, lava flan and spawn egg textures.  New Lava Pick tool smelts what you dig.  New atan checking function.
+- 1.26- Pathfinding feature added thanks to rnd, when monsters attack they become scary smart in finding you :) also, beehive produces honey now :)
+- 1.25- Mobs no longer spawn within 12 blocks of player or despawn within same range, spawners now have player detection, Code tidy and tweak.
+- 1.24- Added feature where certain animals run away when punched (runaway = true in mob definition)
+- 1.23- Added mob spawner block for admin to setup spawners in-game (place and right click to enter settings)
+- 1.22- Added ability to name tamed animals and npc using nametags, also npc will attack anyone who punches them apart from owner
+- 1.21- Added some more error checking to reduce serialize.h error and added height checks for falling off cliffs (thanks cmdskp)
+- 1.20- Error checking added to remove bad mobs, out of map limit mobs and stop serialize.h error
+- 1.19- Chickens now drop egg items instead of placing the egg, also throwing eggs result in 1/8 chance of spawning chick
+- 1.18- Added docile_by_day flag so that monsters will not attack automatically during daylight hours unless hit first
+- 1.17- Added 'dogshoot' attack type, shoots when out of reach, melee attack when in reach, also api tweaks and self.reach added
+- 1.16- Mobs follow multiple items now, Npc's can breed
+- 1.15- Added Feeding/Taming/Breeding function, right-click to pick up any sheep with X mark on them and replace with new one to fix compatibility.
+- 1.14- All .self variables saved in staticdata, Fixed self.health bug
+- 1.13- Added capture function (thanks blert2112) chance of picking up mob with hand; net; magic lasso, replaced some .x models with newer .b3d one's
+- 1.12- Added animal ownership so that players cannot steal your tamed animals
+- 1.11- Added flying mobs (and swimming), fly=true and fly_in="air" or "deafult:water_source" for fishy
+- 1,10- Footstep removed (use replace), explosion routine added for exploding mobs. 
+- 1.09- reworked breeding routine, added mob rotation value, added footstep feature, added jumping mobs with sounds feature, added magic lasso for picking up animals
+- 1.08- Mob throwing attack has been rehauled so that they can damage one another, also drops and on_die function added
+- 1.07- Npc's can now be set to follow player or stand by using self.order and self.owner variables
+- beta- Npc mob added, kills monsters, attacks player when punched, right click with food to heal or gold lump for drop
+- 1.06- Changed recovery times after breeding, and time taken to grow up (can be sped up by feeding baby animal)
+- 1.05- Added ExeterDad's bunny's which can be picked up and tamed with 4 carrots from farming redo or farming_plus, also shears added to get wool from sheep and lastly Jordach/BSD's kitten
+- 1.04- Added mating for sheep, cows and hogs...  feed animals to make horny and hope for a baby which is half size, will grow up quick though :)
+- 1.03- Added mob drop/replace feature so that chickens can drop eggs, cow/sheep can eat grass/wheat etc.
+- 1.02- Sheared sheep are remembered and spawn shaven, Warthogs will attack when threatened, Api additions
+- 1.01- Mobs that suffer fall damage or die in water/lava/sunlight will now drop items
+- 1.0 - more work on Api so that certain mobs can float in water while some sink like a brick :)
+- 0.9 - Spawn eggs added for all mobs (admin only, cannot be placed in protected areas)...  Api tweaked
+- 0.8 - Added sounds to monster mobs (thanks Cyberpangolin for the sfx) and also chicken sound
+- 0.7 - mobs.protected switch added to api.lua, when set to 1 mobs no longer spawn in protected areas, also bug fixes
+- 0.6 - Api now supports multi-textured mobs, e.g oerkki, dungeon master, rats and chickens have random skins when spawning (sheep fix TODO), also new Honey block
+- 0.5 - Mobs now float in water, die from falling, and some code improvements
+- 0.4 - Dungeon Masters and Mese Monsters have much better aim due to shoot_offset, also they can both shoot through nodes that aren't walkable (flowers, grass etc) plus new sheep sound :)
+- 0.3 - Added LOTT's Spider mob, made Cobwebs, added KPavel's Bee with Honey and Beehives (made texture), Warthogs now have sound and can be tamed, taming of shaved sheep or milked cow with 8 wheat so it will not despawn, many bug fixes :)
+- 0.2 - Cooking bucket of milk into cheese now returns empty bucket
+- 0.1 - Initial Release

spawner.lua

@@ -0,0 +1,163 @@
+
+local S = mobs.intllib
+
+-- mob spawner
+
+local spawner_default = "mobs_animal:pumba 10 15 0 0"
+
+minetest.register_node("mobs:spawner", {
+	tiles = {"mob_spawner.png"},
+	drawtype = "glasslike",
+	paramtype = "light",
+	walkable = true,
+	description = S("Mob Spawner"),
+	groups = {cracky = 1},
+
+	on_construct = function(pos)
+
+		local meta = minetest.get_meta(pos)
+
+		-- text entry formspec
+		meta:set_string("formspec",
+			"field[text;" .. S("Mob MinLight MaxLight Amount PlayerDist") .. ";${command}]")
+		meta:set_string("infotext", S("Spawner Not Active (enter settings)"))
+		meta:set_string("command", spawner_default)
+	end,
+
+	on_right_click = function(pos, placer)
+
+		if minetest.is_protected(pos, placer:get_player_name()) then
+			return
+		end
+	end,
+
+	on_receive_fields = function(pos, formname, fields, sender)
+
+		if not fields.text or fields.text == "" then
+			return
+		end
+
+		local meta = minetest.get_meta(pos)
+		local comm = fields.text:split(" ")
+		local name = sender:get_player_name()
+
+		if minetest.is_protected(pos, name) then
+			minetest.record_protection_violation(pos, name)
+			return
+		end
+
+		local mob = comm[1] -- mob to spawn
+		local mlig = tonumber(comm[2]) -- min light
+		local xlig = tonumber(comm[3]) -- max light
+		local num = tonumber(comm[4]) -- total mobs in area
+		local pla = tonumber(comm[5]) -- player distance (0 to disable)
+		local yof = tonumber(comm[6]) or 0 -- Y offset to spawn mob
+
+		if mob and mob ~= "" and mobs.spawning_mobs[mob] == true
+		and num and num >= 0 and num <= 10
+		and mlig and mlig >= 0 and mlig <= 15
+		and xlig and xlig >= 0 and xlig <= 15
+		and pla and pla >=0 and pla <= 20
+		and yof and yof > -10 and yof < 10 then
+
+			meta:set_string("command", fields.text)
+			meta:set_string("infotext", S("Spawner Active (@1)", mob))
+
+		else
+			minetest.chat_send_player(name, S("Mob Spawner settings failed!"))
+			minetest.chat_send_player(name,
+				S("> name min_light[0-14] max_light[0-14] max_mobs_in_area[0 to disable] distance[1-20] y_offset[-10 to 10]"))
+		end
+	end,
+})
+
+-- spawner abm
+minetest.register_abm({
+	nodenames = {"mobs:spawner"},
+	interval = 10,
+	chance = 4,
+	catch_up = false,
+
+	action = function(pos, node, active_object_count, active_object_count_wider)
+
+		-- get meta and command
+		local meta = minetest.get_meta(pos)
+		local comm = meta:get_string("command"):split(" ")
+
+		-- get settings from command
+		local mob = comm[1]
+		local mlig = tonumber(comm[2])
+		local xlig = tonumber(comm[3])
+		local num = tonumber(comm[4])
+		local pla = tonumber(comm[5]) or 0
+		local yof = tonumber(comm[6]) or 0
+
+		-- if amount is 0 then do nothing
+		if num == 0 then
+			return
+		end
+
+		-- check objects inside 9x9 area around spawner
+		local objs = minetest.get_objects_inside_radius(pos, 9)
+		local count = 0
+		local ent = nil
+
+		-- count mob objects of same type in area
+		for k, obj in pairs(objs) do
+
+			ent = obj:get_luaentity()
+
+			if ent and ent.name == mob then
+				count = count + 1
+			end
+		end
+
+		-- is there too many of same type?
+		if count >= num then
+			return
+		end
+
+		-- spawn mob if player detected and in range
+		if pla > 0 then
+
+			local in_range = 0
+			local objs = minetest.get_objects_inside_radius(pos, pla)
+
+			for _,oir in pairs(objs) do
+
+				if oir:is_player() then
+
+					in_range = 1
+
+					break
+				end
+			end
+
+			-- player not found
+			if in_range == 0 then
+				return
+			end
+		end
+
+		-- find air blocks within 5 nodes of spawner
+		local air = minetest.find_nodes_in_area(
+			{x = pos.x - 5, y = pos.y + yof, z = pos.z - 5},
+			{x = pos.x + 5, y = pos.y + yof, z = pos.z + 5},
+			{"air"})
+
+		-- spawn in random air block
+		if air and #air > 0 then
+
+			local pos2 = air[math.random(#air)]
+			local lig = minetest.get_node_light(pos2) or 0
+
+			pos2.y = pos2.y + 0.5
+
+			-- only if light levels are within range
+			if lig >= mlig and lig <= xlig then
+				minetest.add_entity(pos2, mob)
+			end
+		end
+
+	end
+})