Helpful Hitboxes

Inside the config folder, there will be a file called ‘helpfulhitboxes.json’ that looks like this by default.

The JSON Array ‘compatible_blocks’ defines the blocks that work in the mod. Block names that are placed directly inside it, such as ‘minecraft:chain’ will work individually. What this means is that they will only exhibit the full cube hitbox behaviour when the player is holding that specific block; by default, chains only work with chains and end rods only work with end rods. (Scaffolding is added only to make it work with the offhand). However, if you define another JSON array called ‘group’ inside of it, all of the block names within will be ‘grouped’ and work with each other. For example, by default any fence will use the full cube when the player is holding any other fence, and all pane-like blocks (glass panes and iron bars) will use the full cube when holding any other of them.

It is possible to specfify block tags in either the grouped main array or one of the groups, as can be seen in the default file. It does not matter if redundant block IDs are declared, as can be seen with the use of both the names for each vanilla glass pane and the ‘c’ and ‘forge’ tags which support new panes from fabric and forge respectively, but also include the vanilla ones. This is also an example of how it is not necessary for a block or tag ID to correspond to an actual value – the mod will ignore any that don’t exist in the game. However, the config file must use correct JSON syntax. If you forget to put a comma after one of the IDs or groups that isn’t the last one in its array, or if you open a bracket without closing it, the file will be not be read and the mod will revert to the default list of compatible blocks. If you are having trouble with the syntax, try putting the config file into an online JSON validator, which will highlight the errors for you.