Implementation of unit controlling script commands.

Setunitdata <GID>, <DataType>, <Val1> {, <Val2>, <Val3>}
Getunitdata <GUID>, <DataType> {, <Variable>}
Getunitname <unit id>
Setunitname <unit id>, <name>

Performs alteration and retrieval of real-time unit data for a game object of the types -
NPCs, Pets, Monsters, Homunuculus', Mercenaries, Elementals.

Applicable data types (available as script constants) -
UDT_TYPE:       Unit Type value (BL_MOB, BL_NPC, BL_PET, BL_ELEM, BL_MER, BL_HOM)
UDT_SIZE:       Unit Size
UDT_LEVEL:      Level
UDT_HP:         Current HP
UDT_MAXHP:      Max HP
UDT_SP:         SP
UDT_MAXSP:      MAX SP
UDT_MASTERAID:  Master Account ID (for Summons)
UDT_MASTERCID:  Master Char ID (for Summons)
UDT_MAPIDXY:    Warp a Unit to a map.
UDT_WALKTOXY:   Make a unit walk to certain co-ordinates.
UDT_SPEED:      Unit Speed
UDT_MODE:       Mode (Mobs)
UDT_AI:         Unit AI Type
UDT_SCOPTION:   Status Options.
UDT_SEX:        mm Sex.
UDT_CLASS:      Class of the unit.
UDT_HAIRSTYLE:  Hair Style of the unit.
UDT_HAIRCOLOR:  Hair Color.
UDT_HEADBOTTOM: Headgear Bottom Sprite.
UDT_HEADMIDDLE: Headgear Middle Sprite.
UDT_HEADTOP:    Headegar Top Sprite.
UDT_CLOTHCOLOR: Cloth Color.
UDT_SHIELD:     Shield Sprite.
UDT_WEAPON:     Weapon Sprite.
UDT_LOOKDIR:    Face direction.
UDT_CANMOVETICK:Stop a unit from move for n seconds.
UDT_STR:        Unit STR.
UDT_AGI:        Unit AGI.
UDT_VIT:        Unit VIT.
UDT_INT:        Unit INT.
UDT_DEX:        Unit DEX.
UDT_LUK:        Unit LUK.
UDT_ATKRANGE:   Attack range of a unit.
UDT_ATKMIN:     Min Atk of a unit.
UDT_ATKMAX:     Max Atk of a unit.
UDT_MATKMIN:    Min MATK of a unit.
UDT_MATKMAX:    Max MATK of a unit.
UDT_DEF:        DEF.
UDT_MDEF:       MDEF.
UDT_HIT:        HIT.
UDT_FLEE:       FLEE.
UDT_PDODGE:     Perfect Dodge.
UDT_CRIT:       Critical Rate.
UDT_RACE:       Race. (Eg. string constants RC_DemiHuman or Integer 7).
UDT_ELETYPE:    Element. (Eg. string constants Ele_Neutral or Integer 0).
UDT_ELELEVEL:   Element Level (int).
UDT_AMOTION:    AMotion Rate (int).
UDT_ADELAY:     ADelay Rate (int).
UDT_DMOTION:    DMotion Rate (int).
UDT_HUNGER:     Hunger Rate (int) - for summons.
UDT_INTIMACY:   Intimacy Rate (int) - for summons.
UDT_LIFETIME:   LifeTime (int) - for summons.
UDT_MERC_KILLCOUNT: Kill count for mercenaries (int).
UDT_STATPOINT:    Status Points (int) - for npcs.

Addition of AI constants as well.
Documentation is included.

