> For the complete documentation index, see [llms.txt](https://vayk.gitbook.io/blockstocommand/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://vayk.gitbook.io/blockstocommand/configuration.md).

# Configuration

```yaml
########################################################################################################
# Addon mainly made for ExecutableBlocks | ExecutableItems
# This allows you to get the commands needed for items/blocks section for the plugin mentioned above
# If have any question feel free to join to this Discord -> https://discord.com/invite/7n8wHXu
# Made by: Vayk
########################################################################################################

#Normally set to false, be careful when setting this to true, this can causes MASSIVE lag
#The amount of commands needed to set more than 50000 blocks is huge. It is recommended to don't change this option.
OverrideLimit: false

#Default set to NETHERITE_HOE, you can select the tool you'd like to have.
Tool: NETHERITE_HOE

#Default set by true, it adds the sound of wood.place and stone.place when the blocks are placed.
BlockSounds: true

#Default set by false, it adds particles in the area selected by the tool
areaParticles: false

setBlockArgument: keep
#destroy keep or replace | DEFAULT -> keep

#Default set by true, it adds the commands to the blocks, you would think why ? you cant hide this and add your additional commands
enableCommands: true

#Additional commands that will be added to the list of commands, for example:
AdditionalCommands:
- none #this represents nothing and it helps the plugin to don't delete this line
#- execute at %player% run playsound minecraft:block.lantern.place block @a %block_x% %block_y% %block_z% 0.5 1
#- execute at %player% run particle dust 1 1 1 1 %block_x% %block_y% %block_z% 0.3 0.3 0.3 0 10
# Here you can use %btc_block_x%, %btc_block_y%, %btc_block_z% to get the coordinates of the block
# %btc_block% to get the block name

fourDirections: false
#The plugin will generate 4 YML of each direction instead of just 1.
#WHERE YOU LOOK IS IMPORTANT, IT IS RECOMMENDED TO LOOK AT YOUR BUILDING DIRECTLY
#THIS CAN BREAK THE STAIRS OF YOUR ORIGINAL BUILDING check the wiki for more info, if don't want that just don't touch this option
```

### OverrideLimit

* The plugin has a maximum of 50.000 blocks copied as limit, if want more blocks you can enable this to true, it is not recommended because it can causes massive lag.
* Default: false

### Tool

* The minecraft tool that will be given when using /btc tool
* Default: NETHERITE\_HOE

### BlockSounds

* Its add random sounds (wood and stone) between each block when they are placed.
* Default: true

### areaParticles

* Adds particle to the area selected by the tool
* Default: false

<figure><img src="https://316353627-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F58VfNWine9Ns7kxCKZXC%2Fuploads%2FmbvwuCOuryvQ3b6Xetkh%2Fimage.png?alt=media&amp;token=5e3944bf-a49b-48cc-8b12-4675e5954df1" alt=""><figcaption></figcaption></figure>

### setBlockArgument

* Select here the type of argument for the setblock
* Default: keep
* Options: keep - destroy - replace

### AdditionalCommands

* Additional commands that will be added to the list of commands between each setblock
* Default: none
* Example:

```
- execute at %player% run playsound minecraft:block.lantern.place block @a %block_x% %block_y% %block_z% 0.5 1
- execute at %player% run particle dust 1 1 1 1 %block_x% %block_y% %block_z% 0.3 0.3 0.3 0 10
```

### fourDirections

* Enables the creation of 4 .yml with each direction, useful to make stuff easier and not creating one building per direction
* Default: false

{% hint style="warning" %}
It can break staircase orientation of the original building when copying and the way to avoid this needs some performances, I am checking what to do to fix this, if don't want this to happen, just don't enable this option for now.
{% endhint %}