nonebot-plugin-majsoul


Namenonebot-plugin-majsoul JSON
Version 0.2.5 PyPI version JSON
download
home_page
SummaryNoneBot2 雀魂信息查询插件
upload_time2023-09-28 17:31:33
maintainer
docs_urlNone
authorssttkkl
requires_python>=3.9,<4.0
licenseAGPL-3.0
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            <!-- markdownlint-disable MD033 MD036 MD041 -->

<p align="center">
  <a href="https://v2.nonebot.dev/"><img src="https://v2.nonebot.dev/logo.png" width="200" height="200" alt="nonebot"></a>
</p>

<div align="center">

nonebot-plugin-majsoul
============

_✨ 雀魂信息查询插件 ✨_

</div>


<p align="center">
  <a href="https://raw.githubusercontent.com/ssttkkl/nonebot-plugin-majsoul/master/LICENSE">
    <img src="https://img.shields.io/github/license/ssttkkl/nonebot-plugin-majsoul.svg" alt="license">
  </a>
  <a href="https://pypi.python.org/pypi/nonebot-plugin-majsoul">
    <img src="https://img.shields.io/pypi/v/nonebot-plugin-majsoul.svg" alt="pypi">
  </a>
  <img src="https://img.shields.io/badge/python-3.9+-blue.svg" alt="python">
</p>

