MOBS REDO for MINETEST
======================

This mod contains the API only for adding your own mobs into the world, so
please use the additional modpacks to add animals, monsters, and npcs.

https://forum.minetest.net/viewtopic.php?f=11&t=9917

Information
-----------

Built from PilzAdam's original Simple Mobs with additional mobs by KrupnoPavel,
Zeg9, ExeterDad and AspireMint.

## Crafts

- **Nametag**. Can be crafted by paper, black dye, and string. Can be used
  to right-click on a tamed mob to give them a name.
- **Net**. Used to right-click tamed mobs to pick them up and place inside
  inventory as a spawn egg.
- **Magic lasso**. Similar to nets but with a better chance of picking up
  larger mobs.
- **Shears**. Used to right-click sheep and return 1-3 wool.
- **Protection Rune**. Protects tamed mobs from being harmed by other players.
- **Mob Fence and Fence Top**. Stops mobs escaping or glitching throughfences.

**Lucky Blocks**: 12

## Changelog

### Version 1.57

* Added 'injured' animation when mob hurt
* Fixed yaw clamping to stop spinning mobs
* Added 'mob_node_timer_interval' and 'mob_main_timer_interval' settings
* Added ability for mobs to die only in natural daylight
* Refactored do_jump and added get_nodes function
* Many bug fixes and tweaks to improve performance
* Added 'mobs_attack_creatura' setting so that monsters can attack Creatura mobs

### Version 1.56

* Added `arrow_override` function to mob definition to tweak arrow entity settings
* Added injured animation and mob hit effect
* Tamed monsters no longer despawn when outside loaded map area
* `looting_level` can be read from tool definition or tool meta to add extra
  drops when mob killed

### Version 1.55

* Added `peaceful_player` privilege and setting so mobs don't attack specific
  players (thanks sfence)
* Added support for MarkBu's `pathfinder` mod, remove need for default mod

### Version 1.54

* **New support for swimming mobs**
  - `on_flop` (for mobs not in water)
  - `air_damage` added
* Added editable settings (thanks Wuzzy)
* Simplified animal breeding function
* Child mobs now take twenty minutes to grow up
* Reverted to simple mob spawning with setting to use area checks

### Version 1.53

* Added `on_map_load` settings to `mobs:spawn` so that mobs will only spawn
  when new areas of map are loaded.

### Version 1.52

* Added `mob_active_limit` in settings to set number of mobs in game. The
  default is 0, for unlimited mobs.
* Removed `{immortal}` from mob armor
* Fluid viscocity slows mobs (for example, water)

### Version 1.51

* Added node checks for dangerous nodes
* Add `mob_nospawn_range` setting
* Jumping and falling tweaks
* Spawn area check (thanks for idea wuzzy)
* Re-enabled mob suffocation

### Version 1.50

* Added new `line_of_sight` function that uses raycasting if Minetest 5.0 is
  found, (thanks Astrobe)
* Added Chinese local
* Removed ability to spawn mobs if world anchor nearby (`technic` or
  `simple_anchor` mods)

### Version 1.49

* Added `mobs:force_capture(self, player)` function
* API functions now use metatables thanks to bell07

### Version 1.48

* Added `mobs:set_velocity(self, velocity)` global function

### Version 1.47

* Added minimum and maximum light level for damage
* Mob damage changes
* Ignition sources checked for lava damage

### Version 1.46

* Mobs only drop rare items when killed by player. You can make change the
  drops to rare items by using `drops.min = 0`
* Pathfinding no longer sees through walkable nodes

### Version 1.45

* Added fence top to add on top of any fence to stop mobs escaping
* New `line_of_sight` tweaked by `Astrobe`

### Version 1.44

* Added `ToolRanks` support for swords when attacking mobs

### Version 1.43

* Added general attack function and settings
* Better Minetest 0.4.16 compatibility

### Version 1.42

* Added `"all"` option to `immune_to` definition table
* Tidied floating mobs to be less intensive

### Version 1.41

* Mob pathfinding has been updated thanks to `Elkien3`

### Version 1.40

* Updated to use newer functions, requires Minetest 0.4.16+ to work

### Version 1.39

* **New custom functions**:
  - `on_breed` (called when mobs have just been bred)
  - `on_grown` (called when baby mobs have grown up)
  - `do_punch` (called when the mob has been punched or damaged by another mob)

### Version 1.38

* Better entity checking
* Nametag setting
* `on_spawn` function added to mob registry
* Tweaked light damage

### Version 1.37

* Added support for `Raymoo`'s CMI (common mob interface) mod. See
  https://forum.minetest.net/viewtopic.php?f=9&t=15448 for details

### Version 1.36

* Added death check. If the mob dies in fire/lava/with lava pick, then drops
  are cooked

### Version 1.35

* Added `owner_loyal` flag for owned mobs to attack player enemies
* Fixed `group_attack`

### Version 1.34

* Added function to fly mob using directional movement (thanks D00Med for
  flying code)

### Version 1.33

* Added functions to mount ride mobs:
  - `mobs.attach`
  - `mobs.detach`
  - `mobs.drive`. Many thanks to `Blert2112`

### Version 1.32

* Added new spawn check to count specific mobs AND new `minetest.conf` setting
  to chance spawn chance and numbers
