
一款小型模组,允许 Minecraft 直接安装采用 .mcinstance 格式的整合包(modpack),这是一种简化的整合包分发格式。它支持下载文件、打包覆盖项等功能。安装完成后,游戏会提示重启,并禁用该 mcinstance 文件以确保游戏能够正常重新启动。
你会将这个模组移植到其他版本吗?
我目前尚未着手移植此模组,但这已在计划之中。我们的目标是为尽可能多的玩家提供 mcinstance 格式。
目前我仅从 1.7.10 版本开始尝试,待模组准备就绪后可能会进行移植。
你也可以通过查看 Github 来帮助移植此模组。毕竟,这是一个采用 MIT 许可证授权的模组,因此你可以自由尝试并将其移植到你想要的任何版本(无论是 1.3.2、1.18,还是 Forge、Fabric 等)。
简单来说,.mcinstance 格式是什么?
MCInstance 格式(.mcinstance)由一个重新利用的 ZIP 文件组成,具有特定的内部结构,并包含类似于 INI 格式的 .packconfig 文件。
本模组旨在允许在游戏中安装该格式,使其能够作为跨平台的整合包格式使用。第三方启动器也可以添加对此的支持,从而允许用户直接双击文件来安装整合包。
功能
以下是本模组和该格式中包含的一些功能:
-
像其他格式一样,可以将任何文件打包到
overrides文件夹中。其中的文件会被复制到 Minecraft 根目录(通常是.minecraft)。 -
为整合包玩家提供的“继承”文件夹。这样玩家可以将任何文件放入其中,它们也会被合并,覆盖整合包之前下载/打包的内容。
-
从互联网(任意 URL)下载文件,并将其保存到 Minecraft 文件夹中的任意位置。
-
支持 Modrinth 和 Curseforge API(在出现失败时设有多种备用模式)。
-
对下载文件的哈希校验(目前支持
SHA-512、SHA-252、SHA-1、MD5或CRC32) -
哈希文件的缓存系统(如果文件是从 API 下载的,它会尝试也从 API 获取哈希值),以便在更新后无需重新下载所有内容。
-
StopModReposts 检查,以 discouraging 使用重发布网站。如果需要,可以关闭此功能。
-
区分服务端/客户端的文件,因此你只能在服务器端或客户端下载特定文件。这对于 GUI 模组等非常有用。
-
非常灵活的可选文件系统,配有菜单界面,支持分组、多个菜单以及可配置数量的可切换项的多选 GUI。(目前仅限客户端,稍后将提供服务器端的实现)
-
完整的日志系统,方便你轻松检查与此模组相关的具体问题。结合 Forge 日志的详细模式选项使用效果更佳。
-
可切换的更新检查器,以保持本模组的最新版本。
-
Forge 进度条集成,在加载屏幕显示一个新的进度条,让人们可以看到还有多少模组需要下载。
-
自定义信息 GUI,用于替换主菜单,以通知用户错误情况或成功状态。这是为了确保人们重启游戏并正确加载可能已添加的模组。支持自动退出计时器、自定义成功消息或任何更改菜单的模组(可以设置一组类列表)
-
成功后自动禁用
pack.mcinstance,可以选择删除该文件或仅禁用该功能。这对于让用户在安装成功后正常游玩游戏是必要的。
那么我该如何使用它?
查看 wiki 页面,了解更多关于本模组和 mcinstance 格式的信息。
致谢与许可
许可声明:
尽管本模组根据 MIT 许可证分发,但该许可证不适用于 net.lingala.zip4j 包中的任何文件,因为这是 zip4j 库的源代码,此处仅为了方便使用而分发。zip4j 库根据 Apache License 2.0 授权,此处捆绑的版本为 2.9.1 版。
致谢:
- Srikanth-lingala 创建了 zip4j 库,本模组使用了该库。
- AstroTibs 制作了 OptionsEnforcer,这给了我灵感。
- Janrupf 和 HansWasser 创建了 ModDirector,这也启发了本模组。