Credits: [rA](https://github.com/rathena/rathena/commit/2cee5b6ff1bf53c4ae53bc1278b09ae84b8a0a76) & [Smokexyz](https://github.com/Smokexyz)

1 files changed, 146 insertions, 0 deletions

diff --git a/doc/script_commands.txt b/doc/script_commands.txt
index a0e3a783d..352a9df51 100644
--- a/doc/script_commands.txt
+++ b/doc/script_commands.txt
@@ -9326,3 +9326,149 @@ to be used within a "OnPayFunds" event of a NST_CUSTOM trader.
 Returns the amount of still-available <Item_ID> in the shop (on a NST_MARKET trader).
 
 ---------------------------------------
+
+*setunitdata(<GUID>, <DataType>, <Val1> {,<Val2>,<Val3>}) 
+
+Sets or alters the data in real-time for game objects of the following types -
+NPCs, Pets, Monsters, Homunuculus', Mercenaries, Elementals.
+
+Applicable Data Types (available as constants) -
+	Data Types          Description (parameter type)
+	UDT_SIZE:           Unit Size (int)
+	UDT_LEVEL:          Level (int)
+	UDT_HP:             Current HP (int)
+	UDT_MAXHP:          Max HP (int)
+	UDT_SP:             SP (int)
+	UDT_MAXSP:          MAX SP (int)
+	UDT_MASTERAID:      Master Account ID (for Summons) (int)
+	UDT_MASTERCID:      Master Char ID (for Summons) (int)
+	UDT_MAPIDXY:        Warp a Unit to a map. (Val1 = (string) MapName, Val2 = (int) x, Val3 = (int) y)
+	UDT_WALKTOXY:       Make a unit walk to certain co-ordinates. (Val1 = (int) x, Val2 = (int) y)
+	UDT_SPEED:          Unit Speed. (int)
+	UDT_MODE:           Mode (Mobs only) (int)
+	UDT_AI:             Unit AI Type (see constants.conf for Unit AI Types)
+	UDT_SCOPTION:       Status Options. (see constants.conf for Unit Option Types)
+	UDT_SEX:            Gender of the unit. (see constants.conf for Genders)
+	UDT_CLASS:          Class of the unit. (Monster ID) (int)
+	UDT_HAIRSTYLE:      Hair Style ID. (int)
+	UDT_HAIRCOLOR:      Hair Color ID. (int)
+	UDT_HEADBOTTOM:     Headgear Bottom Sprite ID. (int)
+	UDT_HEADMIDDLE:     Headgear Middle Sprite ID. (int)
+	UDT_HEADTOP:        Headgear Top Sprite ID. (int)
+	UDT_CLOTHCOLOR:     Cloth Color ID. (int)
+	UDT_SHIELD:         Shield Sprite ID. (int)
+	UDT_WEAPON:         Weapon Sprite ID. (int)
+	UDT_LOOKDIR:        Face direction. (int)
+	UDT_CANMOVETICK:    Stop a unit from move for n seconds. (int)
+	UDT_STR:            Unit STR. (int)
+	UDT_AGI:            Unit AGI. (int)
+	UDT_VIT:            Unit VIT. (int)
+	UDT_INT:            Unit INT. (int)
+	UDT_DEX:            Unit DEX. (int)
+	UDT_LUK:            Unit LUK. (int)
+	UDT_ATKRANGE:       Attack range of a unit. (int)
+	UDT_ATKMIN:         Min Atk of a unit. (int)
+	UDT_ATKMAX:         Max Atk of a unit. (int)
+	UDT_MATKMIN:        Min MATK of a unit. (int)
+	UDT_MATKMAX:        Max MATK of a unit. (int)
+	UDT_DEF:            DEF. (int)
+	UDT_MDEF:           MDEF. (int)
+	UDT_HIT:            HIT. (int)
+	UDT_FLEE:           FLEE. (int)
+	UDT_PDODGE:         Perfect Dodge. (int)
+	UDT_CRIT:           Critical Rate. (int)
+	UDT_RACE:           Race. (Eg. string constants RC_DemiHuman or Integer 7).
+	UDT_ELETYPE:        Element. (Eg. string constants Ele_Neutral or Integer 0).
+	UDT_ELELEVEL:       Element Level (int).
+	UDT_AMOTION:        AMotion Rate (int).
+	UDT_ADELAY:         ADelay Rate (int).
+	UDT_DMOTION:        DMotion Rate (int).
+	UDT_HUNGER:         Hunger Rate (int) - for summons.
+	UDT_INTIMACY:       Intimacy Rate (int) - for summons.
+	UDT_LIFETIME:       LifeTime (int) - for summons.
+	UDT_MERC_KILLCOUNT: Kill count for mercenaries (int).
+	UDT_STATADD:        Status Points (int) - for NPCs.
+	
+returns 0 if value could not be set, 1 if successful.
+
+---------------------------------------
+
+*getunitdata (<GUID>,<DataType>{,<Variable>})
+
+Retrieves real-time data of a game object. For data with multiple return values,
+an array variable may be passed to store the data in.
+
+Applicable Data types (available as constants) -
+	Data Types          Description (return type)
+	UDT_SIZE:           Unit Size (int)
+	UDT_LEVEL:          Level (int)
+	UDT_HP:             Current HP (int)
+	UDT_MAXHP:          Max HP (int)
+	UDT_SP:             SP (int)
+	UDT_MAXSP:          MAX SP (int)
+	UDT_MASTERAID:      Master Account ID (for Summons) (int)
+	UDT_MASTERCID:      Master Char ID (for Summons) (int)
+	UDT_MAPIDXY:        Warp a Unit to a map. (Val1 = (string) MapName, Val2 = (int) x, Val3 = (int) y)
+	UDT_SPEED:          Unit Speed. (int)
+	UDT_MODE:           Mode (Mobs only) (int)
+	UDT_AI:             Unit AI Type (see constants.conf for Unit AI Types)
+	UDT_SCOPTION:       Status Options. (see constants.conf for Unit Option Types)
+	UDT_SEX:            Gender of the unit. (see constants.conf for Genders)
+	UDT_CLASS:          Class of the unit. (Monster ID) (int)
+	UDT_HAIRSTYLE:      Hair Style ID. (int)
+	UDT_HAIRCOLOR:      Hair Color ID. (int)
+	UDT_HEADBOTTOM:     Headgear Bottom Sprite ID. (int)
+	UDT_HEADMIDDLE:     Headgear Middle Sprite ID. (int)
+	UDT_HEADTOP:        Headgear Top Sprite ID. (int)
+	UDT_CLOTHCOLOR:     Cloth Color ID. (int)
+	UDT_SHIELD:         Shield Sprite ID. (int)
+	UDT_WEAPON:         Weapon Sprite ID. (int)
+	UDT_LOOKDIR:        Face direction. (int)
+	UDT_CANMOVETICK:    Stop a unit from move for n seconds. (int)
+	UDT_STR:            Unit STR. (int)
+	UDT_AGI:            Unit AGI. (int)
+	UDT_VIT:            Unit VIT. (int)
+	UDT_INT:            Unit INT. (int)
+	UDT_DEX:            Unit DEX. (int)
+	UDT_LUK:            Unit LUK. (int)
+	UDT_ATKRANGE:       Attack range of a unit. (int)
+	UDT_ATKMIN:         Min Atk of a unit. (int)
+	UDT_ATKMAX:         Max Atk of a unit. (int)
+	UDT_MATKMIN:        Min MATK of a unit. (int)
+	UDT_MATKMAX:        Max MATK of a unit. (int)
+	UDT_DEF:            DEF. (int)
+	UDT_MDEF:           MDEF. (int)
+	UDT_HIT:            HIT. (int)
+	UDT_FLEE:           FLEE. (int)
+	UDT_PDODGE:         Perfect Dodge. (int)
+	UDT_CRIT:           Critical Rate. (int)
+	UDT_RACE:           Race. (Eg. string constants RC_DemiHuman or Integer 7).
+	UDT_ELETYPE:        Element. (Eg. string constants Ele_Neutral or Integer 0).
+	UDT_ELELEVEL:       Element Level (int).
+	UDT_AMOTION:        AMotion Rate (int).
+	UDT_ADELAY:         ADelay Rate (int).
+	UDT_DMOTION:        DMotion Rate (int).
+	UDT_HUNGER:         Hunger Rate (int) - for summons.
+	UDT_INTIMACY:       Intimacy Rate (int) - for summons.
+	UDT_LIFETIME:       LifeTime (int) - for summons.
+	UDT_MERC_KILLCOUNT: Kill count for mercenaries (int).
+
+returns 0 if value could not be retrieved.
+
+---------------------------------------
+
+*getunitname(<GID>)
+
+Retrieve the name of a unit.
+
+returns "Unknown" if the value could not be retrieved.
+
+---------------------------------------
+
+*setunitname(<GID>, <Name>)
+
+Changes the name of a unit.
+
+Supported Types - [ MOB | HOM | PET ].
+
+returns 1 on success, 0 on failure.