# Interaction Settings


## 🔧 Configuration Options

All interaction settings are located in `shared/config.lua` under the **INTERACTION SETTINGS** section.

```lua title="shared/config.lua"
-- ════════════════════════════════════════════════════════════════════════════════════
--  INTERACTION SETTINGS
-- ════════════════════════════════════════════════════════════════════════════════════

Config.Target = {
    enabled = false,
    resource = 'ox_target',
    icon = 'fas fa-sign-in-alt'
}

Config.Interact = {
    key = 'E',
    text = 'Press ~INPUT_CONTEXT~ to open crafting'
}
```


***

## 📝 Setting Descriptions

### Target System Configuration

```lua title="Config.Target"
Config.Target = {
    enabled = false,
    resource = 'ox_target',
    icon = 'fas fa-sign-in-alt'
}
```


**Purpose**: Enable interaction through target systems (third-eye, eye-target) instead of key press.

Options:

| Setting    | Type    | Description                  | Default                |
| ---------- | ------- | ---------------------------- | ---------------------- |
| `enabled`  | Boolean | Enable/disable target system | `false`                |
| `resource` | String  | Target resource name         | `'ox_target'`          |
| `icon`     | String  | Font Awesome icon class      | `'fas fa-sign-in-alt'` |

***

### Key Press Configuration

```lua title="Config.Interact"
Config.Interact = {
    key = 'E',
    text = 'Press ~INPUT_CONTEXT~ to open crafting'
}
```


**Purpose**: Configure key-based interaction when target system is disabled.

Options:

| Setting | Type   | Description                  | Default                                    |
| ------- | ------ | ---------------------------- | ------------------------------------------ |
| `key`   | String | Key to press for interaction | `'E'`                                      |
| `text`  | String | Help text shown on screen    | `'Press ~INPUT_CONTEXT~ to open crafting'` |

***

***

## 🔧 Configuration Examples

### Example: Using ox\_target

**Configuration**:

```lua title="Config.Target"
Config.Target = {
    enabled = true,
    resource = 'ox_target',
    icon = 'fas fa-hammer'
}
```


**Requirements**:

:::steps
### Step 1

Install ox\_target


### Step 2

Add to server.cfg: `ensure ox_target`


### Step 3

Ensure ox\_target starts before koja-crafting


### Step 4

Restart koja-crafting
:::

**Result**: Players can aim at tables and see "LABEL" option with ICON.

***

### Example: Traditional Key Press

**Configuration**:

```lua title="Config.Target + Config.Interact"
Config.Target = {
    enabled = false, -- Disable target
}

Config.Interact = {
    key = 'E',
    text = 'Press ~INPUT_CONTEXT~ to open crafting'
}
```


**Result**: Simple help text appears when near station, press E to open.

***

## 🎨 Font Awesome Icons

### Popular Icons for Crafting

| Icon Class               | Visual | Use Case               |
| ------------------------ | ------ | ---------------------- |
| `'fas fa-hammer'`        | 🔨     | Weapon crafting        |
| `'fas fa-toolbox'`       | 🧰     | Tool crafting          |
| `'fas fa-wrench'`        | 🔧     | Vehicle crafting       |
| `'fas fa-cog'`           | ⚙️     | Mechanical crafting    |
| `'fas fa-flask'`         | 🧪     | Chemical/drug crafting |
| `'fas fa-mortar-pestle'` | 🏺     | Medical crafting       |
| `'fas fa-tshirt'`        | 👕     | Clothing crafting      |
| `'fas fa-utensils'`      | 🍴     | Food crafting          |
| `'fas fa-box'`           | 📦     | General crafting       |
| `'fas fa-industry'`      | 🏭     | Industrial crafting    |

### Icon Syntax

```lua title="Icon example"
icon = 'fas fa-hammer'
--     │   └─ Icon name
--     └─ Icon style (fas = solid, far = regular, fab = brands)
```


Find more icons: <https://fontawesome.com/icons>

***

## 🎯 Help Text Formatting

### Text Formatting Options

The help text supports GTA V formatting codes:

```lua title="Examples"
-- Basic text
text = 'Press ~INPUT_CONTEXT~ to craft'

-- With color
text = '~g~Press ~INPUT_CONTEXT~ to craft~s~' -- Green text

-- Multiple controls
text = 'Press ~INPUT_CONTEXT~ to craft or ~INPUT_CANCEL~ to exit'

-- Custom styling
text = '~b~[CRAFTING]~s~ Press ~INPUT_CONTEXT~ to open'
```


### Color Codes

| Code  | Color         | Example           |
| ----- | ------------- | ----------------- |
| `~r~` | Red           | `~r~Warning~s~`   |
| `~g~` | Green         | `~g~Available~s~` |
| `~b~` | Blue          | `~b~Info~s~`      |
| `~y~` | Yellow        | `~y~Caution~s~`   |
| `~p~` | Purple        | `~p~Special~s~`   |
| `~o~` | Orange        | `~o~Alert~s~`     |
| `~s~` | White (reset) | `~s~Normal`       |

### Control Input Codes

| Code                      | Result      | Display     |
| ------------------------- | ----------- | ----------- |
| `~INPUT_CONTEXT~`         | E key       | "E"         |
| `~INPUT_CANCEL~`          | Backspace   | "Backspace" |
| `~INPUT_ENTER~`           | Enter       | "Enter"     |
| `~INPUT_FRONTEND_ACCEPT~` | Space/Enter | "Space"     |

Example configurations are shown above.

***

## 📚 Related Documentation

* For crafting station setup, see [Crafting Stations](/new/crafting/configuration/crafting-stations-settings)
* For queue configuration, see [Crafting Queue Settings](/new/crafting/configuration/crafting-queue-settings)
* For general setup, see [General Settings](/new/crafting/configuration/general-settings)
* For installation, see [Installation](/new/crafting/installation)

***

## 🔗 Useful Resources

* ox\_target: <https://github.com/overextended/ox\\_target>
* Font Awesome Icons: <https://fontawesome.com/icons>
* GTA V Control Codes: <https://docs.fivem.net/docs/game-references/controls/>

## Related pages

- [General Settings](/new/crafting/configuration/general-settings) — This page covers the basic configuration options for Koja-Crafting that control debug mode, language, and player behavior.
- [Server Settings](/new/crafting/configuration/server-settings) — This page covers server-side configuration options including database management, crafting recovery, and shared table functionality.
- [Images Settings](/new/crafting/configuration/images-settings) — This page explains how to configure item images, add custom graphics, and manage image paths in Koja-Crafting.
- [Player Progression Settings](/new/crafting/configuration/player-progression-settings) — This page covers the player progression system including levels, experience points, and how to configure the leveling system in Koja-Crafting.
- [Admin Settings](/new/crafting/configuration/admin-settings) — This page covers admin permission configuration and available admin commands for managing Koja-Crafting.
- [Crafting Queue Settings](/new/crafting/configuration/crafting-queue-settings) — This page covers the crafting queue system that manages distance checking, warnings, and crafting cancellation when players move away from stations.
- [Configuration](/new/crafting/configuration) — back to the section overview