A small mod to allow Minecraft to directly install a modpack in the .mcinstance format, a simplified distribution format for modpacks. It lets people download files, bundle overrides and much more. The game asks for a reboot after installation and disables the mcinstance file to let the game restart properly.
Will you port this mod to other versions too?
I'm not working on porting this mod yet, but this is planned. The goal is to provide the mcinstance format for as much people as possible.
I'm just starting with 1.7.10 for now, might port it when i feel the mod is ready.
You can also help port the mod by looking at the Github. After all, this is a MIT-licensed mod, so feel free to try and make a pull request to port it to any version you'd like (be it 1.3.2, 1.18, Forge, Fabric etc)
So basically what is the .mcinstance format?
The MCInstance format (.mcinstance) consists of a repurposed ZIP file, with a specfic layout inside, and containing things like .packconfig files which are very similar to the INI format.
This mod aims to allow its installation inside the game so it can be used as a cross-platform modpack format. Support for it could also be added inside 3rd-party launchers to directly allow people to double click the file and install the pack.
Features
Here are some features included in both this mod and the format:
-
Bundle any file inside the overrides folder, just like other formats. Files there get copied to the minecraft root directory (usually
.minecraft). -
A carryover folder for modpack players. That way players can put any file in it, and they will get merged as well, overwritting what the pack might have downloaded/bundled before.
-
Download files from the internet (any URL) and save them anywhere in the minecraft folder.
-
API support for both Modrinth and Curseforge (with multiple modes in place if something fails).
-
Hash checks for downloaded files (
SHA-512,SHA-256,SHA-1,MD5orCRC32for now) -
A cache system for hashed files (if the file is downloaded from an API, it tries to grab the hashes from the API too), to not have to redownload everything after an update.
-
StopModReposts checks, to discourage the use of repost websites. This can be toggled off if needed.
-
Sided files, so you can only download certain files on server or on the client. Useful for GUI mods and what not.
-
A very flexible optional files system, with a menu in place, grouping support, multiple menus and multi-choice GUIs with a configurable amount of togglable items. (Client side for now, will have an implementation for servers later on)
-
A complete log system in place so you can easily check issues specific to this mod. Combined with a verbose option for Forge logs.
-
A togglable update checker, to keep this mod up-to-date.
-
Forge progressbar integration, displays a new progress bar in the loading screen, so people can see how many mods are left to be downloaded.
-
A customisable Info GUI that replaces the main menu, to notify the user of errors or successs. This is to make sure that people restart the game and correctly load mods that might've been added. Supports an auto-quit timer, a custom success message or any mod that changes the menu (a list of classes can be set)
-
Automatic
pack.mcinstancedisabling after success, with the possibility to delete the file, or disable that feature instead. This is necessary to let people play the game after a succesful install.
So how do i use it?
Check out the wiki pages to learn more about this mod and the mcinstance format.
Credits & licensing
Licensing:
Even though this mod is distributed under MIT, this license doesn't apply to any file in the net.lingala.zip4j package, as this is the source code for the zip4j library, and only distributed here for ease of use. The zip4j library is licensed under the Apache License 2.0 and the version bundled here is the 2.9.1 release.
Credits:
- Srikanth-lingala for creating the zip4j library, which this mod uses.
- AstroTibs for making OptionsEnforcer which i got inspired by.
- Janrupf and HansWasser for creating ModDirector which inspired this mod too.
下载 MCInstance Loader
下载 MCInstance Loader
下载 MCInstance Loader
下载 MCInstance Loader
下载 MCInstance Loader
下载 MCInstance Loader
下载 MCInstance Loader
下载 MCInstance Loader
下载 MCInstance Loader
下载 MCInstance Loader
这是一次小更新,3.0 仍在计划中,应该很快会发布™。
Bug 修复
- 在 Web 请求中添加了
accept字段,使 GitHub 链接再次正常工作
技术变更
- 升级了构建脚本,使用 anatawa12 的 Forge Gradle 和 Gradle 7
- 版本号提升至 2.8
这是(希望是)3.0 版本前的最后一次更新。
新功能
- 增加了对 HTTP 代理的支持,这可能会修复被忽略的 VPN 问题(由 @GlodBlock 提供)
- 增加了忽略 HTTPS 证书检查的选项,以解决某些启动器可能以某种方式破坏证书列表的问题(由 @DrParadox7 提供)
功能变更与修复
- 重写了下载失败的重试系统,现在允许配置重试次数。
技术变更
- 对代码库进行了一些更改和清理
- 版本号提升至 2.7
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
查看物品与配方
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
添加区块认领和玩家组队功能,并与 Xaero's Minimap 和 World Map 集成
模组
添加全屏世界地图,显示你在世界中已探索的区域。与 Xaero's Minimap 搭配使用效果极佳。
评论 0
登录后参与评分
还没有评论,来抢沙发吧