Blopedit

Important: Before using the Blopedit modification, it is strongly recommended to create a backup of the block.properties file of your shaders. Although this tool is designed to simplify the process of integrating modded blocks with shaders, unforeseen errors or user-related issues may occur during the editing process.

Blopedit is a compact client-side mod for Fabric, intended for editing the block.properties file in shaderpacks. It provides convenient commands and uses your camera to identify blocks. The mod is particularly useful for quickly integrating custom blocks with shaders that use physically-based rendering (PBR), which require specific visual properties—for example, for animated leaves or glowing ores.

Working with the Block.properties File

The block.properties file is used by shaders to assign various visual characteristics to blocks. It is located at /.minecraft/shaderpacks/shader_name.zip/shaders/block.properties. Each entry in the file is unique and can only appear once, except when it refers to different versions of Minecraft.

The entry structure includes:

• Namespace — defines the origin of the block (e.g., minecraft for vanilla blocks or the mod's modID like farmersdelight)
• Path — specifies the specific block type (for example, farmland)
• Block state properties — additional parameters separated by equals signs

Elements are separated by colons. Example of a complete entry: minecraft:farmland:moisture=3.

Using Commands

Blopedit modifies the block.properties file of the currently active shader in Iris. It allows adding new entries ("source") to the position of the target entry ("destination") using specific commands:

• /blopedit addToPropertiesFile <block_state_argument> — executed while looking at the source block, using the argument as the destination entry
• /blopedit addToPropertiesFile <block_state_argument> matchingCondition <string_argument> — additional option for determining how to match source and destination entries in the file
• /blopedit addToPropertiesFile <block_state_argument> matchingCondition <string_argument> moveSourceIfFound <boolean_argument> — another optional parameter determining whether to move existing matching entries

Matching Rules

There are four types of matching:

• Match Identifiers — uses only namespace and path
• Match with Properties — takes identifiers plus all specified state parameters into account
• Match with Properties Source — checks the properties of the source block but only considers identifiers for the destination entry
• Match with Properties Destination — reverse approach from the previous option

Additional Features

Adding a source entry is only performed if there is one matching destination option in the file and no duplicate source entries (or if the option to move them is activated). If successful, the source is added to all lines with matching destinations, and with enabled relocation—original entries are deleted and inserted in new positions.

Additional utility commands:

• /blopedit settings doAutoReloadShaders <argument_value> — customize automatic shader reloading after successful file editing
• /blopedit copyPropertiesFileToFolder — copy the current shader's settings to a separate directory /.minecraft/blopedit/shader_name/block.properties, facilitating configuration sharing and error detection