nonebot-plugin-maimaidx

python3 License

欢迎加入开发交流群：QQGroup

重要更新

2026-06-30

  1. 替换 rating 数字新素材，直接覆盖 mai/pic 目录，增量包：

  2. 恢复查询TA人成绩的功能

  3. 修复15完成表绘图偏移的问题

  4. 修复进度表完成时文字重叠的问题

  5. 优化部分绘图

  6. 修复部分bug

2026-06-09

现仅支持 Python 3.10+ ！！！

最好在更新 舞萌DX 2026 后再使用该版本

  1. 更新支持 舞萌DX2026，应该是最后一次大改了
  2. 新支持了 落雪查分器
  3. 新功能：
    • 新增 舞，霸者 牌子绘图
    • 新增进度绘图
    • 新增查询曲目过多时的绘图
    • 新增切换主题功能
    • 新增切换查分器功能
    • 新增 ap50 指令（仅限落雪查分器）
    • 新增 lxbind，主题，数据源 指令
    • 新增 牌子条件 指令
  4. 修改了别名推送的发送方式，防止刷屏
  5. 修复了非常多的 BUG

温馨提示

请务必看完 README.MD 所有内容

安装

  1. 安装 nonebot-plugin-maimaidx

    • 使用 nb-cli 安装 
      nb plugin install nonebot-plugin-maimaidx
    • 使用 pip 安装 
      pip install nonebot-plugin-maimaidx
    • 使用源代码，请自行安装额外依赖 
      git clone https://github.com/Yuri-YuzuChaN/nonebot-plugin-maimaidx

  2. 安装 chromium，相关依赖已安装，请直接使用该指令执行

    playwright install --with-deps chromium

  3. 安装 微软雅黑 字体，解决使用 ginfo 指令字体不渲染的问题，例如 ubuntu：apt install fonts-wqy-microhei

配置

  1. 下载静态资源文件，将该压缩文件解压后，将 static 文件夹复制到随意一个文件夹进行存放。对于先前使用过的开发者，请将原先 static 文件夹内的所有 json 文件放置到 static/data 文件夹，字体文件放置到 static/font 文件夹

    对于美术的声明，请勿将绘图设计署名进行删除

  2. 配置可选项，请修改 .env 文件，并根据要求填写

    # maimaidx                           # 基本配置
MAIMAIDX_PATH=                       # 必填项，静态文件夹路径，必须为绝对路径到 `/static`，例如：e:/SakuraBOT/nbstatic/maimaidx/static
MAIMAIDX_ALIAS_PUSH=true             # 是否开启别名推送
MAIMAIDX_ALIAS_PROXY=false           # 是否使用中转访问柚子别名服务器，适用于境内服务器
SAVE_IN_MEMORY=true                  # 是否将部分图片保存在内存
ASSETS_ONLINE=true                   # 对于有 `icon` 和 `plate` 资源的可将此项改为 `false`，如果没有请默认，否则使用落雪查分器时无法使用

# diving-fish                        # 水鱼查分器配置
DIVINGFISH_TOKEN=                    # 开发者 token，由于水鱼查分器修改了请求鉴权，未填写的仅可使用 `b50` 指令
DIVINGFISH_PROBER_PROXY=false        # 是否使用中转访问水鱼查分器，适用于境外服务器

# lxns                               # 落雪查分器配置，均未填写将无法使用落雪查分器
LXNS_DEV_TOKEN=                      # 开发者 token
LX_CLIENT_ID=                        # OAuth 应用ID，OAuth权限范围请选择前三项，不包括「读取个人API秘钥」
LX_CLIENT_SECRET=                    # OAuth 应用秘钥
REDIRECT_URI=                        # OAuth 回调地址
LXNS_BIND_PRIVATE_ONLY=false         # 是否仅允许私聊完成 OAuth 绑定，默认允许群聊和私聊

[!NOTE] 使用落雪 OAuth 绑定时，可在群聊或私聊发送 lxbind，按提示完成授权后发送授权码或完整回调链接；群聊发起的绑定也可以转到同一 Bot 的私聊完成。若设置 LXNS_BIND_PRIVATE_ONLY=true，群聊只会提示用户添加 Bot 好友后前往私聊。部分 OneBot 实现无法接收陌生人的私聊消息，因此该选项默认关闭。

[!NOTE] 安装完插件需要使用定数表或完成表指令时，需私聊Bot使用 更新定数表 和 更新完成表 进行生成

[!NOTE] 插件带有别名更新推送功能，默认开启全部群组推送，不需要请私聊Bot使用 全局关闭别名推送 指令关闭所有群组推送。群组需要单独使用请使用指令 开启别名推送。

指令

使用说明图后续再进行更换

img

更新说明

Version 3.0 更新日志

