# SaltBot
A QQbot Based on Nonebot.

--------
# How to Use
> [!CAUTION]  
> This guide assumes you have basic programming & networking knowledge.
> This bot will need change some code to run correctly.


1. Install [Python3.12](https://www.python.org/downloads/release/python-3129/)
2. Install [Nonebot](https://nonebot.dev/docs/quick-start)
3. Download this repo.
4. Create a nonebot project at another place and copy .venv/pyvenv.cfg to the bot folder.
5. Change the configuration on .env.prod.
6. Change the script path on /.venv/Lib/site-packages/nonebot_plugin_maimai_helper/__init__.py, line 87, 93, 201, 204 and line 205. (Please ignore my sh!t code, thanks:()
7. Also, the script need change resouse path, too. The defult res path is `F:/res/` ; generate path is `F:/img/`
8. Run `nb run` in the SaltBot folder.

> [!NOTE]  
> This bot will use MySQL to storge your & others Userid & Token.
> Make sure your have a MySQL database on your device.
> You can change IP(/nonebot_plugin_maimai_helper/util/utils.py) if your database isn't on your local device.

--------

# 如何使用SaltBot
> [!CAUTION]  
> 这篇指南默认你拥有基础计算机知识。
> 此 Bot 将需要更改一些代码以正确运行。

1. 安装 [Python3.12](https://www.python.org/downloads/release/python-3129/)
2. 安装 [Nonebot](https://nonebot.dev/docs/quick-start)
3. 下载此仓库到你的本地设备。
4. 在别的地方创建一个新的nonebot项目，并将 .venv/pyvenv.cfg 复制到你的Bot目录下并覆盖。
5. 按照.env.prod中的提示更改配置。
6. 更改在/.venv/Lib/site-packages/nonebot_plugin_maimai_helper/__init__.py下的第 87, 93, 201, 204, 205行的脚本路径。(不要在意我的狗史代码，谢谢你¯\_(ツ)_/¯)
7. 你还需要更改脚本的资源路径，默认资源为 `F:/res/` 生成为 `F:/img/` 。
8. 在Bot运行目录下运行 `nb run` 指令以启动。

> [!NOTE]  
> 此Bot依赖于MySQL数据库以存储你和别人的*userid*和*token*。
> 请确保你在本地部署并启动了一个MySQL数据库。
> 如果你的数据库不在本地部署，你可以在(/nonebot_plugin_maimai_helper/util/utils.py)查询并替换数据库IP。