# Split element
The split gui element is used to add a clickable button to the machine gui. When clicked, all items present in one of the machine's input slots will be sorted to fill all slots.
{% hint style="info" %}
The behavior is very similar to Mekanism's machines auto-sort button
{% endhint %}
All split elements must have a unique string id (that you must specify in the elements properties).
Split elements are defined in json with : `"type": "custommachinery:split"`.
### Properties
The split gui element has 4 mandatory properties and 9 optional properties.
#### Mandatory properties
```json
"type": "custommachinery:button" //Mandatory to define a button element.
```
X
#### Name : `x`
#### Description :
A positive integer value that define the x axis position of the element to be displayed on the Machine GUI.
#### Example :
The element will be rendered 100px to the right from the top-left corner of the gui.
```json5
"x": 100
```
Y
#### Name : `y`
#### Description :
A positive integer value that define the y axis position of the element to be displayed on the Machine GUI.
#### Example :
The element will be rendered 100px to the bottom from the top-left corner of the gui.
```json5
"y": 100
```
Id
#### Name : `id`
#### Description :
A string representing the id of the button, can be used in a Function requirement to check the state of the button, or in a [Button requirement](https://frinn.gitbook.io/custom-machinery-1.21/recipes/requirements/button) to make the recipe start only when the button is pressed.
#### Example :
The id of the button will be `button1` :
```json
"id": "button1"
```
#### Optional properties
Texture
#### Name : `texture`
#### Description :
The location of the texture that will be rendered into the GUI.
The location must be referenced by : `namespace:path/file.png` The texture loader will search for textures in the `assets/namespace` folder, the .png extension is required or the file will not be found.
The texture can be any size, if the texture size is different from the default size the width and height properties of the element will be automatically changed to fit the texture size if not provided.
If the width and/or height properties of the element are provided, the texture will be stretched to fit the dimensions of the element (it can render weirdly in that case).
#### Default :
```json
"texture": "custommachinery:textures/gui/base_split.png"
```
#### Example :
The file `assets/textures/my_texture.png` will be used.
```json5
"texture": "namespace:textures/my_texture.png"
```
Texture toggle
#### Name : `texture_toggle`
#### Description :
The location of the texture that will be rendered into the GUI when the button is toggled and pressed.
The location must be referenced by : `namespace:path/file.png` The texture loader will search for textures in the `assets/namespace` folder, the .png extension is required or the file will not be found.
The texture can be any size, if the texture size is different from the default size the width and height properties of the element will be automatically changed to fit the texture size if not provided.
If the width and/or height properties of the element are provided, the texture will be stretched to fit the dimensions of the element (it can render weirdly in that case).
#### Default :
```json
"texture_toggle": "custommachinery:textures/gui/base_split_toogle.png"
```
#### Example :
The file `assets/textures/my_texture.png` will be used.
```json5
"texture_toggle": "namespace:textures/my_texture.png"
```
Texture hovered
#### Name : `texture_hovered`
#### Description :
The location of the texture that will be rendered into the GUI when the players mouse cursor is hovering the element.
The location must be referenced by : `namespace:path/file.png` The texture loader will search for textures in the `assets/namespace` folder, the .png extension is required or the file will not be found.
The texture can be any size, if the texture size is different from the default size the width and height properties of the element will be automatically changed to fit the texture size if not provided.
If the width and/or height properties of the element are provided, the texture will be stretched to fit the dimensions of the element (it can render weirdly in that case).
#### Default :
```json
"texture_hovered": "custommachinery:textures/gui/base_split_hovered.png"
```
#### Example :
The file `assets/textures/my_texture.png` will be used.
```json5
"texture_hovered": "namespace:textures/my_texture.png"
```
Texture toggle hovered
#### Name : `texture_toggle_hovered`
#### Description :
The location of the texture that will be rendered into the GUI when the button is toggled and the player mouse cursor is hovering it.
The location must be referenced by : `namespace:path/file.png` The texture loader will search for textures in the `assets/namespace` folder, the .png extension is required or the file will not be found.
The texture can be any size, if the texture size is different from the default size the width and height properties of the element will be automatically changed to fit the texture size if not provided.
If the width and/or height properties of the element are provided, the texture will be stretched to fit the dimensions of the element (it can render weirdly in that case).
#### Default :
```json
"texture_toggle_hovered": "custommachinery:textures/gui/base_split_toogle_hovered.png"
```
Example :
The file `assets/textures/my_texture.png` will be used.
```json5
"texture_toggle_hovered": "namespace:textures/my_texture.png"
```
Width
#### Name : `width`
#### Description :
A positive integer value that define the width of the element on the Machine GUI.
#### Default :
The same width as the texture specified in the `texture` property.
#### Example :
The width of the element will be 100px.
```json5
"width": 100
```
Height
#### Name : `height`
#### Description :
A positive integer value that define the height of the element on the Machine GUI.
#### Default :
The same height as the texture specified in the `texture` property.
#### Example :
The height of the element will be 100px.
```json5
"height": 100
```
Priority
#### Name : `priority`
#### Description :
An integer property that define the priority of the Element to be rendered.
Elements with higher priority will be rendered first. If 2 elements are at the same position the first to be rendered will be under and the last will be above.
#### Default : 0
#### Example :
The element will be rendered under each element that have a priority lower than 1000.
```json5
"priority": 1000
```
Tooltips
#### Name : `tooltips`
#### Description :
A list of [Text components](https://frinn.gitbook.io/custom-machinery-1.21/misc/text-component) that will be shown as tooltips when the player mouse cursor hover the element.
Each tooltips of the list will be a new line.
#### Example :
Replace the default tooltips with a single line that say "Click me !" :
```json
"tooltips": "Click me !"
```
Slots
#### Name : `slots`
#### Description :
A list of slot ids which are the slots that will be sorted while this split button is active.
The slots ids must be the same as specified in the [Item component](https://frinn.gitbook.io/custom-machinery-1.21/creating-custom-machines/machine-components/item-component) and [Slot element ](https://frinn.gitbook.io/custom-machinery-1.21/creating-custom-machines/machine-gui/slot-element)`id`property.
If the list is empty then any normal slot (not fuel, upgrade, etc) in `input`mode will be sorted.
#### Default : `empty`
#### Example :
While this split element is active, only slots with ids `input1`, `input2`, `input3` will be sorted.
```json
"slots": ["input1", "input2", "input3"]
```
### Example
A basic split element using the base texture provided by Custom Machinery :
```json5
{
"type": "custommachinery:split",
"x": 20,
"y": 20
}
```
