Mobs Lite Mod v1.1
By Leslie E. Krause

Mobs Lite is a fully-working proof of concept for the Extended Motion Mechanics API for
LuaEntity SAO's, and it requires installing the following patch for Minetest 5.3-dev:

   https://github.com/minetest/minetest/pull/9717

While originally forked from PilzAdam's "Simple Mobs" mod several years ago, Mobs Lite has 
been effectively written from scratch. Most of the core architecture is derived from my 
Avatars mod, albeit a much leaner design.

Here are some of the other highlights of the Mobs Lite engine:

 * Extremely lightweight design thanks to the new API (no more continuous collision checks 
   and velocity resets).

 * Realistic fluid mechanics such as density and viscosity so that creatures have varying 
   buoyancy characteristics.

 * Sophisticated sensory analysis with a custom view-cone and acuity curve dependant on 
   changing awareness level.

 * Sensitivity thresholds and certainty factors determine whether creatures "see" a player 
   within their view cone.

 * Animals will attempt to flee to safety when a player that previously punched them 
   returns to the field of view.

 * Monsters no longer randomly attack but rather exhibit varying degrees of aggression via 
   a Perlin noise function.

 * Creatures avoid running into most obstacles by analyzing the surroundings and steadily
   changing their course.

 * Mobs can be randomly spawned in the vicinity of players, thus relieving the overhead of 
   costly ABM-based spawners.

 * Timekeeper helper class ensures efficient dispatching of mob-related callbacks at the
   appropriate server cycle.

 * Animals can be programmed to follow players or to grab items that are wielded by or 
   dropped by nearby players.

 * And of course, much much more!

Since Mobs Lite is still in early beta, there is the likelihood of lingering bugs. The API
is also subject to change. I'm actively using this mod on my own server, however. So when 
new issues are discovered or reported, they will be promptly fixed :)


Repository
----------------------

Browse source code...
  https://bitbucket.org/sorcerykid/mobs

Download archive...
  https://bitbucket.org/sorcerykid/mobs/get/master.zip
  https://bitbucket.org/sorcerykid/mobs/get/master.tar.gz

Compatability
----------------------

Requires PR #9717 for Minetest 5.3-dev

Dependencies
----------------------

TNT Mod (required)
  https://github.com/minetest-game-mods/tnt

Default Mod (required)
  https://github.com/minetest-game-mods/default

Installation
----------------------

  1) Unzip the archive into the mods directory of your game
  2) Rename the mobs-master directory to "mobs"

License of source code
----------------------------------------------------------

GNU Lesser General Public License v3 (LGPL-3.0)

Copyright (c) 2016-2020, Leslie E. Krause

This program is free software; you can redistribute it and/or modify it under the terms of
the GNU Lesser General Public License as published by the Free Software Foundation; either
version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY;
without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
See the GNU Lesser General Public License for more details.

http://www.gnu.org/licenses/lgpl-2.1.html


Multimedia License (textures, sounds, and models)
----------------------------------------------------------

Attribution-ShareAlike 3.0 Unported (CC BY-SA 3.0)

  /sounds/mobs_damage_hand.ogg
  by MTJohnson
  modified by sorcerykid
  obtained from https://freesound.org/people/MTJohnson/sounds/426308/

  /sounds/mobs_damage_tool.ogg
  by Kreastricon62
  modified by sorcerykid
  objained from https://freesound.org/people/Kreastricon62/sounds/323526/

  /textures/mobs_spider.png
  by AspireMint
  obtained from https://github.com/Darcidride/minetest-spidermob-v1

  /textures/mobs_rat2.ogg
  by Pavel_S (originally WTFPL)
  obtained from https://github.com/PilzAdam/mobs

  /textures/mobs_oerkki.ogg
  by Pavel_S (originally WTFPL)
  obtained from https://github.com/PilzAdam/mobs

  /textures/mobs_ghost.png
  by BlockMen
  obtained from https://github.com/BlockMen/cme/tree/master/ghost

  /textures/mobs_bunny.png
  by ExeterDad
  obtained from https://notabug.org/TenPlus1/mobs_animal

  /textures/mobs_chicken.png
  by JK Murray
  obtained from https://notabug.org/TenPlus1/mobs_animal

  /models/mobs_spider.x
  by AspireMint
  obtained from https://github.com/Darcidride/minetest-spidermob-v1

  /textures/mobs_kitten.png
  by Jordach
  obtained from https://notabug.org/TenPlus1/mobs_animal

  /models/mobs_rat.b3d
  by Pavel_S (originally WTFPL)
  modified by sirrobzeroone
  obtained from https://github.com/PilzAdam/mobs

  /models/mobs_oerkki.x
  by Pavel_S (originally WTWFPL)
  obtained from https://github.com/PilzAdam/mobs

  /models/mobs_ghost.b3d
  by BlockMen
  obtained from https://github.com/BlockMen/cme/tree/master/ghost

  /models/mobs_bunny.b3d
  by ExeterDad
  obtained from https://notabug.org/TenPlus1/mobs_animal

  /models/mobs_chicken.png
  by JK Murray
  obtained from https://notabug.org/TenPlus1/mobs_animal

  /textures/mobs_fireball.png
  by PilzAdam
  obtained from https://github.com/PilzAdam/mobs

  /textures/mobs_meat.png
  by Krupnov Pavel
  obtained from https://github.com/AntumMT/mod-kpgmobs

  /textures/mobs_meat_raw.png
  by Krupnov Pavel
  obtained from https://github.com/AntumMT/mod-kpgmobs

You are free to:
Share — copy and redistribute the material in any medium or format.
Adapt — remix, transform, and build upon the material for any purpose, even commercially.
The licensor cannot revoke these freedoms as long as you follow the license terms.

Under the following terms:

Attribution — You must give appropriate credit, provide a link to the license, and
indicate if changes were made. You may do so in any reasonable manner, but not in any way
that suggests the licensor endorses you or your use.

No additional restrictions — You may not apply legal terms or technological measures that
legally restrict others from doing anything the license permits.

Notices:

You do not have to comply with the license for elements of the material in the public
domain or where your use is permitted by an applicable exception or limitation.
No warranties are given. The license may not give you all of the permissions necessary
for your intended use. For example, other rights such as publicity, privacy, or moral
rights may limit how you use the material.

For more details:
http://creativecommons.org/licenses/by-sa/3.0/