VulkanMod Extra

VulkanMod Extra

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

什么是 VulkanMod Extra？

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

可以把它想象成一个专业的音频调音台，但针对的是 Minecraft 的图形。每个滑块、每个开关、每个选项都是为了帮助你，在视觉质量和原始性能之间创造完美的平衡。

主要特性

动画控制

微调哪些纹理动画化，哪些保持静态。每种动画类型都可以独立切换：

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

粒子管理

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

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

渲染优化

对 Minecraft 渲染管线的深度控制：

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

世界细节

自定义你的世界氛围：

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

HUD 与界面

增强的显示功能：

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

性能影响

基于社区测试和反馈：

结果因硬件、世界复杂度和安装的其他模组而异。这些是用户报告的估计值 - 你的结果可能不同。

安装

要求

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

快速安装

• 为你的 Minecraft 版本安装 Fabric Loader
• 下载 VulkanMod 并放入 mods 文件夹
• 下载 VulkanMod Extra 并放入 mods 文件夹
• 启动 Minecraft
• 打开视频设置 → 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 中，可以通过游戏内 GUI 或手动编辑。

配置结构

{
  "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 已安装且正常工作
• 检查配置中 GUI 集成是否已启用
• 验证你使用的是兼容版本

设置未保存

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

性能下降

• 某些功能启用时可能会影响 FPS
• 从禁用所有功能开始，逐步启用
• 检查模组冲突

启动时崩溃

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

贡献

我们欢迎贡献！无论是：

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

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

开发路线图

当前重点 (v0.2.x)

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

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

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

未来计划 (v1.0)

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

支持与社区

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

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

致谢与感谢

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

许可证

VulkanMod Extra 根据 MIT 许可证 授权。

你可以自由地：

• 在任何整合包中使用此模组
• 修改和重新分发
• 商业使用
• 只需注明出处！

为 Minecraft 社区精心打造

让 Minecraft 运行得更好，一帧一帧地

下载 • 报告错误 • 请求功能