[NGE_RobotButt]机器人对接配套插件

此插件为星空Un群机器人配套插件！仅支持星空机器人V5.0 Bate5及以上版本使用！

功能

支持与星空un机器人对接，实现机器人与服务器的联动操作！

为开发者提供API接口可调用向群内推送消息！

支持游戏内开户功能！

支持游戏内银行存取款功能！(同步机器人群内银行)

所有功能均可自行选择是否启用！

---

功能指令

游戏内开户指令：/qkh [要绑定的qq] [要绑定的qq二次确认]

权限名：XkPlugin.qkh

存款指令：/ck [存入数量]

权限名：XkPlugin.ck

取款指令：/qk [取出数量]

权限名：XkPlugin.qk

---

配置文件说明

<?xml version="1.0" encoding="utf-8"?>
<RobotButtConfig xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <MysqlIP>10.3.125.81</MysqlIP>//数据库ip
  <MysqlUser>root</MysqlUser>//数据库账号
  <MysqlPassword>unturned</MysqlPassword>//数据库密码
  <MysqlDataName>unturned</MysqlDataName>//数据库名
  <MysqlPort>3306</MysqlPort>//数据库端口
  <机器人对接功能>true</机器人对接功能>//机器人对接功能开关
  <机器人监听Ip>10.3.125.90</机器人监听Ip>//机器人监听ip（与机器人中配置相同！）
  <机器人监听端口>8992</机器人监听端口>//机器人监听端口（与机器人中配置相同！）
  <服务器ID>1</服务器ID>//服务器id，在机器人使用指令时使用，请确保id不重复！
  <对接ket>unturned</对接ket>//对接密码，在机器人中配置！
  <心跳包检测周期>30</心跳包检测周期>//与机器人对接检测周期，如果断开会自动尝试重连！（无必要，请勿修改！）
  <断线重连执行周期>30</断线重连执行周期>//对接断线后每隔多少次执行一次重连操作！（无必要，请勿修改！）
  <是否允许其他插件向群推送消息>true</是否允许其他插件向群推送消息>//是否允许其他插件调用推送消息！
  <游戏内开户功能>true</游戏内开户功能>//游戏内开户功能开关
  <开户奖励数量>3000</开户奖励数量>//开户奖励数，（需在服务器中安装Uconomy插件）
  <游戏内银行存取款功能>true</游戏内银行存取款功能>//银行存取款开关，（如未在机器人中启用该功能，这里也不要开启！）
  <银行存款上限>true</银行存款上限>//银行存款上限功能开关
  <银行最大上限存款>1000000</银行最大上限存款>//银行最大上限数量，建议与机器人中配置相同！
  <UI公告id>27810</UI公告id>
</RobotButtConfig>

---

对接说明

使用对接插件需要先将机器人更新为新版本，在对接服务器中，先开启功能，并配置监听ip以及端口还有对接密码！

配置好后请确认是否拥有高级版授权，如果有可以选择两种启动方式，重启机器人或者在界面点击启动服务！

提示开启成功后将插件配置到服务器中！

请注意：本插件对接方式是服务器主动连接机器人，所以无需在机器人处配置服务器信息，仅需要在服务器端配置机器人的信息即可！

此时机器人配置界面可以暂时不关闭，以便插件服务器是否接入机器人！保持在此界面即可！

然后参考上面配置文件说明将机器人中的监听ip和端口填入插件的配置文件！并开启对接功能，否则服务器不会与机器人进行链接！

配置成功后开启服务器！耐心等待启动！

如果配置正确这时候你就会在机器人配置界面中的 服务器链接列表 查看到刚刚开启的服务器，如果显示在列表中，说明插件配置正确！

这样就可以在群中通过机器人执行指令了！

---

问题说明

• 请确保机器人与服务器在同一服务器下，如不在同一服务器，请将机器人的监听端口开放，并将监听ip填写为机器人所在服务器的外网ip！

• 如果服务启动失败，请检查是否是端口被占用了或者是服务器环境出现异常！

• 如果出现机器人服务运行正常，配置也没问题，之前也成功连接过，但现在服务器连不上的情况，可以尝试在框架中将机器人禁用，然后在启用！然后在服务器后台输入：Rocket reload robotbutt 进行重载

• 请确保在插件中配置的服务器id，每个服务器不相同，服务器id 是机器人用于定位服务器的唯一标号，冲突可能会导致机器人出现BUG！

---

开发者调用说明

开发者可以选择调用本插件进行事件推送！

首先要将NGE_RobotButt 引用！

下面放一个例程（这是一个玩家进入服务器后触发消息推送的例子）

using Rocket.Core.Plugins;
using Rocket.API.Collections;
using Rocket.API;
using Steamworks;
using Rocket.Unturned;
using Rocket.Unturned.Player;
using Rocket.Unturned.Events;
using System;
using SDG.Unturned;
using NGE_RobotButt;

namespace example
{
    public class example: RocketPlugin<exampleConfig>
    {
        public static example Instance;

        //插件加载事件
        protected override void Load()
        {
            Instance = this;
            U.Events.OnPlayerConnected += Events_OnPlayerConnected;
            U.Events.OnPlayerDisconnected += Events_OnPlayerDisconnected;
        }
        //玩家离开服务器事件
        private void Events_OnPlayerDisconnected(UnturnedPlayer player)
        {
                playerList.Remove(player.CSteamID);
                RobotButt.Instance.QQGroup_Push_Message("事件管理大师", "" + player.CharacterName + " 离开服务器！");
        }
        //玩家加入服务器事件
        private void Events_OnPlayerConnected(UnturnedPlayer player)
        {
                playerList.Add(player.CSteamID, player);
                RobotButt.Instance.QQGroup_Push_Message("事件管理大师", "" + player.CharacterName + " 进入服务器！");
        }
        //根据帧数刷新事件
        public void FixedUpdate()
        {
            if (State == PluginState.Loaded)
            {
                
            }

        }
        //插件卸载方法
        protected override void Unload()
        {
            U.Events.OnPlayerConnected -= Events_OnPlayerConnected;
            U.Events.OnPlayerDisconnected -= Events_OnPlayerDisconnected;
            StopAllCoroutines();
        }
        //语言配置文件
        public override TranslationList DefaultTranslations
        {
            get
            {
                return new TranslationList
                {                    
                };
            }
        }
    }
}

效果大概是这样的

方法

调用方法
RobotButt.Instance.QQGroup_Push_Message（string PluginName,string Message）;

PluginName 插件名称，用于推送时提示插件来源！
Message 推送信息内容！请使用/n 进行换行操作！

反馈类型：Bool 
反馈说明：返回如果为False 则为发送失败！可能是用户设置禁止其他插件推送消息！或未对接机器人！True为发送成功！

---

下载地址

下载地址回复可见