Custom Blocks API

Allows you to create custom blocks in Minecraft easier with great performance!

How To Use

To use the Custom Blocks API simply include it alongside your datapack and ensure to use the following for your custom blocks.

Give Command

If your pack includes a custom give command this is what the function should look like with this API:

give @s dropper{display:{Name:'{"text":"A Name","italic":false}',Lore:['{"text":"A Lore","italic":false,"color":"red"}']},CustomModelData:0000001,BlockEntityTag:{Lock:"CustomBlocks:Block"},BlockProperties:{Tags:["some_tag_for_this_block"],BaseBlock:{"value":"stone"}}}

To set up your custom blocks with this API simple add the custom models to one of the following blocks with "custom_model_data":

• Dispenser = Your custom block has no rotation.
• Furnace = Your custom block can face in the 4 cardinal directions.
• Dropper = Your custom block can face in all 6 directions.

---

Make Sure To Include the Lock in the BlockEntityTag and set its value to "CustomBlocks:Block"
This tells the API that your block uses this Custom Blocks API system.

Then add your custom block name and an optional lore for the block. Outside the display tag add your custom blocks CustomModelData value.

Finally, add any extra information about the block for when it's placed in the "BlockProperties" tag. All the information in this tag will be copied to the Item Display, the "BaseBlock" in BlockProperties says what you want your base block to be, the value must be a valid block id.

For help on how to set these up see the above give command for an example.

Minimum Minecraft Version

• 1.20.3

About This Project

This is a small datapack that allows you to merge all your custom blocks into 1 which greatly improves performance

Screen Shots

TPS with 16 Custom Blocks loaded Before:

---

TPS with 16 Custom Blocks loaded After using this datapack: