📖 介绍
- 一个基于nonebot2框架的splatoon3 nso查询插件,支持onebot11,onebot12,telegram 协议,kook 协议,QQ官方bot协议,discord协议
- 本仓库代码是基于paul的splatoon3-bot内的nso插件进行的重构版本
- 建议配合我做的日程查询插件一起使用
也可以邀请我目前做好的小鱿鱿bot直接加入kook频道或qq群聊，kook频道bot,qq群聊bot
小鱿鱿官方kook频道:kook频道
💿 安装
前置环境
- python3.10或以上版本
- 本地或远程的redis数据库
插件安装
使用 nb-cli 安装
在 nonebot2 项目的根目录下打开命令行, 输入以下指令即可安装nb plugin install nonebot-plugin-splatoon3-nso
使用包管理器安装
在 nonebot2 项目的插件目录下, 打开命令行, 根据你使用的包管理器, 输入相应的安装命令pdm
pdm add nonebot-plugin-splatoon3-nso
poetry
poetry add nonebot-plugin-splatoon3-nso
⚙️ 配置
以下配置项均为可选值，根据自己需要将配置项添加至nonebot目录的.env.prod文件
| 配置项 | 必填 | 值类型 | 默认值 | 说明 |
|---|---|---|---|---|
| splatoon3_proxy_address | 否 | str | "" | 代理地址，格式为 127.0.0.1:20171(该配置项与日程查询插件公用) |
| splatoon3_reply_mode | 否 | bool | False | 指定回复模式，开启后将通过触发词的消息进行回复，默认为False(该配置项与日程查询插件公用) |
| splatoon3_proxy_list_mode | 否 | bool | True | 局部域名代理模式,具体依据自己服务器对各个域名的访问情况进行设置，默认True，False情况为全部域名请求走代理 |
| splatoon3_proxy_list | 否 | list | 见源码 | 局部域名代理列表 |
| splatoon3_schedule_plugin_priority_mode | 否 | bool | False | 日程插件的帮助菜单优先模式(会影响帮助菜单由哪个插件提供，该配置项与日程查询插件公用) |
| splatoon3_kk_guild_id | 否 | str | "" | Q群在进行登录时，将用户引导至kook平台完成登录的服务器id |
| splatoon3_bot_disconnect_notify | 否 | bool | True | bot上线，掉线时通知到频道 |
| splatoon3_qq_md_mode | 否 | bool | False | 部分消息使用qq平台md卡片,开启了也没用，md模版需要在qqbot端进行审核，模板id目前在代码里是写死的 |
| splatoon3_unknown_command_fallback_reply | 否 | bool | True | 没有匹配命令时是否兜底回复 |
| splatoon3_notify_tg_bot_id | 否 | str | "" | 日志消息将由该bot发送至tg频道，不填就不会发送 |
| splatoon3_tg_channel_msg_chat_id | 否 | str | "" | msg消息的tg通知频道 |
| splatoon3_tg_channel_job_chat_id | 否 | str | "" | job消息的tg通知频道 |
| splatoon3_notify_kk_bot_id | 否 | str | "" | 日志消息将由该bot发送至kook频道，不填就不会发送 |
| splatoon3_kk_channel_msg_chat_id | 否 | str | "" | msg消息的kook通知频道 |
| splatoon3_kk_channel_job_chat_id | 否 | str | "" | job消息的kook通知频道 |
| splatoon3_redis_ip | 是 | str | "" | redis用于缓存用户token数据，redis ip |
| splatoon3_redis_port | 是 | str | "" | redis 端口 |
| splatoon3_redis_psw | 是 | str | "" | redis 密码 |
示例配置
# splatoon3-nso示例配置
splatoon3_proxy_address = "" #代理地址
splatoon3_reply_mode = False #指定回复模式
splatoon3_proxy_list_mode = True #局部域名代理模式,具体依据自己服务器对各个域名的访问情况进行设置，默认True，False情况为全部域名请求走代理
splatoon3_proxy_list = ["accounts.nintendo.com", "api.accounts.nintendo.com", "api-lp1.znc.srv.nintendo.net"] #局部域名代理列表
splatoon3_schedule_plugin_priority_mode = False #日程插件的帮助菜单优先模式(会影响帮助菜单由哪个插件提供，该配置项与日程查询插件公用)
splatoon3_kk_guild_id = "" #Q群在进行登录时，将用户引导至kook平台完成登录的服务器id
splatoon3_bot_disconnect_notify = True #bot上线，掉线时通知到频道
splatoon3_qq_md_mode = False #部分消息使用qq平台md卡片,开启了也没用，md模版需要在qqbot端进行审核，模板id目前在代码里是写死的
splatoon3_unknown_command_fallback_reply = True # 没有匹配命令时是否兜底回复
# 日志消息将由该bot发送至tg频道
splatoon3_notify_tg_bot_id = ""
splatoon3_tg_channel_msg_chat_id = ""
splatoon3_tg_channel_job_chat_id = ""
# 日志消息将由该bot发送至kook频道
splatoon3_notify_kk_bot_id = ""
splatoon3_kk_channel_msg_chat_id = ""
splatoon3_kk_channel_job_chat_id = ""
# redis数据库地址 用于缓存用户数据
# redis_ip
splatoon3_redis_ip: str = ""
# redis_port
splatoon3_redis_port: str|int = ""
# redis_psw
splatoon3_redis_psw: str = ""
🎉 使用
指令表
nso帮助菜单
第三方api的使用
nso查询过程中使用到了第三方的自动令牌生成接口
- 自动生成令牌需要向非 Nintendo 服务器发出安全请求，请求中包含最少的非识别信息。
- 我们力求对此 100% 透明，并提供有关安全和隐私的深入信息。
隐私声明
- 插件不会向第三方自动令牌接口，如imink API 或nxapi-znca-api发送任何身份信息。
- 用户名和密码与 API 的作用相距甚远，除了您之外，任何人都无法读取，返回的值不包含有关您帐户的任何有意义的信息。
- 无法使用发送或存储的数据来识别哪个帐户/用户执行了请求，无法查看有关用户的识别信息，也无法访问帐户。
- 有关更多信息，请参阅imink API 隐私政策 和文档,nxapi-znca-api 文档.
✨喜欢的话就点个star✨吧，球球了QAQ
鸣谢
- splatoon3-bot 本插件基于splatoon3-bot内的nso插件进行重构
- s3s 个人战绩同步上传至stat.ink的脚本
- s3si.ts 个人战绩同步上传至stat.ink的脚本ts版本
- https://github.com/imink-app/f-API 模拟nso授权步骤的公开接口
- https://github.com/samuelthomas2774/nxapi-znca-api 模拟nso授权步骤的公开接口
- zurl一个简单易用的短链接服务
- 喷喷借口生成器参考了喷喷借口生成器的代码和借口语料
⏳ Star 趋势
1 maintainer
Metadata
1 maintainer
Release files for nonebot-plugin-splatoon3-nso 2.2.5
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| nonebot_plugin_splatoon3_nso-2.2.5.tar.gz | 1.0 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| nonebot_plugin_splatoon3_nso-2.2.5-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 2.0 MB
Release files / nonebot_plugin_splatoon3_nso-2.2.5.tar.gz
| Download URL | nonebot_plugin_splatoon3_nso-2.2.5.tar.gz |
|---|---|
| Size | 1.0 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
89176a1bc29e474a9504b88488429d834350045fe63059e6e261ec4650df40c3
|
|
BLAKE2b-256 checksum How to use checksums |
00f8d6515fc1d79a0ed6b7be6ff22a09e9484848eb464e572640675bf34364fb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Release files / nonebot_plugin_splatoon3_nso-2.2.5-py3-none-any.whl
| Download URL | nonebot_plugin_splatoon3_nso-2.2.5-py3-none-any.whl |
|---|---|
| Size | 1.0 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
97501f5c2b039aabe647d5f3e14cde5298ecf24c4a43948f29486386b1ca8a1a
|
|
BLAKE2b-256 checksum How to use checksums |
95154c1759d4fb0ca393ad75afd7a5daea5981bbc1a1d8ce628137c3971f22ca
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
