::since{version=1.1.0}
# Custom

Identifies a fully free-form JEI category, which allows custom background, drawable, and slot placement.

## 导入类

It might be required for you to import the package if you encounter any issues (like casting an Array), so better be safe than sorry and add the import at the very top of the file.
```zenscript
import mods.jei.category.Custom;
```


## Extending SimpleJeiCategory

Custom extends [SimpleJeiCategory](/mods/JEITweaker/API/Category/SimpleJeiCategory). That means all methods available in [SimpleJeiCategory](/mods/JEITweaker/API/Category/SimpleJeiCategory) are also available in Custom

## 使用方式

:::group{name=addDrawable since="1.1.0"}

Places a new [JeiDrawable](/mods/JEITweaker/API/Component/JeiDrawable) at the given coordinates.

Return Type: void

```zenscript
Custom.addDrawable(x as int, y as int, drawable as JeiDrawable) as void
```

| 参数       | 类型                                                        | 描述                                                    |
| -------- | --------------------------------------------------------- | ----------------------------------------------------- |
| x        | int                                                       | The x coordinate where the drawable should be placed. |
| y        | int                                                       | The y coordinate where the drawable should be placed. |
| drawable | [JeiDrawable](/mods/JEITweaker/API/Component/JeiDrawable) | The drawable to add.                                  |


:::

:::group{name=addSlot since="1.1.0"}

Places a new slot to this recipe with the given index at the specified coordinates.

Return Type: void

```zenscript
Custom.addSlot(index as int, x as int, y as int, isInput as boolean) as void
```

| 参数      | 类型  | 描述                                                                 |
| ------- | --- | ------------------------------------------------------------------ |
| index   | int | The slot index. Must be unique.                                    |
| x       | int | The x coordinate where the slot should be placed.                  |
| y       | int | The y coordinate where the slot should be placed.                  |
| isInput | 布尔值 | Whether the slot is an input (`true`) or an output (`false`) slot. |


:::

:::group{name=addText since="1.1.0"}

Adds a new text area that appears at the given coordinates.

 The added text area is <em>global</em>, meaning it appears in all recipes the same way.

Return Type: void

```zenscript
Custom.addText(x as int, y as int, text as Component) as void
```

| 参数 | 类型                                       | 描述                                             |
| -- | ---------------------------------------- | ---------------------------------------------- |
| x  | int                                      | The x coordinate where the text should appear. |
| y  | int                                      | The y coordinate where the text should appear. |
| 文本 | [Component](/vanilla/api/text/Component) | The text that should appear.                   |


:::

:::group{name=addTooltip since="1.1.0"}

Adds a new tooltip that appears when the mouse is in a rectangle active area of width `w` and height `h` at the specified coordinates with the given text.

 The tooltip is <em>global</em>, meaning it appears in all recipes with the same text.

Return Type: void

```zenscript
Custom.addTooltip(x as int, y as int, w as int, h as int, text as Component[]) as void
```

| 参数 | 类型                                         | 描述                                                                                                             |
| -- | ------------------------------------------ | -------------------------------------------------------------------------------------------------------------- |
| x  | int                                        | The x coordinate of the top-left corner of the active area.                                                    |
| y  | int                                        | The y coordinate of the top-left corner of the active area.                                                    |
| w  | int                                        | The width of the rectangle that determines the active area.                                                    |
| h  | int                                        | The height of the rectangle that determines the active area.                                                   |
| 文本 | [Component](/vanilla/api/text/Component)[] | A list of [Component](/vanilla/api/text/Component)s indicating the text that should be present in the tooltip. |


:::


## 参数

| 名称                     | 类型   | 可获得   | 可设置  | 描述                                                                                                                |
| ---------------------- | ---- | ----- | ---- | ----------------------------------------------------------------------------------------------------------------- |
| background             | void | false | true | Sets the [JeiDrawable](/mods/JEITweaker/API/Component/JeiDrawable) which acts as the background of this category. |
| canHaveShapelessMarker | void | false | true | Sets whether recipes in this category can be marked as shapeless.                                                 |



参数	类型	描述
参数 x	类型 int	描述 The x coordinate where the drawable should be placed.
参数 y	类型 int	描述 The y coordinate where the drawable should be placed.
参数 drawable	类型 JeiDrawable	描述 The drawable to add.

参数	类型	描述
参数 index	类型 int	描述 The slot index. Must be unique.
参数 x	类型 int	描述 The x coordinate where the slot should be placed.
参数 y	类型 int	描述 The y coordinate where the slot should be placed.
参数 isInput	类型布尔值	描述 Whether the slot is an input (`true`) or an output (`false`) slot.

参数	类型	描述
参数 x	类型 int	描述 The x coordinate where the text should appear.
参数 y	类型 int	描述 The y coordinate where the text should appear.
参数文本	类型 Component	描述 The text that should appear.

参数	类型	描述
参数 x	类型 int	描述 The x coordinate of the top-left corner of the active area.
参数 y	类型 int	描述 The y coordinate of the top-left corner of the active area.
参数 w	类型 int	描述 The width of the rectangle that determines the active area.
参数 h	类型 int	描述 The height of the rectangle that determines the active area.
参数文本	类型 Component[]	描述 A list of Components indicating the text that should be present in the tooltip.

名称	类型	可获得	可设置	描述
名称 background	类型 void	可获得 false	可设置 true	描述 Sets the JeiDrawable which acts as the background of this category.
名称 canHaveShapelessMarker	类型 void	可获得 false	可设置 true	描述 Sets whether recipes in this category can be marked as shapeless.