Ez2Lazer：osu!lazer 定制 Mania 客户端

项目简介

Ez2Lazer 是基于 osu!lazer 深度定制的分支，重点面向 Mania / BMS 工作流，提供可配置 HUD、可切换的判定系统以及谱面分析工具。项目基于 osu!，采用 MIT 许可，Ez2Lazer 的修改由 SK-la 维护。完整文档已迁移到 Wiki。

主要功能

• Mania / BMS 工作流：面向 Mania 与 BMS 谱面的游玩、导入与谱面预览。
• 皮肤系统：Ez 皮肤编辑器，支持游玩场景内的 HUD 层编辑、蓝图拖选与对齐吸附、旋转/缩放/翻转手柄与锚点菜单，以及可视化组件选择器。
• 谱面预览：全地图预览界面、预览图层编辑，Mania 全图预览可配置轨道背景色。
• 判定系统：可切换判定；Ez std 在非 StableClassic 判定轨也提供 stable 准确率。
• Mod 系统：资料提到新增 Catch 触摸移动 Mod 与 mania 扩展键数 Mod EXT。
• Aspire 谱面：支持 Aspire 谱面的导入与游玩。
• 编辑体验：剪贴板与 Edit 菜单（撤销/重做/剪切/复制/粘贴/克隆）。
• 性能与启动：设置分节预加载、ReadyToRun 发布、启动时间轴与帧率/GC 采样，可选 Server / Workstation GC 类型。

安装与使用

1. 从 Releases 下载 ez2lazer-win-Setup.exe 安装（需先安装 .NET 10 Desktop Runtime），之后游戏内会自动下载增量更新。
2. 手动安装可使用 Ez2Lazer_release_*.zip；zip 安装方式无法接收增量更新，需要改用 Setup 安装一次。
3. 下载资源包 EzResources（OneDrive） 并解压到数据目录。
4. 在设置中使用 Change folder location 指定数据路径，使资源位于 .../EzResources。

从源码构建时需同时克隆三个仓库：

git clone https://github.com/SK-la/Ez2Lazer
git clone https://github.com/SK-la/ez2lazer-framework
git clone https://github.com/SK-la/ez2lazer-resources

ez2lazer.Framework 与 ez2lazer.Game.Resources 的版本记录在 Ez2Lazer.Dependencies.props 中；开发时可通过 UseEz2LazerLocalFrameworkProject 与 UseEz2LazerLocalResourcesProject 开关切换到本地同级项目。

注意事项

• 没有 EzResources 资源包时，Ez Pro Skin 与 Ez HUD 组件会缺少贴图。
• 自行编译的版本会隐藏游戏内更新设置，也不会检查 SK-la/Ez2Lazer 的 Releases 更新。
• 项目采用 MIT 许可，但「osu!」「ppy」品牌受商标法保护，不在许可范围内；游戏资源遵循 ppy/osu-resources 的单独许可。
• 更多功能说明见 Wiki 的 Feature Overview。

本作品整理自 GitHub 开源项目 SK-la/Ez2Lazer，原作者 @SK-la，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。