1. 从下载页前往 GitHub，下载 Windows 客户端 ZIP。 2. 解压到可写目录，运行 OMS。 3. 在设置中确认 BMS 或 mania 的键位。
把完整歌曲文件夹放入对应目录，再到选歌页选择谱面：BMS 使用 chartbms，mania 使用 chartmania。 保留文件夹内的音频、BGA 和谱面文件，以及它们的相对路径。BMS 可以直接读取原文件，无需转成 .osz。 谱包由 Ginger Rush、616 或 Sayobot 原站提供；网站下载会转到原站。
IR 用于提交成绩和查看排行榜，目前仅在开发版试运行。公开下载的 20260626 版尚不支持。 当前开发版已固定连接 OMSIR。打开游戏内的账号窗口，即可直接注册或登录 OMS 账号，无需启用开关、填写地址或保存连接。未登录也可主动查看公开榜，离线游玩无需账号。 登录后捕捉其后的新局：成绩先保存在本地，再提交到网站；断网时保留原账号的待交记录。此前离线游玩的成绩不会因登录而自动补交。网页和游戏使用同一套 OMS 账号，但需要分别登录。
OMSIR 汇集各客户端提交的成绩。在网站谱面榜选择难度表与等级，再按首字母找到谱面；榜内可按客户端筛选。 BMS 排行榜按 EX SCORE 排列。ACC 是 EX / 最大 EX；最大连击、判定、Mod / Option 都沿用实际记录。同条件榜只比较规则和物量相同的 OMS 成绩。mania 成绩榜按同一计分条件下的公开最佳总分排列，也包含未通关成绩。 从旧 LR2IR 数据库继承的成绩与新成绩同榜显示，仅附“旧库”标记。旧账号保留原身份，同名不会自动合并到 OMS 账号。旧库的 SBMP 标记尚未确认对应客户端；未确认与未标记记录可在客户端筛选的展开项单独选择。 PG / GR / GD / BD / PR 分别表示 PGREAT、GREAT、GOOD、BAD、POOR。EP 是单独收录的空 POOR；OpenLR2 的 PR 已包含空 POOR，旧库也不能可靠拆分，EP 显示“—”。未收录的连击或时间同样显示“—”。 镜像、随机与血条使用一致的短标签和图标。MR 为镜像，RD / R-RD / S-RD 分别为 RANDOM / R-RANDOM / S-RANDOM；DP 的左右侧分别标 1P / 2P，FLIP 表示左右交换。标签统一不代表各客户端判定窗口与血条完全相同，跨客户端排名仍供参考。 最佳分和最佳通关灯可能来自不同记录；主行展示最高 EX 所在记录的判定与选项，独立最佳灯可在详情查看。
目前为 beatoraja 0.8.8、LR2oraja build11611350155、Endless Dream v0.4.0、OpenLR2 v260915 提供试运行插件，接口与文件已上线，实际播放器游玩联调仍待验收。经典原版 LR2 的实时接入尚未提供；OpenLR2 与 LR2oraja 是独立播放器。 先在网页账号页为对应播放器创建专用密钥，再下载匹配版本的插件。密钥只显示一次，填入播放器设置，不要使用网页密码。每种播放器使用对应的密钥，不再使用时可在账号页撤销。 其他播放器提交最佳状态，不提供每次游玩的记录，也没有可证实的本局时间。旧库记录保留已有判定与原选项；未收录字段不会补成零。
适用于 beatoraja、LR2oraja 和 Endless Dream 的上述版本： 1. 确认播放器版本，将对应 JAR 放入播放器的 ir/ 目录。 2. 在原启动器的 Java classpath 中加入 ir/*，保留原有项目；然后重启播放器，让插件被加载。 3. 在播放器的 IR 设置中选择对应的 OMS 插件。ID 填 OMS，Password 填为该播放器创建的专用密钥。 4. 保存并重启。插件默认连接 https://oms.zdamexy.work；有自建服务时可在原 Java 启动参数加入 -Domsir.origin=https://你的站点。 5. 检查播放器的 IR 连接提示，再完成一张标准 LN 谱面并在网站核对成绩。当前插件不支持 CN、HCN 或带随机分支的谱面。
适用于 OpenLR2 v260915： 1. 关闭播放器，选择与播放器 EXE 架构一致的 32 / 64 位 DLL，放入 LR2files/CustomIRs/OmsIR/。 2. 下载配置模板，将它以 omsir.json 保存到同一目录。origin 保留本站地址，integration_key 换成 OpenLR2 专用密钥。 3. 保留原 LR2files/Config/openlr2-config.xml 的备份，在已有 config → network 节点内设置 display_ir 为 OMS IR (OpenLR2 v260915)，用于选择原生榜显示插件。 4. 重新启动，查看插件目录内的 LastStatus.txt，核对连接结果；完成正常单谱游玩后，再核对网站成绩与播放器榜单。 OpenLR2 插件已包含所需解压依赖，无需另装 DLL。更换账号或密钥后重启播放器；不再使用时可在账号页撤销密钥。
可以在社区求助，或在 GitHub 报告问题。请写清客户端版本、谱面、操作步骤，以及出现的提示。截图和日志中请遮去密码、密钥与私人信息。
