Metadata-Version: 2.1
Name: nonebot-plugin-ddrace
Version: 0.0.5
Summary: 提供 DDNet 成绩查询功能
Home-page: https://github.com/gongfuture/nonebot-plugin-ddrace
License: MIT
Keywords: bot,qq,qqbot,onebotv11,onebot,nonebot2,nonebot,ddrace,ddnet
Author: gongfuture
Author-email: gongfuture@outlook.com
Requires-Python: >3.9,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Dist: beautifulsoup4 (>=4.12.3,<5.0.0)
Requires-Dist: httpx (>=0.24.1,<0.27.2)
Requires-Dist: nonebot-adapter-onebot (>=2.4.5,<3.0.0)
Requires-Dist: nonebot-plugin-htmlrender (>=0.3.5)
Requires-Dist: nonebot-plugin-localstore (>=0.7.0)
Requires-Dist: nonebot-plugin-send-anything-anywhere (>=0.5,<0.8)
Requires-Dist: nonebot-plugin-userinfo (>=0.2.0)
Requires-Dist: nonebot2 (>=2.3.3)
Requires-Dist: nonebot_plugin_apscheduler (>=0.2.0)
Requires-Dist: pydantic (<3.0.0)
Project-URL: Bug Tracker, https://github.com/gongfuture/nonebot-plugin-ddrace/issues
Project-URL: Repository, https://github.com/gongfuture/nonebot-plugin-ddrace
Description-Content-Type: text/markdown

<div align="center">
  <a href="https://v2.nonebot.dev/store"><img src="https://github.com/A-kirami/nonebot-plugin-template/blob/resources/nbp_logo.png" width="180" height="180" alt="NoneBotPluginLogo"></a>
  <br>
  <p><img src="https://ddnet.org/ddnet.svg" width="240" alt="NoneBotPluginText"></p>
</div>

<div align="center">

# nonebot-plugin-ddrace

_✨ 提供 DDNet 成绩查询功能 ✨_


<a href="./LICENSE">
    <img src="https://img.shields.io/github/license/gongfuture/nonebot-plugin-ddrace.svg?style=for-the-badge" alt="license">
</a>
<img src="https://img.shields.io/badge/python-3.9+-blue.svg?style=for-the-badge" alt="python">
<a href="https://pypi.python.org/pypi/nonebot-plugin-ddrace">
    <img src="https://img.shields.io/pypi/v/nonebot-plugin-ddrace.svg?style=for-the-badge" alt="pypi">
</a>
<a href="https://www.codefactor.io/repository/github/gongfuture/nonebot-plugin-ddrace">
<img src="https://img.shields.io/codefactor/grade/github/gongfuture/nonebot-plugin-ddrace?style=for-the-badge">
</a>
<a href="https://github.com/gongfuture/nonebot-plugin-ddrace/commits/main">
<img src="https://img.shields.io/github/last-commit/gongfuture/nonebot-plugin-ddrace?style=for-the-badge">
</a>
<a href="https://wakatime.com/@gongfuture"><img src="https://wakatime.com/badge/github/gongfuture/nonebot-plugin-ddrace.svg?style=for-the-badge" /></a>
<a href="https://qm.qq.com/q/OfK3d9r6o2"><img src="https://img.shields.io/badge/QQ群-611124274-blue?logo=tencentqq&style=for-the-badge" /></a>


</div>


## 📖 介绍

这是一个 nonebot2 插件，提供 DDNet 成绩查询功能
可以查询玩家的成绩， ~~服务器的状态等信息(还没写好)，~~ 使用图片发送(这个真有)

Python新手项目，代码质量低，欢迎各位大佬指导/PR

## 💿 安装

<details open>
<summary>使用 nb-cli 安装</summary>
在 nonebot2 项目的根目录下打开命令行, 输入以下指令即可安装

    nb plugin install nonebot-plugin-ddrace

</details>

<details>
<summary>使用包管理器安装</summary>
在 nonebot2 项目的插件目录下, 打开命令行, 根据你使用的包管理器, 输入相应的安装命令

<details>
<summary>pip</summary>

    pip install nonebot-plugin-ddrace
</details>
<details>
<summary>pdm</summary>

    pdm add nonebot-plugin-ddrace
</details>
<details>
<summary>poetry</summary>

    poetry add nonebot-plugin-ddrace
</details>
<details>
<summary>conda</summary>

    conda install nonebot-plugin-ddrace
</details>

打开 nonebot2 项目根目录下的 `pyproject.toml` 文件, 在 `[tool.nonebot]` 部分追加写入

    plugins = ["nonebot_plugin_ddrace"]

</details>

## ⚙️ 配置

在 nonebot2 项目的`.env`文件中添加下表中的必填配置

| 配置项  | 必填  | 类型 | 默认值 |   说明   |
| :-----: | :---: | :---: |  :----: | :------: |
| ddr_need_at |  否   | Bool|   False   | 是否需要at bot触发指令 |
| ddr_at_back |  否   | Bool|   False   | 是否at回发送指令者 |
| ddr_reply |  否   | Bool|   False   | 是否引用指令消息 |
| ddr_priority |  否   | Int |   10       | 优先级，越小越优先，最低为1 |
<!-- | ddr_command_pre_alias |  否   | Str |   ""       | 指令前缀别名，用于和其他插件指令防撞 | -->
| ddr_cache_time |  否   | Int |   60     | 缓存时间，单位为分钟，为 0 时不缓存 |

## 🎉 使用
### 指令表
| 指令  | 权限  | 需要@ | 范围  |   说明   |
| :---: | :---: | :---: | :---: | :------: |
| points | 群员  |  跟随全局   | 群聊，私聊  | 查询{name}的成绩图 |
| fpoints| 群员  |  跟随全局   | 群聊，私聊  | 查询{name}的成绩图(不使用缓存) |
### 效果图
如果有效果图的话

