[Feature] 支持在 macOS 上直接安装汉化补丁 ZIP
Maintainer thường phản hồi trong vòng 1 ngày
Chưa có ai nhận issue này.
Đánh giá
- Độ khó
- 5/5
- Thời gian dự kiến
- Hơn một tuần
- Mức phù hợp với người mới
- 45/100
Hướng nghiên cứu
Bắt đầu bằng cách xác định điểm vào của menu instance hoặc mục quản lý tệp của instance, cùng với luồng import integration-pack hiện có. Xem lại cách launcher chọn một instance và trích xuất nội dung archive trước khi định nghĩa luồng hợp nhất và xem trước ZIP. Hoàn thành nghĩa là có xác thực đường dẫn tương đối an toàn, xác nhận rõ ràng cho các lựa chọn tạo mới/ghi đè/bỏ qua, giữ nguyên các tệp không liên quan và số lượng kết quả sau khi cài đặt.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
概述 | Summary
希望 HMCL 支持从 ZIP 文件直接安装“汉化补丁/覆盖文件包”到指定的 Minecraft 实例。此类 ZIP 通常使用游戏目录的相对路径（例如 config/、kubejs/、mods/、resourcepacks/ 或 vaultpatcher/），并不是一个完整的整合包，不能方便地通过现有的整合包导入流程安装。
On macOS, users should be able to select an instance and a localization overlay ZIP in HMCL and apply it safely without relying on Finder copy/paste or an external script.
原因 | Reason
提出这个功能的直接原因不是单纯找不到实例目录，而是 macOS Finder 对这类补丁的复制、粘贴、目录合并和同名文件覆盖处理不适合实际使用。汉化补丁往往包含大量与现有实例同名的目录和文件，Finder 粘贴后的合并/覆盖结果不够明确，也难以确认是否完整应用，容易导致部分汉化没有生效。
目前用户只能手动尝试 Finder 操作，或运行额外的 .command 脚本。后者虽然可以解决问题，但不是 HMCL 内置能力，普通用户也很难发现和验证脚本来源。
以 All the Mods 10 的一个汉化补丁为例，ZIP 中包含数百个需要覆盖或新增的 config/、mods/ 等文件。脚本实际处理了 316 个游戏文件，其中写入 268 个、内容一致跳过 48 个；这说明补丁本质上是“针对已有实例的文件覆盖包”，而不是完整整合包。
详情 | Description
可以在实例菜单或实例文件管理页面增加“导入汉化补丁 / 覆盖文件 ZIP”操作：
- 让用户选择目标实例和 ZIP 文件。
- 按 ZIP 内的游戏目录相对路径安全地合并文件，而不是依赖 Finder 的粘贴行为。
- 预览将要新增、覆盖、跳过的文件，并在覆盖前明确确认。
- 仅接受安全的相对路径，拒绝绝对路径和包含
..的路径，避免 ZIP 路径穿越。 - 安装时保留补丁中未包含的现有文件，并在完成后显示写入、跳过和未处理文件数量。
- 如果实现成本允许，可同时支持 Windows、Linux；macOS 是最迫切的使用场景。
该功能不要求 HMCL 识别每个汉化包的具体来源，只需要提供一个安全、可复用的“将 ZIP 内容合并到实例目录”的入口即可。
当前用于验证需求的 macOS .command 脚本（已包含文件校验、原子写入、路径安全检查和处理结果统计）如下：
https://gist.github.com/ct-yx/3bbb2bc4430a2b63fbe813dd1e2f80fa
- Ngôn ngữ chính
- Java
- Star
- 10.2k
- Fork
- 940
- Merge trung bình
- 2 ngày 7 giờ
- Pull request đã merge (30 ngày)
- 38
Chuẩn bị môi trường
- Không có Dockerfile hay tệp Docker Compose
- Không có mẫu pull request
- Đọc hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của HMCL-dev/HMCL
-
[Feature] 关于启动游戏进度条显示的优化Có thể đã có người làm @isHuaMouRen đã nhận 2 ngày trước. Đang mởenhancement
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 75/100
HMCL-dev/HMCL#6943 · 8 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
-
enhancement
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 68/100
HMCL-dev/HMCL#6934 · 1 bình luận · 1 reaction ·
Maintainer thường phản hồi trong vòng 1 ngày
-
[Feature] 导出整合包的路径选择器预设文件名拼接版本信息Đang mởenhancement
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 68/100
HMCL-dev/HMCL#6681 · 1 reaction ·
Maintainer thường phản hồi trong vòng 1 ngày
-
bug
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 68/100
HMCL-dev/HMCL#6134 · 3 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
-
[Feature] 添加防倒卖提示弹窗Đang mởenhancement
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 72/100
HMCL-dev/HMCL#6065 · 1 bình luận · 1 reaction ·
Maintainer thường phản hồi trong vòng 1 ngày
Tất cả issue của HMCL-dev/HMCL
Issue tương tự
-
Độ khó 1/5 Dưới một giờ Mức phù hợp với người mới 74/100
Maintainer thường phản hồi trong vòng 1 ngày
-
team:Lumberjack
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 76/100
OpenLiberty/open-liberty#35998 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
[BUG] SQS SendMessageBatch accepts more than 10 entries instead of TooManyEntriesInBatchRequestĐang mở
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 67/100
floci-io/floci#5319 · 1 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Bug QWP
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 79/100
Maintainer thường phản hồi trong vòng 3 ngày
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 64/100