MaterialMaps

模组

· 作者 RXokas

资源包中的方块和物品支持法线贴图与高度贴图,无需依赖光影

0 本站下载 0 关注 更新于 1 个月前

需要前置:Fabric API、Sodium

最新 0.4.1 · 26.2 · Fabric

一键开服(送7天)

MaterialMaps

让纹理看起来凹凸有致,而非平坦。无需光影包。

仅客户端 · 依赖 Sodium


在 Minecraft 中,每个方块面都是一个完美的平面正方形。 石头、砖块、砾石,纹理看起来粗糙,但表面本身是平滑的,因此光线以完全相同的方式照射到它们上面。这就是为什么方块看起来像贴纸的原因。

MaterialMaps 解决了这个问题。
许多高清资源包已经为每种纹理包含了一张额外的隐藏图像,指示“这个像素凸起,那个像素凹陷”。
通常情况下,只有光影包才能读取这些数据。
MaterialMaps 自行读取这些数据,因此每个凸起都能从正确的方向捕捉光线并投射出属于自己的微小阴影。石头看起来像是雕刻出来的。砖块看起来是堆叠的。砾石看起来就是真正的砾石。

  • 无需光影包,不需要 Iris,不需要 OptiFine,也不会造成巨大的帧率损失
  • 保持原版风格,没有泛光,没有颜色变化,没有花哨的天空。只有立体感
  • 与你已有的资源包配合使用,如果你的资源包支持它,开启模组即可

我需要特殊的资源包吗?

是的,MaterialMaps 仅在资源包提供细节的地方添加细节。 像 Prime's HD Textures 这样的高清资源包就支持。
使用原版纯文本资源包时,不会有任何变化。

仍在积极开发中!

MaterialMaps 可以工作,但它还很年轻。尚未保证与大型渲染模组的兼容性。
非常欢迎提交 Bug 报告。

对比

截图使用了 Prime's HD Textures 带有和不带该模组的同一世界图片

功能

  • 方块法线贴图:通过专用的渲染路径直接应用于地形,因此原版区块几何体保持不变。
  • 物品法线贴图:手持、掉落和物品栏中的物品也享受同样的处理。
  • 高度图:当纹理具有 _h.png 但没有 _n.png 时,MaterialMaps 会在内存中于资源重载期间派生切线空间法线贴图。
  • LabPBR 1.3 支持:识别配对的 _n.png 和 _s.png 贴图;法线 X/Y 和环境光遮蔽从 LabPBR 法线贴图中读取,其 Alpha 通道保留为嵌入的高度数据。
  • 维度感知光照:太阳和月亮方向跟随你所在的维度。
  • 实验性视差效果:对附近实体和镂空方块面进行有限的高度采样,可选凹边着色和类体素像素浮雕。
  • 原版回退:MaterialMaps 无法安全渲染的任何内容都会直接交还给原版,并记录原因。

兼容性

模组 状态
Sodium 必需
Iris 可选。当启用 Iris 光影包时,MaterialMaps 会禁用自身以避免冲突。
Fabric API 必需

MaterialMaps 是仅客户端模组,你可以带着它加入任何服务器。

配置

从 ModMenu 打开设置,或在安装 Sodium 时从 视频设置 -> MaterialMaps 打开。

渲染:切换方块和物品法线贴图、高度图派生以及原版回退。

光照:Normal Strength(法线强度)控制法线贴图对表面的扰动程度,Ambient Strength(环境强度)设置最小细节光照,Directional Strength(方向强度)设置方向对比度。

实验性功能:视差效果、视差深度缩放、凹边和类体素像素浮雕。

调试:方块和物品的法线贴图、世界法线和光照调试视图,以及渲染统计信息。

命令

用于在游戏中诊断资源包:

/materialmaps summary [blocks|items]   概述检测到的内容
/materialmaps inspect <material>       显示一种纹理、方块或物品找到的贴图
/materialmaps validate                 列出资源包警告和错误
/materialmaps renderstats              渲染诊断
/materialmaps dump                     将完整材质索引写入文件
/materialmaps reload                   重建索引和法线图集

给资源包制作者

命名约定

将贴图放在基础纹理旁边,使用 _n 和 _h 后缀:

assets/minecraft/textures/block/stone.png
assets/minecraft/textures/block/stone_n.png
assets/minecraft/textures/block/stone_h.png

assets/minecraft/textures/item/iron_pickaxe.png
assets/minecraft/textures/item/iron_pickaxe_n.png

值得了解的规则:

  • 显式法线贴图始终优先于高度图。
  • 仅当启用 Height Maps(高度图)且不存在 _n.png 时,才使用高度图来派生法线。
  • 贴图必须与其基础纹理的尺寸匹配,否则将被跳过。
  • LabPBR 资源包可以提供 _n.png + _s.png 配对。
  • 仅扫描 textures/block 和 textures/item。

运行 /materialmaps validate 可以在工作时捕获孤立贴图和维度不匹配问题,并在设置中启用 Strict Validation(严格验证)以将更多问题视为硬错误。

视差效果说明

实验性视差选项对附近实体和镂空方块面应用有限的高度采样。它在 24 到 32 个方块之间淡出,并为半透明层保持禁用。镂空方块保持其原始的 alpha 测试轮廓。这是一个轻量级原型——没有真正的几何体或轮廓置换。

测试资源包

仓库中包含一个小型开发用资源包 materialmaps-test-pack。启动客户端,在资源包界面启用它,然后检查钻石、铁锭或木棍,即可看到物品路径生效的效果。

要求

  • Minecraft 26.2
  • Fabric Loader 0.19.3+
  • Fabric API

AI 使用

本项目中的每一行代码并非 100% 由人类编写
AI 被用作研究工具和编程辅助

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源