Supports throwing items out of a specific item slot.

支持扔出特定物品槽内的物品了。

scripts/behaviorTree/BehaviorNode.cs

@@ -15,11 +15,6 @@ public partial class BehaviorNode : Node2D
         InvokeBehaviorTreeNode(true, delta);
     }
 
-    // public override void _Process(double delta)
-    // {
-    //     InvokeBehaviorTreeNode(false, delta);
-    // }
-
     /// <summary>
     /// <para>InvokeBehaviorTreeNode</para>
     /// <para>调用行为树节点</para>

scripts/behaviorTree/IBehaviorTree.cs

@@ -1,5 +1,9 @@
 namespace ColdMint.scripts.behaviorTree;
 
+/// <summary>
+/// <para>IBehavior Tree</para>
+/// <para>行为树</para>
+/// </summary>
 public interface IBehaviorTree
 {
     string? Id { get; }

scripts/behaviorTree/ai/AiAttackNode.cs

@@ -3,6 +3,10 @@ using ColdMint.scripts.character;
 
 namespace ColdMint.scripts.behaviorTree.ai;
 
+/// <summary>
+/// <para>AI attack node</para>
+/// <para>AI的攻击节点</para>
+/// </summary>
 public class AiAttackNode : BehaviorTreeNodeTemplate
 {
     public AiCharacter? Character { get; set; }
@@ -29,47 +33,49 @@ public class AiAttackNode : BehaviorTreeNodeTemplate
         var selfCamp = CampManager.GetCamp(Character.CampId);
         foreach (var node in nodesInTheAttackRange)
         {
-            if (node is CharacterTemplate characterTemplate)
+            if (node is not CharacterTemplate characterTemplate)
             {
-                if (node == Character)
-                {
-                    continue;
-                }
+                continue;
+            }
             
-                var characterCamp = CampManager.GetCamp(characterTemplate.CampId);
-                var canCause = CampManager.CanCauseHarm(selfCamp, characterCamp);
-                if (!canCause)
-                {
-                    continue;
-                }
+            if (node == Character)
+            {
+                continue;
+            }
 
-                if (selfCamp == null || characterCamp == null)
-                {
-                    continue;
-                }
+            var characterCamp = CampManager.GetCamp(characterTemplate.CampId);
+            var canCause = CampManager.CanCauseHarm(selfCamp, characterCamp);
+            if (!canCause)
+            {
+                continue;
+            }
 
-                if (selfCamp.Id == characterCamp.Id)
-                {
-                    //如果是同一阵营，不攻击
-                    continue;
-                }
+            if (selfCamp == null || characterCamp == null)
+            {
+                continue;
+            }
             
-                var distance = characterTemplate.GlobalPosition - Character.GlobalPosition;
-                var distanceLength = distance.Length();
-                if (distanceLength < closestDistance)
-                {
-                    closestDistance = distanceLength;
-                    closestEnemy = characterTemplate;
-                }
+            if (selfCamp.Id == characterCamp.Id)
+            {
+                //If it is the same side, do not attack, if allowed friend damage, this code will prevent the AI from actively attacking the player.
+                //如果是同一阵营，不攻击，如果允许友伤，这段代码会阻止AI主动攻击玩家。
+                continue;
+            }
+
+            var distance = characterTemplate.GlobalPosition.DistanceTo(Character.GlobalPosition);
+            if (distance < closestDistance)
+            {
+                closestDistance = distance;
+                closestEnemy = characterTemplate;
             }
         }
 
         if (closestEnemy != null && Character.AttackObstacleDetection != null)
         {
-            //There are the closest enemies
-            //有距离最近的敌人
-            var distance = closestEnemy.GlobalPosition - Character.GlobalPosition;
-            Character.AttackObstacleDetection.TargetPosition = distance;
+            //With the nearest enemy and no obstacles
+            //有距离最近的敌人，且没有障碍物
+            var distanceVector2 = closestEnemy.GlobalPosition - Character.GlobalPosition;
+            Character.AttackObstacleDetection.TargetPosition = distanceVector2;
             if (Character.AttackObstacleDetection.GetCollider() == null)
             {
                 Character.StopMoving();

scripts/behaviorTree/ai/AiPatrolNode.cs

@@ -4,6 +4,7 @@ using ColdMint.scripts.character;
 namespace ColdMint.scripts.behaviorTree.ai;
 
 /// <summary>
+/// <para>AI patrol node</para>
 /// <para>AI巡逻节点</para>
 /// </summary>
 public class AiPatrolNode : SelectorNode

scripts/behaviorTree/framework/SequenceNode.cs

@@ -14,7 +14,7 @@ public class SequenceNode : BehaviorTreeNodeTemplate
     /// <para>Check whether all child nodes are executed in sequence</para>
     /// <para>所有子节点是否按顺序执行完毕</para>
     /// </summary>
-    bool _complete = true;
+    private bool _complete = true;
 
     public override int Execute(bool isPhysicsProcess, double delta)
     {

scripts/camp/Camp.cs

@@ -8,12 +8,11 @@ namespace ColdMint.scripts.camp;
 /// </summary>
 public class Camp
 {
-    private readonly string _id;
     private readonly List<string> _friendlyCampIdList;
 
     public Camp(string id)
     {
-        _id = id;
+        Id = id;
         _friendlyCampIdList = new List<string>();
     }
 
@@ -21,7 +20,7 @@ public class Camp
     /// <para>Get camp ID</para>
     /// <para>获取阵营ID</para>
     /// </summary>
-    public string Id => _id;
+    public string Id { get; }
 
     /// <summary>
     /// <para>Get camp name</para>

scripts/camp/CampManager.cs

@@ -6,7 +6,7 @@ namespace ColdMint.scripts.camp;
 /// <para>Camp manager</para>
 /// <para>阵营管理器</para>
 /// </summary>
-public class CampManager
+public static class CampManager
 {
     private static readonly Dictionary<string, Camp?> Camps = new Dictionary<string, Camp?>();
 

scripts/character/AiCharacter.cs

@@ -9,7 +9,7 @@ namespace ColdMint.scripts.character;
 /// <para>The role played by computers</para>
 /// <para>由电脑扮演的角色</para>
 /// </summary>
-public partial class AiCharacter : CharacterTemplate
+public sealed partial class AiCharacter : CharacterTemplate
 {
     /// <summary>
     /// <para>How fast the character moves</para>
@@ -67,10 +67,11 @@ public partial class AiCharacter : CharacterTemplate
 
         if (_attackArea != null)
         {
+            //If true, the zone will detect objects or areas entering and leaving the zone.
             //如果为true，该区域将检测进出该区域的物体或区域。
             _attackArea.Monitoring = true;
-            //Other regions cannot detect our pick region
-            //其他区域不能检测到我们的拾取区域
+            //Other areas can't detect our attack zone
+            //其他区域不能检测到我们的攻击区域
             _attackArea.Monitorable = false;
             _attackArea.BodyEntered += EnterTheAttackArea;
             _attackArea.BodyExited += ExitTheAttackArea;
@@ -83,12 +84,12 @@ public partial class AiCharacter : CharacterTemplate
         // _behaviorNode.Root = patrolBehaviorTree.Root;
     }
 
-    protected virtual void EnterTheAttackArea(Node node)
+    private void EnterTheAttackArea(Node node)
     {
         _nodesInTheAttackRange?.Add(node);
     }
 
-    protected virtual void ExitTheAttackArea(Node node)
+    private void ExitTheAttackArea(Node node)
     {
         _nodesInTheAttackRange?.Remove(node);
     }

scripts/character/CharacterTemplate.cs

@@ -6,7 +6,6 @@ using ColdMint.scripts.damage;
 using ColdMint.scripts.debug;
 using ColdMint.scripts.health;
 using ColdMint.scripts.inventory;
-using ColdMint.scripts.map.events;
 using ColdMint.scripts.utils;
 using ColdMint.scripts.weapon;
 using Godot;
@@ -30,6 +29,9 @@ public partial class CharacterTemplate : CharacterBody2D
 
     protected const float JumpVelocity = -240;
 
+    //物品被扔出后多长时间恢复与地面和平台的碰撞（单位：秒）
+    private readonly double _itemCollisionRecoveryTime = 0.045f;
+
     public string? ReadOnlyCharacterName => CharacterName;
 
     protected string? CharacterName;
@@ -259,7 +261,9 @@ public partial class CharacterTemplate : CharacterBody2D
     /// </returns>
     public bool PickItem(Node2D? pickAbleItem)
     {
-        if (pickAbleItem == null)
+        //Empty reference checking is implicitly performed here.
+        //此处隐式的执行了空引用检查。
+        if (pickAbleItem is not IItem item)
         {
             return false;
         }
@@ -277,11 +281,6 @@ public partial class CharacterTemplate : CharacterBody2D
             return false;
         }
 
-        if (pickAbleItem is not IItem item)
-        {
-            return false;
-        }
-
         //First check if we can pick up the item.
         //先检查我们能否拾起此物品。
         var canPick = _itemContainer.CanAddItem(item);
@@ -368,7 +367,7 @@ public partial class CharacterTemplate : CharacterBody2D
     /// <para>Update the role's health bar</para>
     /// <para>更新角色的健康条</para>
     /// </summary>
-    private void UpDataHealthBar(DamageTemplate damageTemplate)
+    private void UpDataHealthBar()
     {
         if (_healthBar == null)
         {
@@ -441,7 +440,7 @@ public partial class CharacterTemplate : CharacterBody2D
             return true;
         }
 
-        UpDataHealthBar(damageTemplate);
+        UpDataHealthBar();
         return true;
     }
 
@@ -529,6 +528,86 @@ public partial class CharacterTemplate : CharacterBody2D
         _animatedSprite2D.FlipH = FacingLeft;
     }
 
+    /// <summary>
+    /// <para>Throw item</para>
+    /// <para>抛出物品</para>
+    /// </summary>
+    /// <param name="index">
+    ///<para>Item slot subscript in item container</para>
+    ///<para>物品容器内的物品槽下标</para>
+    /// </param>
+    /// <param name="number">
+    /// <para>How many to throw</para>
+    /// <para>要扔几个</para>
+    /// </param>
+    /// <param name="velocity">
+    ///<para>The speed to be applied to the item</para>
+    ///<para>要施加到物品上的速度</para>
+    /// </param>
+    protected void ThrowItem(int index, int number, Vector2 velocity)
+    {
+        if (_itemContainer == null)
+        {
+            return;
+        }
+
+        var itemSlotNode = _itemContainer.GetItemSlotNode(index);
+        if (itemSlotNode == null)
+        {
+            return;
+        }
+
+        var item = itemSlotNode.GetItem();
+        if (item == null)
+        {
+            return;
+        }
+        
+        switch (item)
+        {
+            case WeaponTemplate weaponTemplate:
+                if (GameSceneNodeHolder.WeaponContainer == null)
+                {
+                    return;
+                }
+
+                weaponTemplate.Reparent(GameSceneNodeHolder.WeaponContainer);
+                var timer = new Timer();
+                weaponTemplate.AddChild(timer);
+                timer.WaitTime = _itemCollisionRecoveryTime;
+                timer.OneShot = true;
+                timer.Timeout += () =>
+                {
+                    //We cannot immediately resume the physical collision when the weapon is discharged, which will cause the weapon to collide with the ground and platform earlier, preventing the weapon from flying.
+                    //仍出武器时，我们不能立即恢复物理碰撞，立即恢复会导致武器更早的与地面和平台碰撞，阻止武器的飞行。
+                    weaponTemplate.EnableContactInjury = true;
+                    weaponTemplate.SetCollisionMaskValue(Config.LayerNumber.Ground, true);
+                    weaponTemplate.SetCollisionMaskValue(Config.LayerNumber.Platform, true);
+                    timer.QueueFree();
+                };
+                timer.Start();
+                weaponTemplate.Sleeping = false;
+                // weaponTemplate.LinearVelocity = Vector2.Zero;
+                break;
+        }
+
+        //We apply force to objects.
+        //我们给物品施加力。
+        switch (CurrentItem)
+        {
+            case CharacterBody2D characterBody2D:
+                characterBody2D.Velocity = velocity;
+                break;
+            case RigidBody2D rigidBody2D:
+                rigidBody2D.LinearVelocity = velocity;
+                break;
+        }
+
+        //Remove items from the item container
+        //在物品容器内移除物品
+        itemSlotNode.RemoveItem(number);
+    }
+
 
     public sealed override void _PhysicsProcess(double delta)
     {

scripts/character/Player.cs

@@ -43,9 +43,6 @@ public partial class Player : CharacterTemplate
     //角色从平台上跳下后，多少时间后恢复与平台的碰撞（单位：秒）
     private double _platformCollisionRecoveryTime = 0.2f;
 
-    //物品被扔出后多长时间恢复与地面和平台的碰撞（单位：秒）
-    private readonly double _itemCollisionRecoveryTime = 0.045f;
-
 
     public override void _Ready()
     {
@@ -255,7 +252,7 @@ public partial class Player : CharacterTemplate
         //抬起手时，抛出物品
         if (Input.IsActionJustReleased("throw"))
         {
-            if (CurrentItem == null)
+            if (ItemContainer == null)
             {
                 return;
             }
@@ -265,46 +262,8 @@ public partial class Player : CharacterTemplate
                 _parabola.Points = new[] { Vector2.Zero };
             }
 
-            CurrentItem.Reparent(GameSceneNodeHolder.WeaponContainer);
-            switch (CurrentItem)
-            {
-                case WeaponTemplate weaponTemplate:
-                {
-                    var timer = new Timer();
-                    weaponTemplate.AddChild(timer);
-                    timer.WaitTime = _itemCollisionRecoveryTime;
-                    timer.OneShot = true;
-                    timer.Timeout += () =>
-                    {
-                        //We cannot immediately resume the physical collision when the weapon is discharged, which will cause the weapon to collide with the ground and platform earlier, preventing the weapon from flying.
-                        //仍出武器时，我们不能立即恢复物理碰撞，立即恢复会导致武器更早的与地面和平台碰撞，阻止武器的飞行。
-                        weaponTemplate.EnableContactInjury = true;
-                        weaponTemplate.SetCollisionMaskValue(Config.LayerNumber.Ground, true);
-                        weaponTemplate.SetCollisionMaskValue(Config.LayerNumber.Platform, true);
-                        timer.QueueFree();
-                    };
-                    timer.Start();
-                    weaponTemplate.Sleeping = false;
-                    weaponTemplate.LinearVelocity = Vector2.Zero;
-                    break;
-                }
-            }
-
-            //We apply force to objects.
-            //我们给物品施加力。
-            switch (CurrentItem)
-            {
-                case CharacterBody2D characterBody2D:
-                    characterBody2D.Velocity = GetThrowVelocity();
-                    break;
-                case RigidBody2D rigidBody2D:
-                    rigidBody2D.LinearVelocity = GetThrowVelocity();
-                    break;
-            }
-
+            ThrowItem(ItemContainer.GetSelectIndex(), 1, GetThrowVelocity());
             CurrentItem = null;
-            var hotBar = GameSceneNodeHolder.HotBar;
-            hotBar?.RemoveItemFromItemSlotBySelectIndex(1);
         }
     }
 
@@ -313,6 +272,10 @@ public partial class Player : CharacterTemplate
         UpdateOperationTip();
     }
 
+    /// <summary>
+    /// <para>当玩家手动抛出物品时，施加到物品上的速度值</para>
+    /// </summary>
+    /// <returns></returns>
     private Vector2 GetThrowVelocity()
     {
         //We take the mouse position, normalize it, and then multiply it by the distance the player can throw
@@ -382,7 +345,7 @@ public partial class Player : CharacterTemplate
     {
         base.Revive(newHp);
         var healthBarUi = GameSceneNodeHolder.HealthBarUi;
-        if (healthBarUi!=null)
+        if (healthBarUi != null)
         {
             //The purpose of setting Hp to the current Hp is to cause the life bar to refresh.
             //将Hp设置为当前Hp的目的是，使生命条刷新。

scripts/inventory/HotBar.cs

@@ -14,6 +14,12 @@ public partial class HotBar : HBoxContainer, IItemContainer
 
     private List<ItemSlotNode>? _itemSlotNodes;
 
+    /// <summary>
+    /// <para>UnknownIndex</para>
+    /// <para>未知位置</para>
+    /// </summary>
+    private const int UnknownIndex = -1;
+
     //_selectIndex默认为0.
     private int _selectIndex;
 
@@ -160,17 +166,14 @@ public partial class HotBar : HBoxContainer, IItemContainer
             return;
         }
 
-        var count = _itemSlotNodes.Count;
-        if (count == 0)
+        var safeIndex = GetSafeIndex(shortcutKeyIndex);
+        if (safeIndex == UnknownIndex)
         {
-            //Prevents the dividend from being 0
-            //防止被除数为0
             return;
         }
 
-        var newIndex = shortcutKeyIndex % count;
-        SelectItemSlot(_selectIndex, newIndex);
-        _selectIndex = newIndex;
+        SelectItemSlot(_selectIndex, safeIndex);
+        _selectIndex = safeIndex;
     }
 
 
@@ -185,6 +188,27 @@ public partial class HotBar : HBoxContainer, IItemContainer
         return RemoveItemFromItemSlot(_selectIndex, number);
     }
 
+    public int GetItemSlotCount()
+    {
+        if (_itemSlotNodes == null)
+        {
+            return 0;
+        }
+
+        return _itemSlotNodes.Count;
+    }
+
+    public ItemSlotNode? GetItemSlotNode(int index)
+    {
+        if (_itemSlotNodes == null)
+        {
+            return null;
+        }
+
+        var safeIndex = GetSafeIndex(index);
+        return _itemSlotNodes[safeIndex];
+    }
+
     /// <summary>
     /// <para>Remove items from the item slot</para>
     /// <para>从物品槽内移除物品</para>
@@ -204,17 +228,41 @@ public partial class HotBar : HBoxContainer, IItemContainer
             return false;
         }
 
+        var safeIndex = GetSafeIndex(itemSlotIndex);
+        if (safeIndex == UnknownIndex)
+        {
+            return false;
+        }
+
+        var itemSlot = _itemSlotNodes[safeIndex];
+        return itemSlot.RemoveItem(number);
+    }
+
+    /// <summary>
+    /// <para>Gets a secure subscript index</para>
+    /// <para>获取安全的下标索引</para>
+    /// </summary>
+    /// <param name="itemSlotIndex"></param>
+    /// <returns>
+    ///<para>-1 is returned on failure, and the index that does not result in an out-of-bounds subscript is returned on success</para>
+    ///<para>失败返回-1，成功返回不会导致下标越界的索引</para>
+    /// </returns>
+    private int GetSafeIndex(int itemSlotIndex)
+    {
+        if (_itemSlotNodes == null)
+        {
+            return UnknownIndex;
+        }
+
         var count = _itemSlotNodes.Count;
         if (count == 0)
         {
             //Prevents the dividend from being 0
             //防止被除数为0
-            return false;
+            return UnknownIndex;
         }
 
-        var newIndex = itemSlotIndex % count;
-        var itemSlot = _itemSlotNodes[newIndex];
-        return itemSlot.RemoveItem(number);
+        return itemSlotIndex % count;
     }
 
     /// <summary>
@@ -223,6 +271,11 @@ public partial class HotBar : HBoxContainer, IItemContainer
     /// </summary>
     private void SelectItemSlot(int oldSelectIndex, int newSelectIndex)
     {
+        if (oldSelectIndex == newSelectIndex)
+        {
+            return;
+        }
+
         if (_itemSlotNodes == null)
         {
             return;
@@ -286,10 +339,12 @@ public partial class HotBar : HBoxContainer, IItemContainer
         {
             return false;
         }
-        else
-        {
-            return itemSlotNode.SetItem(item);
-        }
+        return itemSlotNode.SetItem(item);
+    }
+
+    public int GetSelectIndex()
+    {
+        return _selectIndex;
     }
 
     public ItemSlotNode? GetSelectItemSlotNode()

scripts/inventory/IItemContainer.cs

@@ -26,6 +26,13 @@ public interface IItemContainer
     /// <returns></returns>
     bool AddItem(IItem item);
 
+    /// <summary>
+    /// <para>Gets the selected location</para>
+    /// <para>获取选中的位置</para>
+    /// </summary>
+    /// <returns></returns>
+    int GetSelectIndex();
+
     /// <summary>
     /// <para>Gets the currently selected node</para>
     /// <para>获取当前选中的节点</para>
@@ -33,6 +40,38 @@ public interface IItemContainer
     /// <returns></returns>
     ItemSlotNode? GetSelectItemSlotNode();
 
+    /// <summary>
+    /// <para>Removes an item from the inventory at the currently selected location</para>
+    /// <para>移除当前选中位置物品栏内的物品</para>
+    /// </summary>
+    /// <param name="number"></param>
+    /// <returns></returns>
+    bool RemoveItemFromItemSlotBySelectIndex(int number);
+
+    /// <summary>
+    /// <para>Gets the number of item slots</para>
+    /// <para>获取物品槽的数量</para>
+    /// </summary>
+    /// <returns></returns>
+    int GetItemSlotCount();
+    
+    /// <summary>
+    /// <para>Gets the item slot for the specified location</para>
+    /// <para>获取指定位置的物品槽</para>
+    /// </summary>
+    /// <param name="index"></param>
+    /// <returns></returns>
+    ItemSlotNode? GetItemSlotNode(int index);
+
+    /// <summary>
+    /// <para>Removes an item from the item slot in the specified location</para>
+    /// <para>在指定位置的物品槽内移除物品</para>
+    /// </summary>
+    /// <param name="itemSlotIndex"></param>
+    /// <param name="number"></param>
+    /// <returns></returns>
+    bool RemoveItemFromItemSlot(int itemSlotIndex, int number);
+
     /// <summary>
     /// <para>Based on the given item, match the item slots where it can be placed</para>
     /// <para>根据给定的物品，匹配可放置它的物品槽</para>