huanghongxun/HMCL-docs
1
0
Fork 0
mirror of https://gitee.com/huanghongxun/HMCL-docs.git synced 2026-03-19 10:35:26 +08:00
Code Issues Projects Releases Wiki Activity
pages
HMCL-docs/launcher/set-item-details.html
github-actions[bot] aab7c19a80 deploy: 2026-03-15 12:44:04 UTC
2026-03-15 12:44:04 +00:00

2 lines
19 KiB
HTML
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!doctype html><html lang="zh" class="no-js"><head><meta charset="utf-8"><title>设置项详解 - HMCL 文档</title><meta name="description" content="HMCL 各项设置的详细说明，包括全局游戏设置、外观、下载等"><meta property="og:type" content="article"><meta property="og:locale" content="zh"><meta property="og:site_name" content="HMCL 文档"><meta property="og:title" content="设置项详解"><meta property="og:url" content="https://docs.hmcl.net/launcher/set-item-details.html"><meta property="og:description" content="HMCL 各项设置的详细说明，包括全局游戏设置、外观、下载等"><meta property="article:published_time" content="2023-06-09T10:26:00+08:00"><link rel="canonical" href="https://docs.hmcl.net/launcher/set-item-details.html"><link href="/feed.xml" type="application/atom+xml" rel="alternate" title="HMCL 文档 Feed"><meta name="viewport" content="width=device-width, initial-scale=1.0"> <script> document.documentElement.className = document.documentElement.className.replace(/\bno-js\b/g, '') + ' js '; window.enable_copy_code_button = true; </script><link rel="stylesheet" href="/assets/css/main.css"><link rel="stylesheet" href="/assets/lib/fontawesome/css/all.min.css"> <noscript><link rel="stylesheet" href="/assets/lib/fontawesome/css/all.min.css"></noscript> <script src="/assets/js/settings.js"></script> <script src="/assets/js/theme.js"></script><link rel="shortcut icon" href="/favicon.ico"><link rel="stylesheet" id="skin"></head><body class="layout--document" dir="ltr"><nav class="skip-links"><ul><li><a href="#site-nav" class="screen-reader-shortcut">转到主导航栏</a></li><li><a href="#main" class="screen-reader-shortcut">转到内容</a></li><li><a href="#footer" class="screen-reader-shortcut">转到底部</a></li></ul></nav><div class="masthead"><div class="masthead__inner-wrap"><div class="masthead__menu"><nav id="site-nav" class="greedy-nav"> <a class="site-logo" href="/"><img src="/assets/img/hmcl.png" alt="HMCL 文档"></a> <a class="site-title" href="/"> HMCL 文档 </a><ul class="visible-links"><li class="masthead__menu-item"> <a href="/settings.html" >设置</a></li></ul><button class="greedy-nav__toggle hidden" type="button"> <span class="visually-hidden">切换菜单</span><div class="navicon"></div></button><ul class="hidden-links hidden"></ul></nav></div></div></div><div class="initial-content"><div id="main" role="main"><div class="sidebar sticky"><nav class="nav__list"> <input id="ac-toc" name="accordion-toc" type="checkbox" /> <label for="ac-toc">切换菜单</label><ul class="nav__items"><li> <span class="nav__sub-title">问题集合</span><ul><li><a href="/faq.html">常见问题</a></li><li><a href="/launcher/">启动器使用相关</a></li><li><a href="/modpack/">整合包帮助</a></li><li><a href="/multiplayer/">多人联机帮助</a></li></ul></li><li> <span class="nav__sub-title">使用者帮助</span><ul><li><a href="/launcher/isolation.html">版本隔离</a></li><li><a href="/launcher/offline-skin.html">设置离线皮肤</a></li><li><a href="/launcher/auto-installing.html">HMCL 的自动安装使用教程</a></li><li><a href="/launcher/shader.html">安装光影</a></li><li><a href="/launcher/set-item-details.html" class="active">设置项详解</a></li></ul></li><li> <span class="nav__sub-title">开发者帮助</span><ul><li><a href="/launcher/datapack.html">制作 HMCL 格式的数据包</a></li><li><a href="/modpack/serverpack.html">制作整合包</a></li><li><a href="/launcher/authlib-injector.html">添加默认 authlib-injector 验证服务器</a></li></ul></li><li> <span class="nav__sub-title">更新日志</span><ul><li><a href="/changelog/stable.html">稳定版</a></li><li><a href="/changelog/dev.html">开发版</a></li></ul></li><li> <span class="nav__sub-title">其他</span><ul><li><a href="/eula/hmcl.html">用户协议</a></li><li><a href="/contribution.html">贡献指南</a></li><li><a href="https://hmcl.huangyuhui.net">项目官网</a></li><li><a href="https://github.com/HMCL-dev/HMCL">项目仓库</a></li><li><a href="https://github.com/HMCL-dev/HMCL-docs">文档仓库</a></li></ul></li></ul></nav></div><article class="page" itemscope itemtype="https://schema.org/CreativeWork"><meta itemprop="headline" content="设置项详解"><meta itemprop="description" content="HMCL 各项设置的详细说明，包括全局游戏设置、外观、下载等"><meta itemprop="datePublished" content="2023-06-09T10:26:00+08:00"><div class="page__inner-wrap"><header><h1 id="page-title" class="page__title" itemprop="headline"> <a href="https://docs.hmcl.net/launcher/set-item-details.html" itemprop="url">设置项详解 </a></h1></header><section class="page__content" itemprop="text"><aside class="sidebar__right sticky"><nav class="toc"><header><h4 class="nav__title"><i class="fas fa-file-alt"></i> 目录</h4></header><ul class="toc__menu"><li><a href="#引言">引言</a><ul><li><a href="#约束与注意">约束与注意</a></li></ul></li><li><a href="#全局游戏设置">全局游戏设置</a><ul><li><a href="#java路径">Java路径</a><ul><li><a href="#自动选择合适的-java">自动选择合适的 Java</a></li></ul></li><li><a href="#版本隔离">版本隔离</a></li><li><a href="#游戏内存">游戏内存</a></li><li><a href="#启动器可见性">启动器可见性</a><ul><li><a href="#游戏启动后结束启动器">游戏启动后结束启动器</a></li><li><a href="#游戏启动后隐藏启动器">游戏启动后隐藏启动器</a></li><li><a href="#保持启动器可见">保持启动器可见</a></li><li><a href="#隐藏启动器并在游戏结束后重新打开">隐藏启动器并在游戏结束后重新打开</a></li></ul></li><li><a href="#游戏参数">游戏参数</a></li><li><a href="#jvm参数">JVM参数</a></li><li><a href="#本地库路径">本地库路径</a></li><li><a href="#glfw">GLFW</a></li><li><a href="#openal">OpenAL</a></li></ul></li><li><a href="#通用">通用</a></li><li><a href="#外观">外观</a></li><li><a href="#下载">下载</a><ul><li><a href="#下载源">下载源</a></li><li><a href="#下载并发数">下载并发数</a></li><li><a href="#代理设置">代理设置</a></li></ul></li><li><a href="#特别鸣谢">特别鸣谢</a></li><li><a href="#参考文章">参考文章</a></li></ul></nav></aside><img src="https://hits.zkitefly.eu.org/?tag=https%3A%2F%2Fdocs.hmcl.net%2Flauncher%2Fset-item-details.html" alt="Hits" decoding="async"><div class="notice--info"><p>本文由 MemoryShadow 创建。</p></div><h2 id="引言">引言</h2><p>本篇文章将从”全局游戏设置”, “通用”, “外观”与”下载”这几个维度, 详细的为您介绍HMCL设置中各个选项的作用, 对于一些能够”见名知意”的条目, 在本篇文章中不过多讨论.</p><h3 id="约束与注意">约束与注意</h3><p>本篇文章是在 <code class="language-plaintext highlighter-rouge">HMCL-3.5.3.230</code> 版本中编写的, 如果您使用的是旧版本, 请注意有些选项可能不存在.</p><h2 id="全局游戏设置">全局游戏设置</h2><p>这是 HMCL 中的第一个设置项, 也是最重要的设置项之一, 它决定了 HMCL 在启动游戏时的行为.</p><h3 id="java路径">Java路径</h3><p>众所周知, Minecraft 是由 Java 编写的, 因此在启动游戏时 HMCL 需要知道 Java(JRE<sup id="fnref:1"><a href="#fn:1" class="footnote" rel="footnote" role="doc-noteref">1</a></sup>) 的安装路径才能启动游戏.</p><p>由于 HMCL 本身就是一个 Java 程序, 一般能正常启动 HMCL 就能至少在计算机上找到一个 JRE. 但也会由于一些未知因素导致无法找到 JRE, 这时, 就需要手动指定 JRE 的安装路径.</p><p>我们先来讨论能够自动识别的情况:</p><p>在 HMCL 启动时, 会根据注册表项, 环境变量, 以及 HMCL 自身的启动路径<sup id="fnref:2"><a href="#fn:2" class="footnote" rel="footnote" role="doc-noteref">2</a></sup>来寻找 JRE. 如果找到了, 就会在 “Java路径” 这一栏显示出来, 并且在启动游戏时使用这个路径.</p><p>上述的情况几乎涵盖了所有, 如果你希望 HMCL 能够自动找到 Java, 就应该使用这些技巧配置好你的计算机环境.</p><p>接下来我们讨论不能自动识别的情况:</p><p>通常我们安装解压版本的 JRE 都不会被 HMCL 自动找到, 这时, 就需要手动指定 JRE 的安装路径. 你可以展开 “Java路径” 条目(通常是点击条目右侧的三角), 在展开的下拉列表中选中”自定义”条目后点击右侧的文件夹图标, 在弹出的对话框中选择你 Java 可执行文件的路径.</p><h4 id="自动选择合适的-java">自动选择合适的 Java</h4><p>在1.16.5版本后, Minecraft 的最低支持 Java 版本从 8 提升到了 16. HMCL 可以在已添加的版本中找到最合适的 Java 版本, 并在启动游戏时使用这个版本. 整个过程不需要人力介入.</p><h3 id="版本隔离">版本隔离</h3><p>这是当前主流启动器都支持的功能, 这个功能能够在尽可能共享依赖库的前提下, 将不同的游戏版本隔离开来, 避免你安装的模组加载器被应用在错误的版本上或是加载到不兼容的版本, 同时最大程度的减少磁盘占用.</p><p>此功能的底层原理不在此处过多赘述, 对于用户来说最大的区别就是游戏的实际目录发生了改变, 例如: 提取游戏日志的方式<sup id="fnref:3"><a href="#fn:3" class="footnote" rel="footnote" role="doc-noteref">3</a></sup>被改变了</p><p>原本游戏目录默认应该在 <code class="language-plaintext highlighter-rouge">.minecraft</code> 文件夹, 但在开启版本隔离后, 你实际的游戏目录被切换到了 <code class="language-plaintext highlighter-rouge">.minecraft/versions/游戏版本名称</code>, 这会给一些新手或是习惯于使用正版启动器的玩家带来额外的困惑.</p><p>通常来说, 只要你玩的不是未修改过的版本, 都应该打开版本隔离避免引发错误, 这也能在你删除某个游戏版本时将日志等数据一并清除.</p><h3 id="游戏内存">游戏内存</h3><p>这与你计算机上的 RAM 存储器容量有关, 一般来说选择 “自动分配内存” 选项会得到一个相对合适的值. 但也许会有一些 CPU 性能较差希望用内存来交换的玩家愿意分配更多的内存.</p><p>但我告诉您, 这里只是在调整 JVM<sup id="fnref:4"><a href="#fn:4" class="footnote" rel="footnote" role="doc-noteref">4</a></sup> 能够使用的最大内存容量, 只有在模组 / Minecraft 官方开发者没有手动控制 GC<sup id="fnref:5"><a href="#fn:5" class="footnote" rel="footnote" role="doc-noteref">5</a></sup> 行为的时候, 才能如你预期的通过内存交换 CPU 时间</p><h3 id="启动器可见性">启动器可见性</h3><p>这个条目有 4 个选项, 分别是:</p><ul><li>游戏启动后结束启动器</li><li>游戏启动后隐藏启动器</li><li>保持启动器可见</li><li>隐藏启动器并在游戏结束后重新打开</li></ul><h4 id="游戏启动后结束启动器">游戏启动后结束启动器</h4><p>这个选项特别推荐低性能机器使用, 这能节约一些计算机消耗. 代价是启动器无法很好的捕捉您的游戏崩溃信息与日志.</p><h4 id="游戏启动后隐藏启动器">游戏启动后隐藏启动器</h4><p>这个选项会在您游戏崩溃时收集您计算机上的相关崩溃信息以供向相关开发人员进行反馈. 代价是需要额外消耗一些计算机资源.</p><h4 id="保持启动器可见">保持启动器可见</h4><p>这个选项会在整个游戏过程中保持启动器可见, 这会在需要同时启动多个游戏的时候起到帮助. 代价是要消耗更多的计算机资源.</p><h4 id="隐藏启动器并在游戏结束后重新打开">隐藏启动器并在游戏结束后重新打开</h4><p>如果您需要频繁的在不同版本中切换游戏, 例如测试您的模组兼容性, 评估各版本之间的信息, 那么这个选项将会起到一定的帮助作用.</p><h3 id="游戏参数">游戏参数</h3><p>关于这点, 我没有找到更多的, 能与游戏同时使用的启动参数</p><h3 id="jvm参数">JVM参数</h3><p>调整JVM参数能够更细腻的控制 JVM 的行为, 例如是否压缩指针(用 CPU 换内存), 是否频繁 GC(还是用 CPU 换内存)等等, 这些一般都可以通过类似于这篇文章<sup id="fnref:6"><a href="#fn:6" class="footnote" rel="footnote" role="doc-noteref">6</a></sup>这样进行调整. 不过要注意的一点是, JVM 参数是由实际实现决定的, 是否使用以及是否支持还要看具体的 JVM 实现.</p><h3 id="本地库路径">本地库路径</h3><p>在一些例如M1芯片之类的设备上, 通用库类可能都不能正常的工作, 要使用版本特殊提供的库类才能令其正常的工作, 你可以使用这个选项对其进行替换</p><h3 id="glfw">GLFW</h3><p>GLFW是一个轻量级的C语言库，用于创建和管理 OpenGL 在多个操作系统中的上下文，处理用户输入，以及获取时间和帧缓冲。它支持多个窗口、全屏模式、窗口模式、多个输入设备和剪贴板。GLFW是一个独立于操作系统的库，可以在 Windows, MacOS, Linux 等多个平台上使用。</p><p>在Linux下，系统自带的窗口管理器（例如 xorg）通常已经包含了可以与 OpenGL 集成的窗口管理器。因此，使用系统自带的窗口管理器可以避免与其他项目的库冲突，并确保对于系统提供的功能和特性有最好的支持。此外，使用系统自带的窗口管理器也能够最大限度地减少安装和配置上的复杂性。</p><p>故此, Linux 玩家推荐使用系统自带的</p><h3 id="openal">OpenAL</h3><p>OpenAL 是一个跨平台的 3D 音频 API，可以用于在多个操作系统上播放音效和音乐。它支持的特性包括定位、重放、3D 效果、回声、滤波等。可以使用 OpenAL 提供的函数对声源和听者的位置、方向、速度等进行控制，以实现 3D 音频效果。</p><p>在 Linux 下 OpenAL 通常可以与 ALSA（高级 Linux 音频体系结构）或 PulseAudio（一种现代的音频子系统）进行集成。使用系统自带的音频支持库，可以确保应用程序与底层音频硬件和设备之间的兼容性，并提供最佳的音频性能和功能。此外使用 OpenAL 也可以让应用程序具有跨平台的特性，可以在多个操作系统上使用相同的代码和资源来实现音频效果。</p><p>故此 Linux 用户推荐使用系统自带的</p><h2 id="通用">通用</h2><p>这里提供了一些 HMCL 的通用参数, 例如启动器是否自动检查更新, 文件下载的缓存目录存放位置, 程序界面的显示语言等. 这些基本都属于 “见名知意” 的范畴, 不需要过多讨论.</p><h2 id="外观">外观</h2><p>这里提供了一些 HMCL 的外观参数, 例如启动器的主题颜色, 动画显示, 背景图片, 字体等. 这些基本都属于 “见名知意” 的范畴, 不需要过多讨论.</p><h2 id="下载">下载</h2><h3 id="下载源">下载源</h3><p>由于网络环境问题, 在之前下载 Minecraft 可能是一件麻烦事, 但在现在, 我们有了 BMCLAPI<sup id="fnref:7"><a href="#fn:7" class="footnote" rel="footnote" role="doc-noteref">7</a></sup> 项目, 该项目无偿为大陆地区用户提供 Minecraft 相关文件的镜像. 但有可能存在延迟, 可以按照自己的需求进行选择.</p><h3 id="下载并发数">下载并发数</h3><p>提高下载并发数能够最大限度的利用您的网络, 但这不是越高越好的. 提高并发数量会对您的计算机和下载源都带来更高的负载, 由于木桶效应的存在, 本地下行带宽, 下载源上行带宽, 您的磁盘读写速度等这过程中的任何一环都会成为下载途中的瓶颈, 所以不要盲目提高并发数, 推荐的家庭带宽并发数在 8~16 之间.</p><h3 id="代理设置">代理设置</h3><p>用于解决部分网络不佳或需要连接特殊网段的工具, 能够连接到内网服务器之类的.</p><h2 id="特别鸣谢">特别鸣谢</h2><ul><li>huangyuhui</li><li>GitHub Copilot</li></ul><h2 id="参考文章">参考文章</h2><div class="footnotes" role="doc-endnotes"><ol><li id="fn:1"><p><a href="https://www.ibm.com/cn-zh/topics/jre" title="点击查看">什么是JRE?</a> <a href="#fnref:1" class="reversefootnote" role="doc-backlink">↩</a></p></li><li id="fn:2"><p><a href="/modpack/bundled-java.html" title="点击查看">整合包自带 Java</a> <a href="#fnref:2" class="reversefootnote" role="doc-backlink">↩</a></p></li><li id="fn:3"><p><a href="https://memoryshadow.cn/index.php/2023/06/03/how-do-i-get-minecraft-game-logs/" title="点击查看">如何获取Minecraft的游戏日志?</a> <a href="#fnref:3" class="reversefootnote" role="doc-backlink">↩</a></p></li><li id="fn:4"><p><a href="https://www.ibm.com/support/pages/ibm-i-%E4%B8%8Ajava-%E8%99%9A%E6%8B%9F%E6%9C%BA%E7%AE%80%E4%BB%8B" title="点击查看">什么是JVM?</a> <a href="#fnref:4" class="reversefootnote" role="doc-backlink">↩</a></p></li><li id="fn:5"><p><a href="https://blog.csdn.net/weixin_44908159/article/details/123626886" title="点击查看">什么是GC?</a> <a href="#fnref:5" class="reversefootnote" role="doc-backlink">↩</a></p></li><li id="fn:6"><p><a href="https://www.ibm.com/docs/zh/integration-bus/10.0?topic=command-jvm-parameter-values" title="点击查看">JVM 参数值</a> <a href="#fnref:6" class="reversefootnote" role="doc-backlink">↩</a></p></li><li id="fn:7"><p><a href="https://bmclapidoc.bangbang93.com/" title="点击查看">BMCLAPI</a> <a href="#fnref:7" class="reversefootnote" role="doc-backlink">↩</a></p></li></ol></div></section><footer class="page__meta"><p class="page__date"><strong><i class="fas fa-fw fa-calendar-alt" aria-hidden="true"></i> 更新时间:</strong> <time class="dt-published" datetime="2023-06-09T10:26:00+08:00">2023-06-09</time></p></footer><nav class="pagination"> <a href="/launcher/fabric_and_optifine_install.html" class="pagination--pager" title="同时安装 Fabric &amp; OptiFine">上一页</a> <a href="/launcher/use-password-login-microsoft-account.html" class="pagination--pager" title="使用密码登录微软账户">下一页</a></nav></div></article></div></div><div id="footer" class="page__footer"><footer><div class="page__footer-follow"><ul class="social-icons"><li><strong>关注:</strong></li><li><a href="https://github.com/HMCL-dev/HMCL" rel="nofollow noopener noreferrer"><i class="fab fa-fw fa-github" aria-hidden="true"></i> Github</a></li><li><a href="https://beian.miit.gov.cn" rel="nofollow noopener noreferrer"><i class="fas fa-link" aria-hidden="true"></i> 粤ICP备18071565号</a></li><li><a href="/feed.xml"><i class="fas fa-fw fa-rss-square" aria-hidden="true"></i> Feed</a></li></ul></div><div class="page__footer-copyright">&copy; 2026 <a href="mailto:hmcl@huangyuhui.net">huanghongxun</a>. 技术来自于 <a href="https://jekyllrb.com" rel="nofollow">Jekyll</a> &amp; <a href="https://mademistakes.com/work/jekyll-themes/minimal-mistakes/" rel="nofollow">Minimal Mistakes</a>.</div></footer></div><script src="/assets/js/main.min.js"></script> <script src="/assets/js/plugins/jquery.auto-redirect.js"></script></body></html>
Reference in New Issue View Git Blame Copy Permalink