MapleLegends Linux Wine 指南

中文（默认） | English

致谢与来源

本仓库基于社区已有的 Linux 运行经验、安装脚本思路和排障线索整理而来。
在这些前人工作的基础上，当前仓库中的安装与启动脚本由 OpenAI Codex 迭代生成，并在 Ubuntu 24.04 + Wine 9 环境进行了实机验证。

参考链接（信息来源与依赖项目）：

• MapleLegends 官网：https://maplelegends.com/
• 社区安装器参考仓库：https://github.com/Yareeeef/MapleLegends-installer
• Wine 项目：https://www.winehq.org/
• Gamescope 项目：https://github.com/ValveSoftware/gamescope
• Ubuntu 24.04 gamescope PPA：https://launchpad.net/~mortigar/+archive/ubuntu/gamescope

默认下载源

• 默认客户端下载地址：https://maplelegends-mirror.ylivay.dev/installers/MAC11JAN2026.pkg
• 你可以通过 --url 参数或环境变量 ML_CLIENT_URL 覆盖默认下载源。
• 默认下载策略来自 scripts/version.yml，支持 direct/gdrive/mega/local 四种来源。

默认一键安装行为

执行：

bash scripts/install-client.sh

默认会按以下流程执行：

1. 安装到 ~/Games/MapleLegends。
2. 下载客户端包到临时目录。
3. 自动解包 .pkg（含 Payload）并提取 Game/MapleLegends.exe 等文件。
4. 初始化 Wine 32-bit 前缀（~/<install_dir>/.wine）。
5. 写入兼容设置：MapleLegends.exe=win98，ws2_32/ws2help=builtin。
6. 写入 Legends.ini 默认值：HDClient=1、Windowed=true。
7. 生成 run.sh（基础启动）与 run-2x.sh（NIS + 自动缩放）。
8. 默认创建桌面启动器（指向 run-2x.sh）。

自更新与多下载源

• 自更新（先更新仓库再继续安装）：

bash scripts/install-client.sh --update

• 下载源配置文件：scripts/version.yml
  • download_from: direct 使用 direct_url
  • download_from: gdrive 使用 gdoc_fileid
  • download_from: mega 使用 mega_url（通过 scripts/megafetch.sh 解析并解密）
  • download_from: local 使用 local_path

我们的改进

• 提供真正的一键安装脚本（下载/解包/Wine 前缀初始化/启动器创建）。
• 固化默认可运行的 winsock 策略（默认 builtin）。
• 增加 gamescope 自动适配 HDClient 的启动脚本。
• 默认启用 NIS + sharpness，并在分辨率不足时自动回退 fit。
• 汇总常见错误（Wah*、黑边、HDClient=2 不稳）与处理方法。

适用环境

• Ubuntu 24.04.x
• Wine 9.x（32-bit 前缀）
• 可选：gamescope（用于窗口放大和锐化）

仓库内容

• scripts/install-client.sh：一键安装（下载 + 解包 + 初始化 + 启动器）
• scripts/ml-run.sh：基础启动脚本（默认 builtin winsock）
• scripts/ml-run-nis-auto.sh：默认 NIS + 自动适配 HDClient
• scripts/install-launcher.sh：安装/更新桌面启动器
• scripts/version.yml：下载源配置（direct/gdrive/mega/local）
• scripts/megafetch.sh：MEGA 下载解析与解密参数提取
• docs/TROUBLESHOOTING.md：常见问题和修复
• docs/WORKING-CONFIG.md：已验证可用配置

前置依赖

sudo dpkg --add-architecture i386
sudo apt update
sudo apt install -y wine wine32 xrandr x11-utils openssl

Ubuntu 24.04 官方源通常没有 gamescope，可用 PPA：

sudo add-apt-repository ppa:mortigar/gamescope
sudo apt update
sudo apt install -y gamescope

快速开始

cd /path/to/maplelegends-linux-wine
bash scripts/install-client.sh

安装后启动：

bash "$HOME/Games/MapleLegends/run-2x.sh"

常用参数与环境变量

• --install-dir <dir>：安装目录
• --update：先自更新仓库再安装
• --url <url>：自定义下载源
• --file <path>：从本地安装包安装
• --source-dir <dir>：从已解包目录安装
• --force：覆盖已有安装目录
• ML_SHARPNESS：NIS/FSR 锐化等级（0-20，默认 4）
• ML_FILTER：nis|fsr|nearest|linear|pixel（默认 nis）

gamescope 快捷键

• Super + Y：切换 NIS
• Super + U：切换 FSR
• Super + N：切换 nearest
• Super + I：增加锐化
• Super + O：减少锐化
• Super + G：切换键盘抓取

说明

• 本仓库不包含 MapleLegends 客户端文件，仅提供 Linux/Wine 运行配置。
• MapleLegends 及相关资源版权归原项目方所有。