Update Monster Modes Documentation

- Changed into markdown format.

1 files changed, 72 insertions, 0 deletions

diff --git a/doc/mob_db_mode_list.md b/doc/mob_db_mode_list.md
new file mode 100644
index 000000000..a8ad4fa0a
--- /dev/null
+++ b/doc/mob_db_mode_list.md
@@ -0,0 +1,72 @@
+# Hercules Monster Modes Reference
+
+<!--
+## Copyright
+> This file is part of Hercules.
+> http://herc.ws - http://github.com/HerculesWS/Hercules
+> 
+> Copyright (C) 2012-2018 Hercules Dev Team
+> Copyright (C) Athena Dev Teams
+> 
+> Hercules is free software: you can redistribute it and/or modify it under the terms of the GNU 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 General Public License for more details.
+>
+> You should have received a copy of the GNU General Public License along with this program.  
+> If not, see <http://www.gnu.org/licenses/>.
+-->
+
+## Description
+A reference description of Hercules's mob_db.conf `mode` field.
+
+## Monster Mode Legend:
+Constant Name         | Bits    | Value    | Description
+:-------------------- | :-----: | :------: | :----------------
+MD_CANMOVE            | 0x00001 |        1 | Enables the mob to move/chase characters.
+MD_LOOTER             | 0x00002 |        2 | The mob will loot up nearby items on the ground when it's on idle state.
+MD_AGGRESSIVE         | 0x00004 |        4 | Normal aggressive mob, will look for a close-by player to attack.
+MD_ASSIST             | 0x00008 |        8 | When a nearby mob of the same class attacks, assist types will join them.
+MD_CASTSENSOR_IDLE    | 0x00010 |       16 | Will go after characters who start casting on them if idle or walking (without a target).
+MD_BOSS               | 0x00020 |       32 | Special flag which makes mobs immune to certain status changes and skills.
+MD_PLANT              | 0x00040 |       64 | Always receives 1 damage from attacks.
+MD_CANATTACK          | 0x00080 |      128 | Enables the mob to attack/retaliate when you are within attack range. <br/>Note that this only enables them to use normal attacks, skills are always allowed.
+MD_DETECTOR           | 0x00100 |      256 | Enables mob to detect and attack characters who are in hiding/cloak.
+MD_CASTSENSOR_CHASE   | 0x00200 |      512 | Will go after characters who start casting on them if idle or chasing other players (they switch chase targets)
+MD_CHANGECHASE        | 0x00400 |     1024 | Allows chasing mobs to switch targets if another player happens to be within attack range (handy on ranged attackers, for example)
+MD_ANGRY              | 0x00800 |     2048 | These mobs are "hyper-active". Apart from "chase"/"attack", they have the states "follow"/"angry". </br>Once hit, they stop using these states and use the normal ones. The new states are used to determine a different skill-set for their "before attacked" and "after attacked" states. </br>Also, when "following", they automatically switch to whoever character is closest.
+MD_CHANGETARGET_MELEE | 0x01000 |     4096 | Enables a mob to switch targets when attacked while attacking someone else.
+MD_CHANGETARGET_CHASE | 0x02000 |     8192 | Enables a mob to switch targets when attacked while chasing another character.
+MD_TARGETWEAK         | 0x04000 |    16384 | Allows aggressive monsters to only be aggressive against characters that are five levels below it's own level. </br>For example, a monster of level 104 will not pick fights with a level 99.
+MD_NOKNOCKBACK        | 0x08000 |    32768 | Monsters will be immune to knockback's effect.
+MD_RANDOMTARGET       | 0x10000 |    65536 | Picks a new random target in range on each attack/skill. (not implemented)
+
+## Aegis Mob Types:
+What Aegis has are mob-types, where each type represents an AI behavior that is mimicked by a group of eA mode bits. 
+This is the table to convert from one to another:
+
+No. | Bits   | Mob Type | Aegis/eA Description
+--: | :----: | :------: | :----------------
+ 01 | 0x0081 | Any      | passive
+ 02 | 0x0083 | Any      | passive, looter
+ 03 | 0x1089 | Any      | passive, assist and change-target melee
+ 04 | 0x3885 | Any      | angry, change-target melee/chase
+ 05 | 0x2085 | Any      | aggressive, change-target chase
+ 06 | 0x0000 | Plants   | passive, immobile, can't attack
+ 07 | 0x108B | Any      | passive, looter, assist, change-target melee
+ 08 | 0x6085 | Any      | aggressive, change-target chase, target weak enemies
+ 09 | 0x3095 | Guardian | aggressive, change-target melee/chase, cast sensor idle
+ 10 | 0x0084 | Any      | aggressive, immobile
+ 11 | 0x0084 | Guardian | aggressive, immobile
+ 12 | 0x2085 | Guardian | aggressive, change-target chase
+ 13 | 0x308D | Any      | aggressive, change-target melee/chase, assist
+ 17 | 0x0091 | Any      | passive, cast sensor idle
+ 19 | 0x3095 | Any      | aggressive, change-target melee/chase, cast sensor idle
+ 20 | 0x3295 | Any      | aggressive, change-target melee/chase, cast sensor idle/chase
+ 21 | 0x3695 | Any      | aggressive, change-target melee/chase, cast sensor idle/chase, chase-change target
+ 25 | 0x0001 | Pet      | passive, can't attack
+ 26 | 0xB695 | Any      | aggressive, change-target melee/chase, cast sensor idle/chase, chase-change target, random target
+ 27 | 0x8084 | Any      | aggressive, immobile, random target
+
+- Note that the detector bit due to being Insect/Demon, Plant and Boss mode bits need to be added independently of this list.
+