受[DaiShengSheng/Majsoul_bot](https://github.com/DaiShengSheng/Majsoul_bot)启发而写的雀魂信息查询 Bot 插件。

## 功能

### 雀魂牌谱屋

#### 查询个人数据(可按照时间、按照场数、按照房间类型查询)

指令:`/雀魂(三麻)信息 <雀魂账号> [<房间类型>] [最近<数量>场] [最近<数量>{天|周|个月|年}]`

![雀魂信息](img/majsoul_info.png)

![雀魂信息2](img/majsoul_info_2.png)

#### 查询个人最近对局(可按照房间类型查询)

指令:`/雀魂(三麻)对局 <雀魂账号> [<房间类型>]`

![最近对局](img/records.png)

![最近对局(消息)](img/records_forward.png)

#### 绘制个人PT推移图

**若绘图出现乱码或是需要更换绘图字体,请参考下文进行字体配置**

指令:`/雀魂(三麻)PT图 <雀魂账号> [最近<数量>场] [最近<数量>{天|周|个月|年}]`

![雀魂PT推移图](img/pt_plot.png)

![雀魂PT推移图(图)](img/pt_plot_img.png)

#### 下载雀魂牌谱

将雀魂牌谱保存为天凤JSON格式。**必须配置雀魂账号与密码。**

指令:`/下载雀魂牌谱 <牌谱链接或UUID>`

## 配置字体

### 更换为系统已安装字体

修改配置项`majsoul_font`为字体名。

例如:配置`majsoul_font=Microsoft YaHei`将使用微软雅黑字体

### 更换为外部字体

修改配置项`majsoul_font_path`为字体路径,并修改配置项`majsoul_font`为字体名。

例如:在 https://github.com/lxgw/LxgwWenKai-Lite/releases 下载LXGWWenKaiMonoLite-Regular.ttf并放置于bot根目录,配置`majsoul_font_path=LXGWWenKaiMonoLite-Regular.ttf`,配置`majsoul_font=LXGW WenKai Mono Lite`

## 配置项

### majsoul_query_timeout

指令超时(单位:秒)

### majsoul_font

绘图用的字体名称

### majsoul_font_path

绘图用的字体文件路径

### majsoul_username

下载牌谱用的雀魂账号邮箱。推荐使用小号。

### majsoul_password

下载牌谱用的雀魂账号密码。推荐使用小号。

## See Also

- [nonebot-plugin-mahjong-utils](https://github.com/ssttkkl/nonebot-plugin-mahjong-utils):日麻小工具插件。支持手牌分析、番符点数查询。
- [nonebot-plugin-mahjong-scoreboard](https://github.com/ssttkkl/nonebot-plugin-mahjong-scoreboard)
  :日麻计分器。为面麻群友提供日麻对局分数记录。根据马点进行PT精算,统计PT增减,支持对局与榜单查询与导出。

## 在线乞讨

<details><summary>点击请我打两把maimai</summary>

![](https://github.com/ssttkkl/ssttkkl/blob/main/afdian-ssttkkl.jfif)

</details>

## LICENSE

[AGPLv3](https://raw.githubusercontent.com/ssttkkl/nonebot-plugin-majsoul/master/LICENSE)

            

Raw data

            {
    "_id": null,
    "home_page": "",
    "name": "nonebot-plugin-majsoul",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.9,<4.0",
    "maintainer_email": "",
    "keywords": "",
    "author": "ssttkkl",
    "author_email": "huang.wen.long@hotmail.com",
    "download_url": "https://files.pythonhosted.org/packages/86/b2/6169fcdf59d40986ccc66cfd00d27920a0f59b468b75b0cfdd34bba9f810/nonebot_plugin_majsoul-0.2.5.tar.gz",
    "platform": null,
    "description": "<!-- markdownlint-disable MD033 MD036 MD041 -->\n\n<p align=\"center\">\n  <a href=\"https://v2.nonebot.dev/\"><img src=\"https://v2.nonebot.dev/logo.png\" width=\"200\" height=\"200\" alt=\"nonebot\"></a>\n</p>\n\n<div align=\"center\">\n\nnonebot-plugin-majsoul\n============\n\n_\u2728 \u96c0\u9b42\u4fe1\u606f\u67e5\u8be2\u63d2\u4ef6 \u2728_\n\n</div>\n\n\n<p align=\"center\">\n  <a href=\"https://raw.githubusercontent.com/ssttkkl/nonebot-plugin-majsoul/master/LICENSE\">\n    <img src=\"https://img.shields.io/github/license/ssttkkl/nonebot-plugin-majsoul.svg\" alt=\"license\">\n  </a>\n  <a href=\"https://pypi.python.org/pypi/nonebot-plugin-majsoul\">\n    <img src=\"https://img.shields.io/pypi/v/nonebot-plugin-majsoul.svg\" alt=\"pypi\">\n  </a>\n  <img src=\"https://img.shields.io/badge/python-3.9+-blue.svg\" alt=\"python\">\n</p>\n\n\u53d7[DaiShengSheng/Majsoul_bot](https://github.com/DaiShengSheng/Majsoul_bot)\u542f\u53d1\u800c\u5199\u7684\u96c0\u9b42\u4fe1\u606f\u67e5\u8be2 Bot \u63d2\u4ef6\u3002\n\n## \u529f\u80fd\n\n### \u96c0\u9b42\u724c\u8c31\u5c4b\n\n#### \u67e5\u8be2\u4e2a\u4eba\u6570\u636e\uff08\u53ef\u6309\u7167\u65f6\u95f4\u3001\u6309\u7167\u573a\u6570\u3001\u6309\u7167\u623f\u95f4\u7c7b\u578b\u67e5\u8be2\uff09\n\n\u6307\u4ee4\uff1a`/\u96c0\u9b42(\u4e09\u9ebb)\u4fe1\u606f <\u96c0\u9b42\u8d26\u53f7> [<\u623f\u95f4\u7c7b\u578b>] [\u6700\u8fd1<\u6570\u91cf>\u573a] [\u6700\u8fd1<\u6570\u91cf>{\u5929|\u5468|\u4e2a\u6708|\u5e74}]`\n\n![\u96c0\u9b42\u4fe1\u606f](img/majsoul_info.png)\n\n![\u96c0\u9b42\u4fe1\u606f2](img/majsoul_info_2.png)\n\n#### \u67e5\u8be2\u4e2a\u4eba\u6700\u8fd1\u5bf9\u5c40\uff08\u53ef\u6309\u7167\u623f\u95f4\u7c7b\u578b\u67e5\u8be2\uff09\n\n\u6307\u4ee4\uff1a`/\u96c0\u9b42(\u4e09\u9ebb)\u5bf9\u5c40 <\u96c0\u9b42\u8d26\u53f7> [<\u623f\u95f4\u7c7b\u578b>]`\n\n![\u6700\u8fd1\u5bf9\u5c40](img/records.png)\n\n![\u6700\u8fd1\u5bf9\u5c40\uff08\u6d88\u606f\uff09](img/records_forward.png)\n\n#### \u7ed8\u5236\u4e2a\u4ebaPT\u63a8\u79fb\u56fe\n\n**\u82e5\u7ed8\u56fe\u51fa\u73b0\u4e71\u7801\u6216\u662f\u9700\u8981\u66f4\u6362\u7ed8\u56fe\u5b57\u4f53\uff0c\u8bf7\u53c2\u8003\u4e0b\u6587\u8fdb\u884c\u5b57\u4f53\u914d\u7f6e**\n\n\u6307\u4ee4\uff1a`/\u96c0\u9b42(\u4e09\u9ebb)PT\u56fe <\u96c0\u9b42\u8d26\u53f7> [\u6700\u8fd1<\u6570\u91cf>\u573a] [\u6700\u8fd1<\u6570\u91cf>{\u5929|\u5468|\u4e2a\u6708|\u5e74}]`\n\n![\u96c0\u9b42PT\u63a8\u79fb\u56fe](img/pt_plot.png)\n\n![\u96c0\u9b42PT\u63a8\u79fb\u56fe\uff08\u56fe\uff09](img/pt_plot_img.png)\n\n#### \u4e0b\u8f7d\u96c0\u9b42\u724c\u8c31\n\n\u5c06\u96c0\u9b42\u724c\u8c31\u4fdd\u5b58\u4e3a\u5929\u51e4JSON\u683c\u5f0f\u3002**\u5fc5\u987b\u914d\u7f6e\u96c0\u9b42\u8d26\u53f7\u4e0e\u5bc6\u7801\u3002**\n\n\u6307\u4ee4\uff1a`/\u4e0b\u8f7d\u96c0\u9b42\u724c\u8c31 <\u724c\u8c31\u94fe\u63a5\u6216UUID>`\n\n## \u914d\u7f6e\u5b57\u4f53\n\n### \u66f4\u6362\u4e3a\u7cfb\u7edf\u5df2\u5b89\u88c5\u5b57\u4f53\n\n\u4fee\u6539\u914d\u7f6e\u9879`majsoul_font`\u4e3a\u5b57\u4f53\u540d\u3002\n\n\u4f8b\u5982\uff1a\u914d\u7f6e`majsoul_font=Microsoft YaHei`\u5c06\u4f7f\u7528\u5fae\u8f6f\u96c5\u9ed1\u5b57\u4f53\n\n### \u66f4\u6362\u4e3a\u5916\u90e8\u5b57\u4f53\n\n\u4fee\u6539\u914d\u7f6e\u9879`majsoul_font_path`\u4e3a\u5b57\u4f53\u8def\u5f84\uff0c\u5e76\u4fee\u6539\u914d\u7f6e\u9879`majsoul_font`\u4e3a\u5b57\u4f53\u540d\u3002\n\n\u4f8b\u5982\uff1a\u5728 https://github.com/lxgw/LxgwWenKai-Lite/releases \u4e0b\u8f7dLXGWWenKaiMonoLite-Regular.ttf\u5e76\u653e\u7f6e\u4e8ebot\u6839\u76ee\u5f55\uff0c\u914d\u7f6e`majsoul_font_path=LXGWWenKaiMonoLite-Regular.ttf`\uff0c\u914d\u7f6e`majsoul_font=LXGW WenKai Mono Lite`\n\n## \u914d\u7f6e\u9879\n\n### majsoul_query_timeout\n\n\u6307\u4ee4\u8d85\u65f6\uff08\u5355\u4f4d\uff1a\u79d2\uff09\n\n### majsoul_font\n\n\u7ed8\u56fe\u7528\u7684\u5b57\u4f53\u540d\u79f0\n\n### majsoul_font_path\n\n\u7ed8\u56fe\u7528\u7684\u5b57\u4f53\u6587\u4ef6\u8def\u5f84\n\n### majsoul_username\n\n\u4e0b\u8f7d\u724c\u8c31\u7528\u7684\u96c0\u9b42\u8d26\u53f7\u90ae\u7bb1\u3002\u63a8\u8350\u4f7f\u7528\u5c0f\u53f7\u3002\n\n### majsoul_password\n\n\u4e0b\u8f7d\u724c\u8c31\u7528\u7684\u96c0\u9b42\u8d26\u53f7\u5bc6\u7801\u3002\u63a8\u8350\u4f7f\u7528\u5c0f\u53f7\u3002\n\n## See Also\n\n- [nonebot-plugin-mahjong-utils](https://github.com/ssttkkl/nonebot-plugin-mahjong-utils)\uff1a\u65e5\u9ebb\u5c0f\u5de5\u5177\u63d2\u4ef6\u3002\u652f\u6301\u624b\u724c\u5206\u6790\u3001\u756a\u7b26\u70b9\u6570\u67e5\u8be2\u3002\n- [nonebot-plugin-mahjong-scoreboard](https://github.com/ssttkkl/nonebot-plugin-mahjong-scoreboard)\n  \uff1a\u65e5\u9ebb\u8ba1\u5206\u5668\u3002\u4e3a\u9762\u9ebb\u7fa4\u53cb\u63d0\u4f9b\u65e5\u9ebb\u5bf9\u5c40\u5206\u6570\u8bb0\u5f55\u3002\u6839\u636e\u9a6c\u70b9\u8fdb\u884cPT\u7cbe\u7b97\uff0c\u7edf\u8ba1PT\u589e\u51cf\uff0c\u652f\u6301\u5bf9\u5c40\u4e0e\u699c\u5355\u67e5\u8be2\u4e0e\u5bfc\u51fa\u3002\n\n## \u5728\u7ebf\u4e5e\u8ba8\n\n<details><summary>\u70b9\u51fb\u8bf7\u6211\u6253\u4e24\u628amaimai</summary>\n\n![](https://github.com/ssttkkl/ssttkkl/blob/main/afdian-ssttkkl.jfif)\n\n</details>\n\n## LICENSE\n\n[AGPLv3](https://raw.githubusercontent.com/ssttkkl/nonebot-plugin-majsoul/master/LICENSE)\n",
    "bugtrack_url": null,
    "license": "AGPL-3.0",
    "summary": "NoneBot2 \u96c0\u9b42\u4fe1\u606f\u67e5\u8be2\u63d2\u4ef6",
    "version": "0.2.5",
    "project_urls": null,
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "a041021b3b634a6f7e7109e767ff22dc38f3a5d65bc5e818b8cfc917b3b3508e",
                "md5": "fcd9796c08fcce1d89d6fed5611513bf",
                "sha256": "08c70bd4516e664f5249a14ce27908152551651a90c13fb2e22b78ebee2c5af0"
            },
            "downloads": -1,
            "filename": "nonebot_plugin_majsoul-0.2.5-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "fcd9796c08fcce1d89d6fed5611513bf",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.9,<4.0",
            "size": 44173,
            "upload_time": "2023-09-28T17:31:31",
            "upload_time_iso_8601": "2023-09-28T17:31:31.806098Z",
            "url": "https://files.pythonhosted.org/packages/a0/41/021b3b634a6f7e7109e767ff22dc38f3a5d65bc5e818b8cfc917b3b3508e/nonebot_plugin_majsoul-0.2.5-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "86b26169fcdf59d40986ccc66cfd00d27920a0f59b468b75b0cfdd34bba9f810",
                "md5": "b3a1c9f821d00dc08f0084e0179ba32e",
                "sha256": "f3f5b7eca1e7cc7e73f50aad6f22bfe1c99ef6bdb8fefbc7e0436f9512e209bf"
            },
            "downloads": -1,
            "filename": "nonebot_plugin_majsoul-0.2.5.tar.gz",
            "has_sig": false,
            "md5_digest": "b3a1c9f821d00dc08f0084e0179ba32e",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.9,<4.0",
            "size": 32203,
            "upload_time": "2023-09-28T17:31:33",
            "upload_time_iso_8601": "2023-09-28T17:31:33.635112Z",
            "url": "https://files.pythonhosted.org/packages/86/b2/6169fcdf59d40986ccc66cfd00d27920a0f59b468b75b0cfdd34bba9f810/nonebot_plugin_majsoul-0.2.5.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-09-28 17:31:33",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "nonebot-plugin-majsoul"
}
        
Elapsed time: 0.12032s