* Added ability to protect tamed mobs

### Version 1.31

* Added `attack_animals` and `specific_attack` flags for custom monster
  attacks
* Added 'mob_difficulty' .conf setting to make mobs harder

### Version 1.30

* Added support for `invisibility` mod
* Tweaked and tidied code

### Version 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

### Version 1.28

* Added new damage system with ability for mob to be immune to weapons or
  healed by them :)

### Version 1.27

* Added new sheep, lava flan and spawn egg textures
* New Lava Pick tool smelts what you dig
* New `atan` checking function

### Version 1.26

* Pathfinding feature added thanks to rnd
* When monsters attack they become scary smart in finding you :)
* Beehive produces honey now :)

### Version 1.25

* Mobs no longer spawn within 12 blocks of player or despawn within same
  range
* Spawners now have player detection
* Tidy and tweak code

### Version 1.24

* Added feature where certain animals run away when punched
  (`runaway = true` in mob definition)

### Version 1.23

* Added mob spawner block for admin to setup spawners in-game (place and
  right-click to enter settings)

### Version 1.22

* Added ability to name tamed animals and NPCs using nametags
* NPCs will attack anyone who punches them apart from owner

### Version 1.21

* Added some more error checking to reduce `serialize.h` error and added height
  checks for falling off cliffs (thanks `cmdskp`)

### Version 1.20

* Error checking added to remove bad mobs
* Out of map limit mobs and stop `serialize.h` error

### Version 1.19

* Chickens now drop egg items instead of placing the egg
* Throwing eggs result in ⅛ chance of spawning chick

### Version 1.18

* Added `docile_by_day` flag so that monsters will not attack automatically
  during daylight hours unless hit first

### Version 1.17

* Added `dogshoot` attack type. Mobs now shoot when out of reach
* Melee attack when in reach, also API tweaks and `self.reach` added

### Version 1.16

* Mobs follow multiple items now
* NPCs can now breed

### Version 1.15

* Added feeding, taming, and breeding function
* Right-click to pick up any sheep with X mark on them and replace with new one
  to fix compatibility.

### Version 1.14

* All variables saved in staticdata
* Fixed health bug

### Version  1.13

* Added capture function (thanks `blert2112`) chance of picking up mob with a
  hand, a net, or a magic lasso
* Replaced some `.x` models with newer `.b3d` ones

### Version 1.12

* Added animal ownership so that players cannot steal your tamed animals

### Version 1.11

* Added flying and swimming mobs
* `fly=true` and `fly_in="air"` or `"default:water_source"` for fishy

### Version 1.10

* Added explosion routine for exploding mob
* Footstep removed (use replace)

### Version 1.09


* Added mob rotation value
* Added footstep feature
* Added jumping mobs with sounds feature
* Aadded magic lasso for picking up animals
* Reworked breeding routine

### Version 1.08

* Added drops that appear when mob is killed
* New custom function: `on_die` function
* Mob throwing attack has been rehauled so that they can damage one another,

### Version 1.07

* NPCs can now be set to follow player or stand by using `order` and `owner`
  variables

* BETA: Npc mob added. They kill monsters (maybe as guards) and attack players
  when punched by them. Right-clicking them with food will heal them, and
  giving them gold lump will make them drop a random item.

### Version 1.06

* Changed recovery times after breeding. Time taken to grow up can be sped up
  by feeding the baby animal.

### Version 1.05

* Added `ExeterDad`'s bunniess which can be picked up and tamed with four carrots from `farming_redo` or `farming_plus`
* Added shears to get wool from sheep
* Added Jordach/BSD's kitten

### Version 1.04

* Added mating for sheep, cows and hogs
* Added feature to feed animals to make horny and hope for a baby which is half
  size, they will grow up quick though :)

### Version 1.03

* Added mob drop/replace feature so that chickens can drop eggs and cow/sheep
  can eat grass/wheat etc.

### Version 1.02

* Sheared sheep are remembered and spawn shaven
* Warthogs will attack when threatened
* API additions

### Version 1.01

* Mobs that suffer fall damage or die in water/lava/sunlight will now drop
  items

### Version 1.0

* More work on API so that certain mobs can float in water while some sink like
  a brick :)

### Version 0.9

* Spawn eggs added for all mobs (admin only, cannot be placed in protected
  areas)
* Tweaked API

### Version 0.8

* Added sounds to monster mobs (thanks `Cyberpangolin` for the `sfx`)
* Added chicken sound
### Version 0.7

* `mobs.protected` switch added to `api.lua`. When set to 1 mobs no longer
  spawn in protected areas
* Minor bugfixes

### Version 0.6

* API now supports multi-textured mobs, e.g oerkki, dungeon master, rats and
  chickens have random skins when spawning (sheep fix TODO)
* Added new Honey block

### Version 0.5

* Mobs now float in water, die from falling
* Minor code improvements

### Version 0.4

* Added new sheep sound :)
* Dungeon Masters and Mese Monsters have much better aim due to `shoot_offset`
* They can both shoot through nodes that aren't walkable (flowers, grass, etc.)

### Version 0.3

* Added `LOTT`'s Spider mob
* Added 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
* Multiple bug fixes :)

### Version 0.2

* Cooking bucket of milk into cheese now returns empty bucket

### Version 0.1

- Initial Release