2026-06-09

  1. 更新支持 舞萌DX2026，应该是最后一次大改了
  2. 新支持了 落雪查分器
  3. 新功能：
    • 新增 舞，霸者 牌子绘图
    • 新增进度绘图
    • 新增查询曲目过多时的绘图
    • 新增切换主题功能
    • 新增切换查分器功能
    • 新增 ap50 指令（仅限落雪查分器）
    • 新增 lxbind，主题，数据源 指令
    • 新增 牌子条件 指令
  4. 修改了别名推送的发送方式，防止刷屏
  5. 修复了非常多的 BUG

鸣谢

感谢 蓝色彗星 提供的 牌子条件 指令图片

License

MIT

您可以自由使用本项目的代码用于商业或非商业的用途，但必须附带 MIT 授权协议。

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (3.1.3)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for yuzuchan from gravatar.com yuzuchan

Credits

Author: Yuri-YuzuChaN

License expression

MIT
View SPDX License List

Requires

Python >=3.10

Classifiers

Report project as malware

Metadata

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (3.1.3)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for yuzuchan from gravatar.com yuzuchan

Credits

Author: Yuri-YuzuChaN

License expression

MIT
View SPDX License List

Requires

Python >=3.10

Classifiers

Report project as malware

Release files for nonebot-plugin-maimaidx 3.0.14

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for nonebot-plugin-maimaidx 3.0.14
File Size Uploaded
nonebot_plugin_maimaidx-3.0.14.tar.gz 1.1 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for nonebot-plugin-maimaidx 3.0.14
File Interpreter ABI Platform
nonebot_plugin_maimaidx-3.0.14-py3-none-any.whl 1.1 MB Python 3 none any Details

Total release size: 2.2 MB

Release files / nonebot_plugin_maimaidx-3.0.14.tar.gz

Download URL nonebot_plugin_maimaidx-3.0.14.tar.gz
Size 1.1 MB
Tags Source
SHA-256 checksum
How to use checksums 		9708ad4910c0a538862fc20bf0a89def0d03d8c56805468fe00aa65d3f6fbadc
BLAKE2b-256 checksum
How to use checksums 		af8d95420af22b9e5f73826f84ce3a1c06c7c742bd4fcb7fb20f21fc72134c2b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing? 		No
Uploaded via twine/6.1.0 CPython/3.11.0

Release files / nonebot_plugin_maimaidx-3.0.14-py3-none-any.whl

Download URL nonebot_plugin_maimaidx-3.0.14-py3-none-any.whl
Size 1.1 MB
Tags Python 3
SHA-256 checksum
How to use checksums 		cc7242dc29d5993c0f785b162ac84cc0511b472d2c70b6612593e626b8febd21
BLAKE2b-256 checksum
How to use checksums 		f7c5047e10dff2d488ea957d2d2f096583f8f23327c20843b8565da5e4d717f0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing? 		No
Uploaded via twine/6.1.0 CPython/3.11.0

Release history Release notifications | RSS feed

3.1.3

2 release files

3.1.2

2 release files

3.1.1

2 release files

3.1.0

2 release files

This release

3.0.14 This release

2 release files

3.0.13

2 release files

3.0.12

2 release files

3.0.11

2 release files

3.0.10

2 release files

3.0.9

2 release files

3.0.8

2 release files

3.0.7

2 release files

3.0.6

2 release files

3.0.5

2 release files

3.0.4

2 release files

3.0.3

2 release files

3.0.2

2 release files

3.0.1

2 release files

3.0.0

2 release files

2.1.11

2 release files

2.1.10

2 release files

2.1.9

2 release files

2.1.8

2 release files

2.1.7

2 release files

2.1.6

2 release files

2.1.5

2 release files

2.1.4

2 release files

2.1.3

2 release files

2.1.2

2 release files

2.1.1

2 release files

2.1.0

2 release files

2.0.7

2 release files

2.0.6

2 release files

2.0.5

2 release files

2.0.4

2 release files

2.0.3

2 release files

2.0.2

2 release files

2.0.1

2 release files

2.0.0

2 release files

Pre-release

2.0.0b1

2 release files

1.0.15

2 release files

1.0.14

2 release files

1.0.13

2 release files

1.0.12

2 release files

1.0.11

2 release files

1.0.10

2 release files

1.0.9

2 release files

1.0.8

2 release files

1.0.7

2 release files

1.0.6

2 release files

1.0.5

2 release files

1.0.4

2 release files

1.0.3

2 release files

1.0.2

2 release files

1.0.1

2 release files

1.0.0

2 release files

0.0.15

2 release files

0.0.14

2 release files

0.0.13

2 release files

0.0.12

2 release files

0.0.11

2 release files

0.0.10

2 release files

0.0.9

2 release files

0.0.8

2 release files

0.0.7

2 release files

0.0.6

2 release files

0.0.5

2 release files

0.0.4

2 release files

0.0.3

2 release files

0.0.2

2 release files

0.0.1

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page