DanceCubeBot

前路漫漫亦灿灿

愿我们终将在更好的未来重逢！

编辑于 2025.5.10

这是一个基于Mirai & Java的舞立方机器人 目前只测试在舞小铃的账号上， 如果你看到了这个机器人，就说明它的框架是这个b写的

给个star或许我会很开心🥰

功能介绍

用户可用功能：

• 手机号或扫码至登录机器人
• 查看个人信息（图片，战力，排行，金币，积分等等）
• 查看战力分析（图片，b15/r15，单曲详情等等）
• 查看战力截图（模仿舞立方秀绘制）
• 舞立方机台二维码登录（发送给机器人二维码）至少不用微信扫码了
• 查找地区在线/离线的舞立方（包括舞立方秀）
• 自动批量兑换自制谱兑换码
• Token每日自动更新
• ...更多请查看舞小铃主页使用文档

---

管理员可用功能：

• 读取/写入 Tokens
• 设置默认 Token
• 查看个人 Token
• 强制刷新 Token

一些咕咕咕还没做的功能：

• 新版战力分析
• 今日运势
• 谱师功能

或许等到2077年才能做出来💦💦

---

以下内容更新于2024.7.19，过时内容如需细节请联系开发者

搭建指南

如果你只是插件使用者，只要配置好文件就行了

文件配置

前情提要：不难的其实，就是第一次有一点点的麻烦了...

当然，后续可能会优化

---

首先要在与 mcl文件夹 并列的目录下
创建一个文件夹 DcConfig放入如下文件，使用如下文件结构（注意DcConfig在mcl外面）

*当然如果你没有主动配置文件夹，插件也会自己生成
- root
- mcl
 - mcl
 - plugins
 - ...
- DcConfig （见下一代码块）
  - Images
  - ...

---

这是DcConfig的结构（tree生成的，看不懂怪ms去）

DcConfig
│  ApiKeys.yml
│  OfficialMusicIds.json
│  TokenIds.json
│  UserTokens.json
│
└─Images
    │
    ├─Cover
    │  │  default.png
    │  │
    │  ├─CustomImage
    │  │      1011.jpg
    │  │      1023.jpg
    │  │      1026.jpg ...
    │  │      default.png
    │  │
    │  └─OfficialImage
    │          101.jpg
    │          106.jpg
    │          115.jpg ...
    │          default.png
    │
    ├─UserRatioImage
    │      A.png
    │      B.png
    │      Background1.png
    │      C.png
    │      Card1.png
    │      Card2.png
    │      Card3.png
    │      D.png
    │      result.png
    │      S.png
    │      SS.png
    │      SSS.png
    │
    └─UserInfoImage
            Background1.png
            Background2.png

其实是我不会写Mirai配置文件，才把文件夹放在外面的

---

以下是相关文件作用

文件	类型	功能	要求
Images	文件夹	存放素材图片文件	手动配置
UserTokens.json	文件	用于保存用户令牌	无需手动配置
TokenIds.json	文件	用于获取二维码登录	手动配置
ApiKeys.yml	文件	用于API令牌	手动配置
UserCommands.json	文件	用于保存用户信息触发指令	无需手动配置

TokenIds

用于登录时获取二维码，需要在 舞立方制谱网站 上 抓包找到一个名为Token的POST请求，然后多复制几个负载中的client_id，写入DcConfig里面

类似于：client_id: yyQ6*****N4WUUQ8 的

以json格式写入文件如下（星号是我加的）

[
  "yyQ6VxqMeIL2hceWzZ******81Ru8pIE",
  "yyQ6VxqMeILLsdi*****SnddhlyVGcNa",
  "yyQ6VxqMeILneEzfVyXPFVCZo****oH3",
  "yyQ6VxqMeIL2h**********xNf/hHSzH",
  "yyQ6Vxq******zVmQuHtNAU******xmR"
]

可能你会发现不管开几个标签都是一样的，可以尝试先登录一个二维码，再打开另一个标签页

ApiKeys

用于二维码识别和地名转经纬度

本项目使用的是腾讯SDK和高德地图 的API，每月限度充足且免费，所以请自行申请API令牌

所以别偷我的Key了！！

