231006添加注释

PKHeXPluginExample/ExamplePlugin.cs

@@ -4,16 +4,16 @@
 
 namespace PKHeXPluginExample
 {
-    public class ExamplePlugin : IPlugin
+    public class GDNN : IPlugin
     {
-        public string Name => nameof(ExamplePlugin);
-        public int Priority => 1; // Loading order, lowest is first.
+        public string Name => nameof(GDNN); //Name是插件的名称
+        public int Priority => 1; // Loading order, lowest is first.加载顺序，最低的在前。Priority定义了插件加载的优先级
 
-        // Initialized on plugin load
-        public ISaveFileProvider SaveFileEditor { get; private set; } = null!;
-        public IPKMView PKMEditor { get; private set; } = null!;
+        // Initialized on plugin load, 在插件加载时初始化
+        public ISaveFileProvider SaveFileEditor { get; private set; } = null!;//PKHeX的存档编辑
+        public IPKMView PKMEditor { get; private set; } = null!;//Pokémon编辑
 
-        public void Initialize(params object[] args)
+        public void Initialize(params object[] args)//此方法在插件加载时调用，用于初始化插件并设置所需的组件和功能。
         {
             Console.WriteLine($"Loading {Name}...");
             SaveFileEditor = (ISaveFileProvider)Array.Find(args, z => z is ISaveFileProvider)!;
@@ -22,24 +22,24 @@ public void Initialize(params object[] args)
             LoadMenuStrip(menu);
         }
 
-        private void LoadMenuStrip(ToolStrip menuStrip)
+        private void LoadMenuStrip(ToolStrip menuStrip)//这些方法用于向PKHeX的UI添加自定义的菜单项。
         {
             var items = menuStrip.Items;
             if (!(items.Find("Menu_Tools", false)[0] is ToolStripDropDownItem tools))
                 throw new ArgumentException(nameof(menuStrip));
             AddPluginControl(tools);
         }
 
-        private void AddPluginControl(ToolStripDropDownItem tools)
+        private void AddPluginControl(ToolStripDropDownItem tools)//在这个示例中，它添加了一个新的菜单项并定义了三个子菜单项：
         {
             var ctrl = new ToolStripMenuItem(Name);
             tools.DropDownItems.Add(ctrl);
 
-            var c2 = new ToolStripMenuItem($"{Name} sub form");
+            var c2 = new ToolStripMenuItem($"{Name} sub form");//按钮1,弹出一个新的窗口
             c2.Click += (s, e) => new Form().ShowDialog();
-            var c3 = new ToolStripMenuItem($"{Name} show message");
+            var c3 = new ToolStripMenuItem($"{Name} show message");//按钮2,显示一个消息框,打印一个hello
             c3.Click += (s, e) => MessageBox.Show("Hello!");
-            var c4 = new ToolStripMenuItem($"{Name} modify current SaveFile");
+            var c4 = new ToolStripMenuItem($"{Name} ditto");//按钮3修改当前打开的存档文件,所有精灵变成妙蛙种子,改成百变怪英文昵称
             c4.Click += (s, e) => ModifySaveFile();
             ctrl.DropDownItems.Add(c2);
             ctrl.DropDownItems.Add(c3);
@@ -56,22 +56,26 @@ private void ModifySaveFile()
 
         public static void ModifyPKM(PKM pkm)
         {
-            // Make everything Bulbasaur!
-            pkm.Species = (int)Species.Bulbasaur;
-            pkm.Move1 = 1; // pound
+            // Make everything Bulbasaur! 让一切变成妙蛙种子！
+            pkm.Species = (int)Species.Ditto;//换成百变怪
+            // pkm.Species = (int)Species.Bulbasaur;
+            pkm.Move1 = 1; // pound技能1拍击
+            pkm.Move2 = 1; // pound技能1拍击
+            pkm.Move3 = 1; // pound技能1拍击
+            pkm.Move4 = 1; // pound技能1拍击
             pkm.Move1_PP = 40;
-            CommonEdits.SetShiny(pkm);
+           // CommonEdits.SetShiny(pkm);变闪
         }
 
-        public void NotifySaveLoaded()
+        public void NotifySaveLoaded()//当PKHeX加载一个新的存档文件时，NotifySaveLoaded方法会被调用。
         {
             Console.WriteLine($"{Name} was notified that a Save File was just loaded.");
         }
 
-        public bool TryLoadFile(string filePath)
+        public bool TryLoadFile(string filePath)//TryLoadFile方法在PKHeX尝试加载一个新文件时被调用，在这个示例中它没有执行任何操作。
         {
             Console.WriteLine($"{Name} was provided with the file path, but chose to do nothing with it.");
-            return false; // no action taken
+            return false; // no action taken,不采取行动
         }
     }
 }