VulkanMod Extra

VulkanMod Extra

VulkanMod 的终极性能控制套件。 关闭你不需要的功能，保留你喜爱的功能，为你的 Minecraft 体验榨干每一帧性能。

---

什么是 VulkanMod Extra？

VulkanMod Extra 扩展了 VulkanMod，为 Minecraft 中的每一个视觉效果提供精细控制。它基于现代模块化架构构建，无缝集成到 VulkanMod 的设置界面中，同时提供前所未有的优化能力。

可以把它想象成拥有一个专业的音频调音台，只不过是为 Minecraft 的图形而设。每一个滑块、每一个开关、每一个选项都是为了帮助你在画质和原始性能之间找到完美的平衡。

主要功能

动画控制

精细调整哪些纹理运行动画，哪些保持静态。每种动画类型都可以独立开关：

• 主开关 - 一键禁用所有动画
• 流体 - 水（静态/流动）、熔岩（静态/流动）动画
• 环境 - 火焰、传送门漩涡、潜声传感器脉冲
• 方块 - 所有其他动画方块纹理

粒子管理

控制超过 80 种单独的粒子类型。从雨滴飞溅到附魔闪光，由你决定渲染什么：

• 主开关 - 一键控制所有粒子
• 天气效果 - 雨滴飞溅、雪花粒子、云层形成
• 方块交互 - 破坏粒子、灰尘、碎片
• 实体效果 - 村民情绪、生物粒子、玩家效果
• 环境 - 气泡、烟雾、灰烬、樱花花瓣
• 特殊效果 - 传送门粒子、附魔、爆炸

渲染优化

深度控制 Minecraft 的渲染管线：

• 实体渲染 - 物品展示框、盔甲架、画
• 光照系统 - 动态光照更新优化
• 信标光束 - 高度限制以提升性能
• 雾效果 - 按环境单独控制雾效，带详细倍率调节
• 名称标签 - 为玩家和实体单独开关

世界细节

自定义你的世界氛围：

• 天空元素 - 太阳、月亮、星星、天空颜色
• 天气视觉效果 - 雨/雪的渲染与游戏机制分离
• 生物群系颜色 - 开关生物群系专属着色
• 云设置 - 高度和渲染距离控制

HUD 与界面

增强的显示功能：

• FPS 计数器 - 基础或扩展指标显示
• 坐标 - 实时位置追踪
• Toast 通知 - 控制成就/配方弹窗
• 调试信息 - F3 屏幕稳定刷新率

性能影响

基于社区测试和反馈：

禁用功能	平均 FPS 提升	备注
所有动画	+15-25 FPS	对低端显卡影响最大
所有粒子	+10-20 FPS	随粒子密度变化
天气效果	+5-10 FPS	雨/雪天气时
雾渲染	尚未测试	可能对水中/熔岩中有帮助
实体附加	+2-5 FPS	物品展示框、盔甲架

结果因硬件、世界复杂度和已安装的其他模组而异。以上数据来自用户报告的估算值——你的实际结果可能有所不同。

安装

前置要求

• Minecraft: 1.21.1 - 1.21.5
• 模组加载器: Fabric Loader 0.17.2+
• 依赖:
  • Fabric API（与你 MC 版本对应的最新版）
  • VulkanMod 0.5.3+

快速安装

1. 为你的 Minecraft 版本安装 Fabric Loader
2. 下载 VulkanMod 并放入 mods 文件夹
3. 下载 VulkanMod Extra 并放入 mods 文件夹
4. 启动 Minecraft
5. 打开视频设置 → VulkanMod 标签页以使用所有功能

多版本支持

VulkanMod Extra 通过智能覆盖系统支持多个 Minecraft 版本：

• 1.21.1（稳定版）
• 1.21.2（稳定版）
• 1.21.3（稳定版）
• 1.21.4（稳定版）
• 1.21.5（测试版）

从我们的发布页面下载与你 Minecraft 版本匹配的版本。

