配置预设切换

配置预设切换

按 F10 可在低 / 中 / 高之间切换整个渲染配置——或将当前设置保存为自己的预设。

杂项

配置预设切换

按 F10 在低 / 中 / 高之间切换你的整个渲染配置 —— 或者将你当前的设置保存为预设。

Minecraft 1.20.1 · Forge · 仅客户端


📖 为什么需要这个模组?

如果你玩整合包,渲染设置总是要妥协:

  • 大多数时候你想要好看的效果 —— 最大渲染距离、开启光影、使用 Voxy 渲染远处地形;
  • 但当你去打 Boss、录制视频,或者只是到处飞的时候,你不得不手动逐个关闭十几个设置:渲染距离、粒子、云、实体阴影、光影……
  • 而且当你换电脑或换存档时,又得重新设置一遍。

这个模组把这些设置打包成预设。按一次键就能切换整个渲染配置。


✨ 功能

功能 描述
一键切换 在面板中选择一个预设,点击应用 —— 整个渲染设置立即改变
3 个内置预设 低 / 中 / 高,开箱即用
保存当前设置 将你手动调整的设置保存为新预设,随时切换回来
双击重命名 随意命名你的预设
删除预设 删除不需要的预设(至少保留一个)
三种打开方式 标题画面按钮 / 快捷键 F10 / 用 F11 循环切换
光影集成 高预设可以启用 OptiFine 光影并指定光影包
Voxy 集成 高预设可以启用 Voxy 远处渲染

💡 面板采用先选择后应用的流程:点击预设只会高亮它,不会立即更改你的设置 —— 再也不用担心误点了。


🎮 使用方法

操作 描述
标题画面上的“Config Preset Switch”按钮 打开面板(作为独立按钮添加 —— 不会替换任何原版按钮)
F10 打开面板(在标题画面和游戏内均可使用)
F11 不打开面板,直接循环切换预设
单击预设 选中它(仅高亮)
双击预设 重命名它
应用 应用当前选中的预设
删除 删除当前选中的预设
保存当前预设 将你当前的设置保存为新预设

快捷键可在选项 → 控制 → 按键绑定 → Config Presets中更改。


📊 内置预设

设置 低 中 高
渲染距离 6 12 24
模拟距离 6 12 24
图像品质 FAST FANCY FABULOUS
云 OFF FANCY FANCY
粒子 MINIMAL DECREASED ALL
环境光遮蔽 关 开 开
实体阴影 关 开 开
生物群系过渡 3 4 5
多级纹理级别 2 3 4
FPS 限制 30 60 无限制
垂直同步 开 开 关
实体距离 50% 75% 100%
光影 关 关 开
Voxy 关 关 开

每个值都可以自定义(见下文)。


⚙️ 自定义预设

预设文件位于:

.minecraft/config/config-preset-switch/presets.json

该文件在首次启动时生成。每个字段都是可选的 —— 你省略的字段在应用预设时保持不变,因此你只需要列出你实际想要更改的设置。

{
  "version": 1,
  "currentPreset": "high",
  "presets": {
    "low": {
      "name": "Low",
      "renderDistance": 6,
      "simulationDistance": 6,
      "graphicsMode": "FAST",          // FAST / FANCY / FABULOUS
      "clouds": "OFF",                  // OFF / FAST / FANCY
      "particles": "MINIMAL",           // ALL / DECREASED / MINIMAL
      "ambientOcclusion": false,
      "entityShadows": false,
      "prioritizeChunkUpdates": "NONE", // NONE / PLAYER_AFFECTED / NEARBY
      "biomeBlendRadius": 3,
      "mipmapLevels": 2,
      "framerateLimit": 30,             // 0 = 无限制
      "enableVsync": true,
      "entityDistanceScaling": 0.5,
      "guiScale": 1,
      "bobView": false,
      "highContrast": false,
      "fov": 70,
      "gamma": 0.5,
      "shaders": { "enabled": false },
      "voxy": { "enabled": false }
    },
    "high": {
      "name": "High",
      "renderDistance": 24,
      "graphicsMode": "FABULOUS",
      "shaders": { "enabled": true, "pack": "ComplementaryShaders" },
      "voxy": { "enabled": true, "sectionRenderDistance": 32, "serviceThreads": 4, "subdivisionSize": 64 }
    }
  }
}
  • 想要更多预设?只需添加另一个键 —— 面板会自动列出它。
  • 编辑后,在面板中点击重新加载预设文件即可热重载(无需重启游戏)。
  • ⚠️ 文件必须是 UTF-8 编码,否则非 ASCII 名称会乱码(推荐使用 VS Code / Notepad++)。

🌅 光影

在 Forge 1.20.1 上,光影由 OptiFine + OptiFabric 处理。本模组通过写入 config/optifine/shaderscfg.properties 来切换光影:

Shaders=true
ShaderPack=ComplementaryShaders
  • Shaders=false → 关闭光影
  • Shaders=true + ShaderPack=<光影包名称> → 开启光影并使用指定的光影包
  • Shaders=true 但没有 pack → 仅开启光影,保留当前光影包

⚠️ OptiFine 在启动 / 加载世界时读取此文件,因此更改通常需要重新进入世界后才会生效(或在光影设置界面点击“完成”)。这是 OptiFine 的限制。


🌄 Voxy

Voxy 的 Forge 移植版(Dousha66/voxy-forge-1.20.1,modid voxy)在客户端启动时读取 config/voxy-config.json。

高预设会写入:

{
  "enabled": true,
  "enableRendering": true,
  "sectionRenderDistance": 32,
  "serviceThreads": 4,
  "subdivisionSize": 64
}

⚠️ Voxy 仅在启动时读取其配置,因此需要重启客户端。如果未安装 Voxy,写入该文件是无害的,模组不会报错。


⚡ 更改何时生效?

立即生效(无需重启) —— 渲染距离、模拟距离、图像品质、云、粒子、环境光遮蔽、实体阴影、区块更新优先级、生物群系过渡、多级纹理级别、FPS 限制、垂直同步、实体距离缩放、GUI 缩放、视角摇晃、高对比度、FOV、伽马值。

渲染距离还会在游戏内调用 ClientChunkCache.updateViewRadius(),因此当前世界的区块缓存会立即调整大小 —— 无需重新加入。

需要重启 / 重新进入世界 —— 光影(OptiFine)、Voxy。


📦 需求

项目 要求
Minecraft 1.20.1
模组加载器 Forge 47.x
环境 仅客户端(服务器不需要)
可选 OptiFine + OptiFabric(光影)、voxy-forge(远处渲染)

❓ 常见问题

问:按 F10 没有反应。 答:该按键可能被其他模组占用了。前往选项 → 控制 → 按键绑定,搜索“Config Presets”并绑定一个未使用的按键。

问:预设名称显示为乱码 / 问号。 答:presets.json 不是 UTF-8 编码。在编辑器中将其重新保存为 UTF-8,或者直接删除该文件让模组重新生成。

问:我应用了高预设,但光影没有开启。 答:你需要重新进入世界,让 OptiFine 重新加载光影。同时确保已安装 OptiFine + OptiFabric,且光影包位于 shaderpacks/ 中。

问:这会替换我的 Realms 按钮吗? 答:不会。 该按钮作为独立条目添加在原版菜单栏下方;不会隐藏或替换任何原版按钮。

问:我可以在服务器上使用吗? 答:可以。它仅客户端生效,服务器不需要安装。你只会看到常见的“客户端有服务器缺失的模组”提示,不影响游戏体验。