BluDecorations

为 Minecraft 带来高度自定义的装饰！

模组 Forge 其他外观

介绍

介绍由机器翻译自 CurseForge 原页面，仅供参考。

BluDecorations 是我初次尝试使用 Blender 进行 3D 建模，并将模型用于 Minecraft 后制作的一款模组。
这款模组的核心是添加一个方块，并提供三种工具供你自定义。你可以自由配置方块显示的模型及其纹理，还能调整颜色、透明度、位置、旋转和粒子效果。

普通玩家会发现，模组附带了多种由我制作的预设配置，你可以按自己的喜好进行调整。对于熟悉 Minecraft 资源系统，或有 Forge 模组开发经验的进阶玩家，这款模组则提供了一个空白画布，供你添加自定义模型和纹理。

这只是这款模组众多功能中的一小部分。

更新日志

版本 1.2.3/1.3.1
– 修复：附近有物品展示框时，渲染不再出现问题
– 修复：方块被破坏后，TileEntity 不再残留（此前会导致碰撞箱和模型配置持续存在）
– 新增功能：可以将预设添加到当前配置中，而不是替换当前配置。按住 CTRL 即可。模型和粒子都适用。
– 新增功能：可以在本地保存配置。这些配置会写入两个单独的 .cfg 文件。之后，你可以在任意单人世界中访问这些配置；多人服务器上可能也能使用（尚未测试，但理论上应该可行）。
– 新增功能：无限望远镜。用它点击方块即可切换无限渲染范围。也就是说，即使方块的碰撞箱不在视野内，它也始终会被渲染。注意，这显然会增加系统负载。

展示视频
想通过视频了解更多细节？来看看 CaptainSparklez 制作的精彩展示视频吧！

使用指南
可配置方块的合成方式如下：

染料可以是任意颜色。

本模组的第一件物品是模型扳手。

它可以打开模型配置界面：
1.6.4 版模型自定义界面：

打开后会显示如下界面：

现在，你可以从左侧列表中选择预设模型，调整旋转、缩放、光照和碰撞箱，或向当前配置添加新的渲染元素。
“Next Page”（下一页）按钮处于停用状态，因为后续页面都是渲染元素。刚放置的方块还没有渲染元素。
不过，选择一个预设模型后，它就会显示出来。

更新：
从 1.3.1 版（MC 1.7.2）或 1.2.3 版（MC 1.6.4）开始，按住 CTRL 并点击会将选中的预设添加到当前配置，而不是替换它。
此外，屏幕中央还会出现一个文本框，以及一个“Save”（保存）按钮。你可以用它们为当前配置命名并保存。
这些配置会保存在本地的 config 文件夹中。因此，你可以在所有单人世界中使用，也可能可以在加入的多人服务器上使用。

选择“石制火把”并点击“下一页”后，你会看到这个界面：

现在你处于某个特定 RenderElement 的配置界面。它一开始看起来可能有些复杂，但熟悉之后就会发现用起来很简单。
这三个文本框用于设置此元素的模型和纹理。模型路径应指向一个 OBJ 模型（稍后会详细介绍）。纹理路径需要使用所谓的“ResourceLocation”格式。懂模组开发的朋友应该知道它是什么。不了解的朋友可以这样理解：它指的是 Minecraft 使用的一种资源，由域名和文件路径组成，两者以“:”连接。可以查看预设模型作为示例。
最后，Model Part Name 指的是要渲染的模型部件。
“Pos Y”滑块用于控制部件的高度偏移。
旁边的文本框用于设置 X 和 Z 轴偏移。
三个“Rot.”滑块分别控制绕三个轴的旋转。
颜色滑块的作用很直观：使用 RGB 值为模型着色，数值范围为 0（黑色）到 255（白色）。
最后，Alpha 滑块用于控制不透明度。

1.7.2 版本的模型自定义

界面会变成这样：

现在你可以从左侧列表中选择预设模型，调整旋转、缩放、光照和包围盒，或向当前配置添加新的 RenderElement。
“下一页”按钮处于禁用状态，因为后续页面都属于渲染元素。对于刚放置的方块来说，它还没有任何渲染元素。
不过，如果现在选择一个预设模型，它就会变为可用。

更新：
从 1.3.1 版本（MC 1.7.2）或 1.2.3 版本（MC 1.6.4）开始，按住 CTRL 并点击会将所选预设添加到当前配置中，而不是替换当前配置。
此外，你会在屏幕中间看到另一个文本框，以及一个“保存”按钮。你可以用它们将当前配置以自选名称保存下来。
这些配置会保存在本地的 config 文件夹中。因此，它们可用于所有单人游戏世界，也可能适用于你加入的多人游戏服务器。

选择“石制火把”并点击“下一页”后，你会看到这个界面：

现在你处于某个特定 RenderElement 的配置界面。它一开始看起来可能有些复杂，但熟悉之后就会发现用起来很简单。
这些文本框用于设置此元素的模型和纹理。
模型路径和纹理路径都采用 ResourceLocation 系统的格式，该系统在 1.7 版本中经过了修改。与这个模组的 1.6.4 版本不同，现在模型路径也必须填写域名；为方便管理，域名字段已单独列出。
模型路径应指向一个 OBJ 模型（稍后会详细介绍）。
纹理路径应指向一个 .png 文件。
可以查看预设模型作为示例。
最后，Model Part Name 指的是要渲染的模型部件。
“Pos Y”滑块用于控制部件的高度偏移。
旁边的文本框用于设置 X 和 Z 轴偏移。
三个“Rot.”滑块分别控制绕三个轴的旋转。
颜色滑块的作用很直观：使用 RGB 值为模型着色，数值范围为 0（黑色）到 255（白色）。
最后，Alpha 滑块用于控制不透明度。