配置

设置存储在 .minecraft/config/vulkanmod-extra-options.json 中，可以手动编辑或通过游戏内界面修改。

配置结构

{
  "coreSettings": {
    "enableMod": true,
    "enableGuiIntegration": true,
    "enableDebugLogging": false
  },
  "animationSettings": {
    // 各自的动画开关
  },
  "particleSettings": {
    // 80+ 种粒子类型开关
  },
  "renderSettings": {
    // 渲染优化
  },
  "detailSettings": {
    // 世界细节控制
  },
  "extraSettings": {
    // HUD 和界面选项
  }
}

性能预设（即将推出）

我们正在开发一键式优化配置：

• 土豆模式 - 最大 FPS，最低画质
• 均衡模式 - 适合大多数系统的智能折中方案
• 画质模式 - 轻微优化，保留美观
• 极致模式 - 启用所有功能

技术细节

架构

VulkanMod Extra 采用现代模块化架构：

• 功能注册系统 - 动态功能生命周期管理
• 配置管理器 - 自动备份和迁移支持
• Mixin 集成 - 精准的修改能力
• 内存优化 - 设置内存使用量减少 85%
• 线程安全 - 所有操作均正确同步

构建系统

通过 Gradle 实现多版本支持：

# 为特定版本构建
./gradlew build -Pminecraft_version=1.21.4

# 或构建分支的默认版本
./gradlew build

性能特性

• 启动影响：极小——模组加载迅速
• 内存使用：轻量级配置系统
• 运行时开销：功能禁用时可忽略不计
• 配置系统：基于 JSON 的快速配置

兼容性

已知兼容模组

• Fabric API（必需）
• VulkanMod（必需）
• ModMenu（推荐）
• 大多数优化模组

潜在冲突

• Sodium/Iris（请改用 VulkanMod）
• OptiFine（与 VulkanMod 不兼容）
• Canvas Renderer（渲染管线不同）

故障排除

常见问题

VulkanMod Extra 选项不显示

• 确保 VulkanMod 已安装并正常工作
• 检查配置中的界面集成是否已启用
• 验证你使用的版本是否兼容

设置无法保存

• 手动编辑时确保 JSON 语法有效
• 尝试删除配置文件以重新生成
• 检查配置文件夹的写入权限

性能下降

• 某些功能启用时可能影响 FPS
• 从全部禁用开始，逐步启用
• 检查是否与其他模组冲突

启动时崩溃

• 验证 VulkanMod 是否正常运行
• 检查 .minecraft/logs 中的日志文件
• 确保已安装 Vulkan 驱动

贡献

我们欢迎各种形式的贡献！无论是：

• Bug 报告和修复
• 功能建议和实现
• 其他语言的翻译
• 文档改进
• 测试和基准测试

查看我们的贡献指南开始吧。

开发路线图

当前重点 (v0.2.x)

• ✅ 主开关控制
• ✅ 增强的界面集成
• ✅ 多版本支持
• 🔄 性能预设系统

即将推出的功能 (v0.3.x)

• 区块渲染优化
• 高级剔除算法
• 内存使用分析器
• 自定义着色器支持钩子

未来计划 (v1.0)

• 完整的界面重新设计
• 高级 LOD 系统
• 动态性能缩放
• 基于云的预设分享

支持与社区

需要帮助或想分享你的经验？

• 问题反馈：GitHub Issues
• 讨论区：GitHub Discussions
• Discord：加入 VulkanMod 社区
• Wiki：文档

致谢

• xCollateral - VulkanMod 的创建者
• FlashyReese - 灵感来自 Sodium Extra
• Fabric 团队 - 出色的模组平台
• 贡献者们 - 所有帮助改进此模组的人
• 社区 - 感谢测试、反馈和支持

许可证

VulkanMod Extra 采用 MIT 许可证。

你可以自由地：

• 在任何整合包中使用此模组
• 修改和重新分发
• 商业使用
• 只需保留署名即可！

---