---

当然，如果有别的需求或者使用其它第三方平台SDK，请自己修改源码

# 腾讯OCR SDK密钥
tencentScannerKeys:
  secretId: AKIDK****TBnFXeibIm*********
  secretKey: HLCrQoyzrZ8Z1************
# 高德地图定位 SDK密钥
gaodeMapKeys:
  apiKey: b1bbd99c****1172**************

唯独这个是YML文件，因为我觉得这个最像配置文件

Images

配置文件中已含有背景图片

如果想自定义模板，需要修改Image类的源码
你也可以进入即时设计中获取本图片模板，自行设计

开发帮助

看不懂？翻翻源码就知道了！

指令功能

本机器人支持正则指令和参数指令两种指令触发

所有的指令存放在 AllCommands 类中，具体在声明指令后， 会在调用 init() 后，被自动保存到如下两个属性中

public class AllCommands {
  public static HashSet<RegexCommand> regexCommands = new HashSet<>();  //所有正则指令
  public static HashSet<ArgsCommand> argsCommands = new HashSet<>();  //所有参数指令

  // your commands...
}

指令声明

你需要使用 @DeclaredCommand("name") 来声明一个public static final指令对象，
没有 @DeclaredCommand("name") 的对象不会被保存，
参数为指令名，没有实际用途，仅便于开发者，使用具体见以下实例

正则指令

你可以通过 RegexCommandBuilder 链式调用来创建一个 RegexCommand 对象，例如：

public class AllCommands {

  @DeclaredCommand("舞立方自制谱兑换")  //指令声明
  public static final RegexCommand gainMusicByCode = new RegexCommandBuilder()
          .regex("[a-zA-Z0-9]{15}", false)
          .onCall(Scope.USER, (event, contact, qq, args) -> {
            Token token = loginDetect(contact, qq);
            if(token==null) return;

            // type your code here

          }).build();
}

---

regex(String regex, boolean lineOnly)
正则匹配方式，regex为正则表达式字符串， lineOnly为是否仅匹配单行，当为true时会默认加上 ^...$ 行匹配标识，默认为true

onCall(Scope scope, MsgHandleable (lambda) )
调用指令，scope为作用域，lambda为调用指令实现体，你需要传入(event, contact, qq, args) -> {},其中args无需实现。

build()
构建指令，返回一个RegexCommand对象

参数指令

类似于正则指令，你需要使用ArgsCommandBuilder来创建一个ArgsCommand对象

public class AllCommands {
  @DeclaredCommand("查找舞立方机台")
  public static final ArgsCommand msgMachineList = new ArgsCommandBuilder()
          .prefix("查找舞立方", "查找机台", "舞立方")
          .form(ArgsCommand.CHAR)
          .onCall(Scope.GROUP, (event, contact, qq, args) -> {
            if(args==null) return;

            // type your code here...

          }).build();
}

---

prefix(String... name)
用于声明一个参数指令的前缀，仅当消息触发前缀后才会匹配参数

form(Pattern... patterns)
声明参数的格式，建议使用ArgsCommand类提供的模板：

public class ArgsCommand extends AbstractCommand {
  // 数字
  public static final Pattern NUMBER = Pattern.compile("\\d+");
  // 字母＋数字
  public static final Pattern WORD = Pattern.compile("[0-9a-zA-z]+");
  // 非空字符
  public static final Pattern CHAR = Pattern.compile("\\S+");
}

onCall(Scope scope, MsgHandleable (lambda) )
和参数指令类似，但是获取参数的值需要使用到args来获取（需要做非null判定）

作用域

public enum Scope {
  GLOBAL, // 全局指令
  USER, // 仅用户
  GROUP, //仅群聊
  ADMIN, //仅管理员（大铃）
}

作用域用于对不同的聊天环境触发不同的onCall()功能

一些提醒

如果真的有人需要搭建，以下是一些注意事项：

• 请不要高频http请求
• 请遵循开源协议
• 本项目和广州市胜骅动漫科技有限公司无关

鸣谢

• 感谢 艾鲁Bot 的API提供 呜呜呜，我的寄鲁😭
• 感谢各个开发者的测试与帮助