Blopedit

Blopedit

一个Minecraft Fabric客户端模组,用于快速轻松地编辑着色器中的block.properties文件。

游戏机制

Blopedit

在使用 Blopedit 之前,强烈建议备份着色器的 block.properties 文件。尽管 Blopedit 旨在简化将模组方块与着色器集成的流程,但编辑过程中仍可能发生意外问题或用户失误。

Blopedit 是一个小型 Fabric 客户端模组,用于简化着色器中 block.properties 文件的编辑,提供命令并利用你自己的摄像机视角。 该模组对于高效地将模组方块与使用基于物理的渲染(PBR)以实现独特视觉属性(如动态树叶或发光矿石)的着色器集成特别有用。

block.properties 文件

block.properties 文件被着色器用来为不同方块分配各种视觉属性。它位于 /.minecraft/shaderpacks/myShader.zip/shaders/block.properties。文件中的每个方块被称为一个“属性条目”,出现在定义方块类型的方块 ID 键旁边。 属性条目是唯一的,除非它对应不同的 Minecraft 版本,否则在文件中只能出现一次。

属性条目由方块标识符组成,包括:

  • 标识符命名空间,表示方块的来源(例如,原版方块为 minecraft,模组方块为模组的 modID,如 farmersdelight)。
  • 标识符路径,指示实际的方块名称(例如 farmland)。
  • 可选的方块状态属性列表,其中每个属性由名称后跟等号和属性值组成。

这些元素按上述顺序用冒号 : 分隔。一个属性条目的示例是 minecraft:farmland:moisture=3。

如何使用

Blopedit 在 Iris 上编辑当前加载的着色器的 block.properties 文件。它允许你通过使用“目标条目”来添加新条目(称为“源条目”),目标条目指定着色器应如何处理源条目。 源条目被添加到目标条目所在的位置。

  • /blopedit addToPropertiesFile <blockStateArgument>:看着一个方块(视为源条目)时运行此命令,方块状态参数作为目标条目。
  • /blopedit addToPropertiesFile <blockStateArgument> matchingCondition <stringArgument>:一个可选参数,决定 Blopedit 应如何将源条目和目标条目与 block.properties 文件中的条目匹配,从而影响源条目添加的位置。
  • blopedit addToPropertiesFile <blockStateArgument> matchingCondition <stringArgument> moveSourceIfFound <booleanArgument>:另一个可选参数,决定是否应删除 block.properties 文件中的匹配条目并将其移动到新的目标条目。如果不删除,则添加源条目失败,并显示警告。

匹配条件

Blopedit 提供四种选项来确定匹配行为:

  • Match Identifiers:仅使用标识符匹配源条目和目标条目,忽略方块状态属性。
  • Match with Properties:使用标识符和属性两者匹配条目。输入条目必须包含匹配的属性和值。
  • Match with Properties Source:匹配源条目的属性,但仅通过标识符匹配目标条目。
  • Match with Properties Destination:匹配目标条目的属性,但仅通过标识符匹配源条目。

添加属性

仅当满足以下条件时,才会将源条目添加到目标条目:

  • 只有一个匹配的目标条目。
  • 没有与源条目匹配的文件条目,或者启用了在找到时移动源的选项。

如果成功,源条目会被添加到找到匹配目标条目的所有行中。如果启用了在找到时移动源,它还会删除匹配的条目并将它们重新插入到找到匹配目标条目的位置。生成的源条目仅包含已存在的匹配条目中存在的属性。

额外功能

其他实用命令包括:

  • /blopedit settings doAutoReloadShaders <booleanArgument>:配置在成功的 block.properties 编辑操作后是否应自动重新加载着色器。
  • /blopedit copyPropertiesFileToFolder:将当前着色器的 block.properties 文件复制到 /.minecraft/blopedit/shaderPackName/block.properties,简化分享和调试。

支持

要报告错误或提出建议,请使用模组的问题跟踪器或加入 Discord 服务器。

致谢

  • 感谢 @spaceagle17 提出此模组的想法。特别感谢 Complementary Shaders 社区的杰出支持!