Improve documentation, fix file encoding (#1026)

MinecraftClient/ChatBot.cs

@@ -660,15 +660,6 @@ namespace MinecraftClient
             return Handler.GetEntityHandlingEnabled();
         }
 
-        public bool GetInventoryEnabled()
-        {
-            return Handler.GetInventoryEnabled();
-        }
-        public Dictionary<int, Container> GetInventories()
-        {
-            return Handler.GetInventories();
-        }
-
         /// <summary>
         /// start Sneaking
         /// </summary>
@@ -900,10 +891,10 @@ namespace MinecraftClient
         }
 
         /// <summary>
-        /// Plays animation
+        /// Plays animation (Player arm swing)
         /// </summary>
-        /// <param name="animation"> <0|1></param>
-        /// <returns>TRUE animation done</returns>
+        /// <param name="animation">0 for left arm, 1 for right arm</param>
+        /// <returns>TRUE if animation successfully done</returns>
         protected bool SendAnimation(int animation)
         {
             return Handler.DoAnimation(animation);
@@ -919,7 +910,16 @@ namespace MinecraftClient
         }
 
         /// <summary>
-        /// Get a copy of the player's inventory
+        /// Check inventory handling enable status
+        /// </summary>
+        /// <returns></returns>
+        public bool GetInventoryEnabled()
+        {
+            return Handler.GetInventoryEnabled();
+        }
+
+        /// <summary>
+        /// Get the player's inventory. Do not write to it, will not have any effect server-side.
         /// </summary>
         /// <returns>Player inventory</returns>
         protected Container GetPlayerInventory()
@@ -929,15 +929,28 @@ namespace MinecraftClient
         }
 
         /// <summary>
-        /// Change player selected hotbar
+        /// Get all inventories, player and container(s). Do not write to them. Will not have any effect server-side.
         /// </summary>
-        /// <param name="slot"></param>
+        /// <returns>All inventories</returns>
+        public Dictionary<int, Container> GetInventories()
+        {
+            return Handler.GetInventories();
+        }
+
+        /// <summary>
+        /// Change player selected hotbar slot
+        /// </summary>
+        /// <param name="slot">0-8</param>
         /// <returns>True if success</returns>
         protected bool ChangeSlot(short slot)
         {
             return Handler.ChangeSlot(slot);
         }
 
+        /// <summary>
+        /// Get current player selected hotbar slot
+        /// </summary>
+        /// <returns>0-8</returns>
         protected byte GetCurrentSlot()
         {
             return Handler.GetCurrentSlot();