下一个项目是粒子喷雾罐。

它用于配置方块发出的粒子：
粒子自定义：

打开的 GUI 如下所示：

这个 GUI 的工作方式与模型自定义界面基本相同。不同之处在于，它使用的是 ParticleElements，而不是 RenderElements。

更新：
从 1.3.1 版本（MC1.7.2）或 1.2.3 版本（MC1.6.4）开始，按住 CTRL 并点击会将选中的预设添加到当前配置中，而不是替换当前配置。
此外，屏幕中间还会多出一个文本框，以及一个“保存”按钮。你可以用它们将当前配置保存为自选名称。
这些配置保存在本地的 config 文件夹中。因此，它们可用于所有单人世界，也可能适用于你加入的多人服务器。

你会看到一个预设配置列表，

而这里显示的是某个特定 ParticleElement 的配置。设置起来稍微复杂一些，因为需要填写 Minecraft 中粒子实体的实际类路径。因此，自己制作过模组或看过 Minecraft 源码的玩家可能会更有优势。
对于大多数普通玩家，我整理了一份最常用的原版粒子列表：

火焰：net.minecraft.client.particle.EntityFlameFX
烟雾：net.minecraft.client.particle.EntitySmokeFX
气泡：net.minecraft.client.particle.EntityBubbleFX
烟花火星：net.minecraft.client.particle.EntityFireworkSparkFX
爱心（驯服/繁殖时出现）：net.minecraft.client.particle.EntityHeartFX
音符：net.minecraft.client.particle.EntityNoteFX
红石：net.minecraft.client.particle.EntityReddustFX

其他选项与 RenderElements 中的相同：
“Pos Y”滑块控制部件的高度偏移。
旁边的文本框用于设置 X 和 Z 轴偏移。
三个“Scale”滑块控制粒子的大小（这个功能有点古怪，不过这要怪 Minecraft）。
颜色滑块的作用不言自明：通过 RGB 值为粒子着色，取值范围为 0（黑色）到 255（白色）。
最后，Alpha 滑块用于控制不透明度。

接下来是可调指令：

在可配置方块上右键使用，即可将模型和粒子配置保存到物品中。在另一个方块上点击，即可应用该配置。要清除指令，按住 Shift 并右键。

本模组的最后一件物品是无限望远镜：

用它点击方块，即可切换无限渲染范围。这意味着即使方块的包围盒不在视野内，它也会始终渲染。请注意，这显然会增加系统负载。

最后，如果手持箱子点击方块，箱子就会与方块整合，使其能够作为物品栏使用。这样这些方块不光好看，还有一点实用功能 😛

自定义模型
这是本模组的特别之处：
用户可以通过多种方式添加自定义模型。
如果你是开发者，可以直接为本模组制作附属模组。这样一来，你甚至可以使用 API 将模型保存为预设列表中的自定义配置。
不过，使用自定义资源包也能让你将自己的（或他人的）.obj 文件加入 Minecraft。最好将这些模型和自定义纹理（没错，也可以添加纹理）放在“assets”的子文件夹中。最好别放在“assets/minecraft”里面 😛

使用自定义 obj 文件时，请注意以下几点：
Forge 的高级模型加载器对要解析的模型有点挑剔。
自定义模型的面只能是三角形或矩形，不能超过 4 条边，也不能混用。要获得最佳效果，请在 Blender 导出时设置为三角化面。这样就万无一失了（别拿这句话来反驳我 xD ）
其次，obj 模型的部件名称中不能包含“.”。不过 Blender 会自动这样命名：只要再添加一个立方体网格，就会得到 Cube.001 这样的名称。记得重命名，否则模型加载器将无法解析它们。建议使用下划线。
最后，Blender 有点不太靠谱，会把两个相连的顶点（一条线）也当成一个面。这意味着你的 obj 文件可能包含仅由 2 个顶点构成的面。它们其实并不是真正的面，因此模型加载器无法处理。虽然打开 .obj 文件并在文本编辑器中查找这些“假面”看起来很费事，但它们总会出现在每个物体的面列表底部，因为 Blender 会按顶点数量对面排序。幸好，只要你知道如何建模并且不留下“残留”顶点，这种情况就不太常见，理想情况下甚至不会出现

漏洞

这样就万无一失了

不过，如果真的出现问题，请提交漏洞报告。
最理想的方式是在我的 GitHub 上提交：
适用于 1.6.4
适用于 1.7.2
如果你不想在那里提交，也可以发在这个帖子里，不过我查看这里的频率比 GitHub 低。
无论采用哪种方式，请确保报告中包含：
Minecraft 版本、Forge 版本、崩溃报告（如果有），以及你安装的其他模组。

法律声明
本模组采用以下许可协议：知识共享 3。
简而言之：你可以自由使用本模组及其代码，不过请注明来源 ;D
此外，你可以在任何整合包中使用本模组。祝你玩得开心！