doc (#19)

SCP-SL-Plugin-YongAnTeam · Oct 24, 2024 · b63aac3 · b63aac3
1 parent 5f4fdbb
commit b63aac3
Show file tree

Hide file tree

Showing 6 changed files with 72 additions and 17 deletions.
diff --git a/Commands/ExpCommand.cs b/Commands/ExpCommand.cs
@@ -10,7 +10,7 @@ namespace BAPlugin.Command
     [CommandHandler(typeof(RemoteAdminCommandHandler))]
     public class ExpCommand : ICommand
     {
-        public string Command => "experience";
+        public string Command => "pexperience";
 
         public string[] Aliases => ["pexp"];
 

diff --git a/Players/CustomPlayer.cs b/Players/CustomPlayer.cs
@@ -1,21 +1,69 @@
-namespace YongAnFrame.Players
+using YongAnFrame.Roles;
+
+namespace YongAnFrame.Players
 {
     public abstract class CustomPlayer(FramePlayer player)
     {
+        /// <summary>
+        /// 拥有该实例的框架玩家
+        /// </summary>
         public FramePlayer FramePlayer { get; private set; } = player;
+        /// <summary>
+        /// 是否有效
+        /// </summary>
         public bool IsInvalid => FramePlayer == null;
-        public float ExpMultiplier { get { return FramePlayer.ExpMultiplier; } set { FramePlayer.ExpMultiplier = value; } }
-        public ulong Exp { get { return FramePlayer.Exp; } set { FramePlayer.Exp = value; } }
-        public ulong Level { get { return FramePlayer.Level; } set { FramePlayer.Level = value; } }
+        /// <summary>
+        /// 实例拥有的自定义角色
+        /// </summary>
+        public CustomRolePlus CustomRolePlus => FramePlayer.CustomRolePlus;
+        /// <summary>
+        /// 提示系统管理器
+        /// </summary>
         public HintManager HintManager => FramePlayer.HintManager;
-        public PlayerTitle UsingTitles { get { return FramePlayer.UsingTitles; } set { FramePlayer.UsingTitles = value; } }
-        public PlayerTitle UsingRankTitles { get { return FramePlayer.UsingRankTitles; } set { FramePlayer.UsingRankTitles = value; } }
+        /// <summary>
+        /// 正在使用的主要自定义算法
+        /// </summary>
+        public ICustomAlgorithm CustomAlgorithm { get => FramePlayer.CustomAlgorithm; set=> FramePlayer.CustomAlgorithm = value; }
+        /// <summary>
+        /// 玩家等级
+        /// </summary>
+        public ulong Level { get => FramePlayer.Level; set => FramePlayer.Level = value; }
+        /// <summary>
+        /// 玩家经验
+        /// </summary>
+        public ulong Exp { get => FramePlayer.Exp; set => FramePlayer.Exp = value; }
+        /// <summary>
+        /// 玩家经验倍率
+        /// </summary>
+        public float ExpMultiplier { get => FramePlayer.ExpMultiplier; set => FramePlayer.ExpMultiplier = value; }
+        /// <summary>
+        /// 玩家批准绕过DNT
+        /// </summary>
+        public bool IsBDNT { get => FramePlayer.IsBDNT; set => FramePlayer.IsBDNT = value; }
+        /// <summary>
+        /// 正在使用的名称称号
+        /// </summary>
+        public PlayerTitle UsingTitles { get => FramePlayer.UsingTitles; set => FramePlayer.UsingTitles = value; }
 
+        /// <summary>
+        /// 正在使用的排名称号
+        /// </summary>
+        public PlayerTitle UsingRankTitles { get => FramePlayer.UsingRankTitles; set => FramePlayer.UsingRankTitles = value; }
+
+        /// <summary>
+        /// 添加经验
+        /// </summary>
+        /// <param name="exp">数值</param>
+        /// <param name="name">原因</param>
         public void AddExp(ulong exp, string name = "未知原因")
         {
             FramePlayer.AddExp(exp, name);
         }
-
+        /// <summary>
+        /// 调用后该实例会立刻无效<br/>
+        /// 调用后该实例会立刻无效<br/>
+        /// 调用后该实例会立刻无效
+        /// </summary>
         public virtual void Invalid()
         {
             FramePlayer = null;

diff --git a/Players/FramePlayer.cs b/Players/FramePlayer.cs
@@ -124,6 +124,11 @@ internal FramePlayer(Player player)
             Events.Handlers.FramePlayer.OnFramePlayerCreated(new FramePlayerCreatedEventArgs(this));
         }
 
+        /// <summary>
+        /// 添加经验
+        /// </summary>
+        /// <param name="exp">数值</param>
+        /// <param name="name">原因</param>
         public void AddExp(ulong exp, string name = "未知原因")
         {
             float globalExpMultiplier = YongAnFramePlugin.Instance.Config.GlobalExpMultiplier;

diff --git a/Players/ICustomAlgorithm.cs b/Players/ICustomAlgorithm.cs
@@ -2,6 +2,11 @@
 {
     public interface ICustomAlgorithm
     {
+        /// <summary>
+        /// 获取升级所需要的经验
+        /// </summary>
+        /// <param name="level"></param>
+        /// <returns></returns>
         public ulong GetNeedUpLevel(ulong level);
     }
 }
diff --git a/Roles/Properties/SkillProperties.cs b/Roles/Properties/SkillProperties.cs
@@ -1,6 +1,6 @@
 namespace YongAnFrame.Roles.Properties
 {
-    public struct SkillProperties(string name, string statement, string description, float activeMaxTime, float burialMaxTime, ItemType useItem = ItemType.Coin)
+    public readonly struct SkillProperties(string name, string statement, string description, float activeMaxTime, float burialMaxTime, ItemType useItem = ItemType.Coin)
     {
         /// <summary>
         /// 技能名称

diff --git a/YongAnTool.cs b/YongAnTool.cs
@@ -39,15 +39,12 @@ public static FramePlayer ToFPlayer(this Player p)
 
         public static RefreshTeamType ToRefreshTeamType(this SpawnableTeamType stp)
         {
-            switch (stp)
+            return stp switch
             {
-                case SpawnableTeamType.ChaosInsurgency:
-                    return RefreshTeamType.CI;
-                case SpawnableTeamType.NineTailedFox:
-                    return RefreshTeamType.MTF;
-                default:
-                    return RefreshTeamType.Start;
-            }
+                SpawnableTeamType.ChaosInsurgency => RefreshTeamType.CI,
+                SpawnableTeamType.NineTailedFox => RefreshTeamType.MTF,
+                _ => RefreshTeamType.Start,
+            };
         }
     }
 }