Mai-gen-videob50项目国际服/日服B50数据导入完全指南

项目概述

Mai-gen-videob50是一个专为maimai DX玩家设计的工具，能够从国际服或日服官网直接获取玩家的B50数据，并生成可视化的成绩图表。该项目特别适合那些无法使用国服查分器的海外玩家，提供了多种数据导入方式，包括直接从游戏官网获取HTML源代码或通过第三方网站导出JSON数据。

数据导入方式详解

方法一：从maimai DX NET官网获取HTML源代码

操作步骤

1. 访问对应服务器官网：

   • 国际服：进入Rating对象乐曲页面
   • 日服：进入Rating对象乐曲页面（需注意这是SEGA的付费服务，月费330日元）

2. 获取页面源代码：

   • 等待页面完全加载
   • 使用快捷键Ctrl+U或右键菜单选择"查看网页源代码"
   • 复制显示的所有HTML代码

注意事项

• 确保页面完全加载后再获取源代码
• 日服数据读取功能可能存在不稳定性，如遇问题建议反馈

方法二：通过DXrating网站获取JSON数据

操作步骤

1. 访问DXrating网站并完成以下操作：

   • 点击"IMPORT"按钮
   • 选择"Import from offical maimai NET..."选项
   • 按照提示完成数据导入

2. 导出JSON数据：

   • 确认页面中央的maimai logo处选择了正确的区服
   • 点击"EXPORT"按钮
   • 选择"Export JSON (Only B50 records)"选项
   • 下载并打开生成的JSON文件，复制内容

注意事项

• DXrating数据可能存在更新延迟
• 大版本更新前后的B15数据可能不准确
• 如无法打开JSON文件，可尝试用记事本打开或修改文件后缀为.txt

数据导入后的处理流程

1. 在应用中选择"导入B50数据源代码"选项
2. 粘贴之前复制的HTML或JSON内容
3. 根据数据类型选择对应的"读取B50"按钮
4. 系统会自动在指定目录保存数据文件，格式为：
   • HTML数据：b50_datas/{user_id}/{用户名}.html
   • JSON数据：b50_datas/{user_id}/{用户名}.json

项目特色功能

1. 多数据源支持：既可从官网直接获取，也可通过第三方网站导入
2. 数据本地保存：导入的数据会自动保存，方便后续使用
3. 自动更新机制：歌曲列表文件会自动同步更新
4. 国际服/日服兼容：支持不同服务器的数据格式

常见问题解决方案

数据读取问题

• 错误提示：No HTML/JSON file found 解决方案：检查数据文件是否放置在正确目录，确认网页端数据加载完整

• 错误提示：HTML screw not found 解决方案：确认操作的是正确的Rating对象乐曲页面，等待页面完全加载

数据生成问题

• list index out of range错误 原因：B50包含数据库中未收录的谱面 解决方案：更新本地歌曲数据库

• B50定数显示不正确 原因：本地数据库缺少对应乐曲数据 解决方案：手动更新歌曲数据库

视频缓存问题

• 错误的缓存视频 解决方案：删除或重命名格式为"-XX-Y-DX.mp4"的缓存文件

• 多个谱面指向同一个None开头的视频 原因：新曲目缺少内部ID（v0.3.3版本常见问题） 解决方案：更新到最新版本

歌曲数据库维护

当前版本(v0.5.1)的数据库已更新至日服2025年4月11日的内容，包括Phigros联动等新增曲目。数据库每周自动同步一次。

手动更新数据库方法

1. 获取最新的songs.json文件
2. 替换项目目录中.\music_metadata\maimaidx下的同名文件
3. 注意需在点击"开始使用"按钮后进行替换操作

项目开发进展

已完成功能：

• DXrating网站B50数据支持
• 歌曲列表自动更新

计划开发功能：

• 改进成绩获取方式（DX score、FC/FS等级）
• 支持AP50等其他数据源

技术提示

对于开发者或高级用户，建议了解以下技术细节：

1. 数据文件存储结构
2. 歌曲数据库更新机制
3. 错误处理逻辑
4. 视频缓存管理策略

通过本文的详细指南，即使是初次接触Mai-gen-videob50项目的用户也能顺利完成B50数据的导入和处理。如果在使用过程中遇到特殊问题，建议参考错误提示信息并对照本文的解决方案进行处理。