From 2894d1806952a121a73bb169af57303c77b02581 Mon Sep 17 00:00:00 2001 From: BJTMastermind Date: Fri, 26 Feb 2021 22:30:21 +0000 Subject: [PATCH] Updated README.md Added more detail to how to use section --- README.md | 25 +++++++++++++++++++++---- 1 file changed, 21 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index bf10e11..c08d1cf 100644 --- a/README.md +++ b/README.md @@ -7,22 +7,39 @@ - [ ] Replace Armor Stands with Glow Item Frames in 1.17+ ## 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: ```mcfunction give @p dropper{display:{Name:'{"text":"A Name","italic":false}',Lore:['{"text":"A Lore","italic":false,"color":"red"}']},CustomModelData:0000001,BlockEntityTag:{Lock:"CustomBlocks:Block"},BlockProperties:{CustomName:'{"text":"Block"}',SetblockCommand:"setblock ~ ~ ~ stone"}} ``` -

You first put your placer block (Must be: Furnace, Dropper, or Dispenser as non rotating block) then spcify its properites like the display name, an option lore, the custom model data value, the lock Must be CustomBlocks:Block which tells the pack that its a custom block, then inside "BlockProperties" you add any extra info
to give the armor stand and set the base block for when placed in the world.

+ -More Info Coming Soon... +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. (Requires 3 models) + +
+ +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. Add your custom blocks CustomModelData value
outside the display tag. + +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 Armor Stand, and the "SetblockCommand" in BlockProperties says what you want your base block to be. + +For help on how to set these up see the above give command for an example. ## Minimum Minecraft Version -* 1.16.4 +* 1.16.4 (May work in older versions as low as 1.15.2 but has not been tested) ## About This Project -This is a small datapack that allows you to merge all your custom blocks into 1 with greatly improves performance +This is a small datapack that allows you to merge all your custom blocks into 1 which greatly improves performance # Screen Shots