BeatSaber节奏光剑插件开发官方教程2-简单的插件示例

原文：https://wiki.assistant.moe/modding/example-mod

一、在开始之前

　　1 确保你已经看过教你如何添加插件模板的教程，且你已经使用插件模板创建了一个新项目

　　https://www.cnblogs.com/cation/p/10308764.html

　　2 如果此教程中有很多地方你看的一头雾水，那可能是因为你不太了解unity或c#，你需要先学习一些相关的知识

　　3 如果你已经学习过了前面的插件模板添加教程，你的当前视图应该是下图这样的：

　　4 本教程默认你对c#和unity有基本的了解，如果没有这方面基础的话还请先去学习下基本知识

二、简介

　　此教程将会引导你创建一个简单的插件，该插件可以记录我们miss了多少个方块，这个示例插件将包括：

　　1 一个包含组件类的空GameObject

　　2 TextMeshPro meshes，unity中用来显示文本的实例

　　3 events和actions的初步了解

三、设置变量

　　在开始之前，我们需要设置一些变量来协助我们的开发工作

enabled	是否进行计数的flag
counterPosition	计数显示在界面中的位置

　　如果提示了“Vector3 variable”错误，你需要在代码的最前面添加“using UnityEngine;”

PS：

　　可以在OnApplicationStart()函数第一行添加如下代码：

　　　　Console.WriteLine("Hello World!");

　　这行代码可以帮助你进行代码的调试，你可以使用--verbose参数启动游戏，这样会伴随游戏启动一个调试窗口，调试窗口会显示异常信息和上述代码中你设置的调试信息。

四、创建一个GameObject

　　在“Plugin.cs”文件中我们只需要少量代码。

　　“SceneManagerOnActiveSceneChanged()”事件会在游戏场景变化时触发，所以我们可以在这里创建GameObject。

　　1 第一行代码做了个是否执行插件的判定，前面我们设置了enabled

　　2 第二行代码中判定当前的场景是否是“GameCore”，确保游戏开始时对插件进行初始化，避免在主菜单就初始化插件

　　3 第三行代码中MissedCounter报错了，因为你还没创建这个object呢

五、MissedCounter.cs

　　创建一个新的class，命名为MissedCounter.cs，并使其继承MonoBehavior。

后面很繁琐了，我直接贴代码出来，完整的代码可以这里下载（MissedCounter-master.zip）：

https://github.com/Caeden117/MissedCounter

（或Q群810303476，群文件下载）

如果想知道其他的接口如何使用，可以到github上下载其他的开源插件代码参考。

using System;

using System.Collections.Generic;

using System.Linq;

using System.Text;

using System.Threading.Tasks;

using UnityEngine;

using TMPro;

using System.Collections;

using System.Threading;

namespace MissedCounter

{

    class MissedCounter : MonoBehaviour

    {

        int counter = ;

        private ScoreController score;

        //private ComboUIController combo;

        GameObject countGO;

        TextMeshPro counterText;

        void Awake()

        {

            StartCoroutine(GetScore());

        }

        IEnumerator GetScore()

        {

            while (true)

            {

                score = Resources.FindObjectsOfTypeAll<ScoreController>().FirstOrDefault();

                //combo = Resources.FindObjectsOfTypeAll<ComboUIController>().FirstOrDefault();

                //if (score != null && combo != null) break;

                if (score != null) break;

                yield return null;

            }

            Init();

        }

        void Init()

        {

            counterText = this.gameObject.AddComponent<TextMeshPro>();

            counterText.text = "";

            counterText.fontSize = ;

            counterText.color = Color.white;

            //counterText.font = combo.GetPrivateField<TextMeshProUGUI>("_comboText").font;

            counterText.alignment = TextAlignmentOptions.Center;

            counterText.rectTransform.position = Plugin.counterPosition + new Vector3(, -0.4f, );

            countGO = new GameObject("Label");

            TextMeshPro label = countGO.AddComponent<TextMeshPro>();

            label.text = "Misses";

            label.fontSize = ;

            label.color = Color.white;

            //label.font = combo.GetPrivateField<TextMeshProUGUI>("_comboText").font;

            label.alignment = TextAlignmentOptions.Center;

            label.rectTransform.position = Plugin.counterPosition;

            if (score != null)

            {

                score.noteWasCutEvent += onNoteCut;

                score.noteWasMissedEvent += onNoteMiss;

            }

        }

        void OnDestroy()

        {

            score.noteWasCutEvent -= onNoteCut;

            score.noteWasMissedEvent -= onNoteMiss;

        }

        private void onNoteCut(NoteData data, NoteCutInfo info, int c)

        {

            if (data.noteType == NoteType.Bomb || !info.allIsOK) incrementCounter();

        }

        private void onNoteMiss(NoteData data, int c)

        {

            if (data.noteType != NoteType.Bomb) incrementCounter();

        }

        private void incrementCounter()

        {

            counter++;

            counterText.text = counter.ToString();

        }

    }

}

请务必关注我们的公众号获取最新资源和信息：

更多资源在我们的讨论Q群：

810303476

巴特西

BeatSaber节奏光剑插件开发官方教程2-简单的插件示例

最新文章

热门文章