准备工作
需要一台支持网络访问的服务器或本地环境(Linux/Windows)。
环境部署
示例环境:Ubuntu 24.04,2 核 CPU,2GB 内存。确保已安装 Python 环境(版本须 >3.8,建议 >=3.12)及 Git。
如果系统为 Ubuntu,安装 Git 命令如下:
sudo apt install git
如果系统为 Windows,请前往官网下载安装包安装即可。
创建虚拟环境
从 Python 3.11 开始,Debian 和 Ubuntu 默认启用了 "Externally-Managed-Environment"(外部管理环境)保护机制,防止用户直接使用 pip 安装包到系统 Python 环境中,以避免破坏系统依赖。因此我们选择创建一个虚拟环境,每次使用之前只需要启动环境即可。
Windows 可直接运行 pip install uv。
安装虚拟环境包
退出虚拟环境的命令:deactivate。
激活虚拟环境并安装 uv
# 激活虚拟环境
source mcvenv/bin/activate
# 在虚拟环境安装 uv
pip install uv
安装插件
安装 GsCore
进入 opt/mcbot,输入如下命令:
git clone https://github.com/Genshin-bots/gsuid_core.git --depth=1 --single-branch
cd gsuid_core
运行 GsCore
uv run core
忽略警告。
如在服务器上部署,请按说明修改 config.json 中的 host 为 0.0.0.0;本地部署可忽略。保存配置文件。
配置服务器端口 8765
由于 Gscore 运行在 8765 端口,我们需要在服务器的防火墙处添加对应的规则。
安装鸣潮插件
进入插件目录,安装 XutheringWavesUID。
cd gsuid_core/plugins
git clone https://github.com/Loping151/XutheringWavesUID.git
安装库街区签到插件
# 在 plugins 目录下安装库街区签到插件
git clone --depth=1 https://github.com/Loping151/RoverSign
重启早柚插件
可以看到刚刚安装的插件成功导入。
安装 nonebot
另外创建一个会话窗口,进入 mcbot 目录,运行虚拟环境,安装 nonebot。
opt/mcbot
mcvenv/bin/activate
pip install nb-cli-plugin-bootstrap nb-cli

