# Crafting Queue Settings

***

## 🔧 Configuration Options

All queue settings are located in `shared/config.lua` under the **CRAFTING QUEUE SETTINGS** section.

```lua
-- ════════════════════════════════════════════════════════════════════════════════════
--  CRAFTING QUEUE SETTINGS
-- ════════════════════════════════════════════════════════════════════════════════════

Config.CraftingQueue = {
    maxDistance = 5.0,
    checkInterval = 1000,
    warningTime = 15,
}
```

***

## 📝 Setting Descriptions

### Maximum Distance

```lua
maxDistance = 5.0
```

**Purpose**: Define how far (in meters) a player can move from the crafting station before receiving a warning.

**Type**: Number (decimal)

**Unit**: Meters

**Range**: Recommended `5.0` - `10.0`

**How it works**:

* Script continuously monitors player's distance from active crafting station
* When distance exceeds this value, warning system activates
* Player has `warningTime` seconds to return
* If player doesn't return in time, crafting is cancelled

**Examples**:

| Value  | Description               | Use Case                                  |
| ------ | ------------------------- | ----------------------------------------- |
| `3.0`  | Very strict (3m radius)   | Hardcore RP, realistic crafting           |
| `5.0`  | Balanced (5m radius)      | **Default, recommended for most servers** |
| `7.0`  | Relaxed (7m radius)       | Casual servers, more freedom              |
| `10.0` | Very relaxed (10m radius) | Public servers, lenient rules             |

***

### Check Interval

```lua
checkInterval = 1000
```

**Purpose**: How often (in milliseconds) the script checks if the player has moved too far.

**Type**: Number (integer)

**Unit**: Milliseconds (1000ms = 1 second)

**Range**: Recommended `700` - `1000`

**How it works**:

* Script runs a distance check every X milliseconds
* Lower value = more frequent checks = more responsive
* Higher value = less frequent checks = better performance

***

### Warning Time

```lua
warningTime = 15
```

**Purpose**: How long (in seconds) the player has to return to the crafting station after moving too far.

**Type**: Number (integer)

**Unit**: Seconds

**Range**: Recommended `10` - `30`

{% stepper %}
{% step %}

### How the warning works — Step 1

Player moves beyond `maxDistance`.
{% endstep %}

{% step %}

### Step 2

Warning notification appears: "Return to crafting station! (15s)"
{% endstep %}

{% step %}

### Step 3

Countdown starts.
{% endstep %}

{% step %}

### Step 4

If player returns within time, crafting continues.
{% endstep %}

{% step %}

### Step 5

If time expires, crafting is cancelled and resources are lost.
{% endstep %}
{% endstepper %}

**Examples**:

| Value | Description               | Use Case                            |
| ----- | ------------------------- | ----------------------------------- |
| `5`   | Very strict (5 seconds)   | Hardcore servers, no second chances |
| `10`  | Strict (10 seconds)       | Realistic RP, quick return needed   |
| `15`  | Balanced (15 seconds)     | **Default, fair warning**           |
| `20`  | Relaxed (20 seconds)      | Casual servers, more time           |
| `30`  | Very relaxed (30 seconds) | Lenient servers, lots of time       |

***

### Example 2: Balanced (Default/Recommended)

```lua
Config.LetPlayerMoveAwayFromTable = false

Config.CraftingQueue = {
    maxDistance = 5.0,      -- Reasonable range (5m)
    checkInterval = 1000,   -- Standard checks (1s)
    warningTime = 15,       -- Fair warning (15s)
}
```

**Effect**: Good balance between realism and playability, forgiving but not exploitable.

***

### Example 3: Casual/Relaxed Server

```lua
Config.LetPlayerMoveAwayFromTable = false

Config.CraftingQueue = {
    maxDistance = 7.0,      -- Generous range (7m)
    checkInterval = 2000,   -- Relaxed checks (2s)
    warningTime = 30,       -- Lots of time (30s)
}
```

**Effect**: Very forgiving, players have plenty of freedom, good for public servers.

***

### Example 4: Ultra-Hardcore

```lua
Config.LetPlayerMoveAwayFromTable = false

Config.CraftingQueue = {
    maxDistance = 2.0,      -- Must stay very close (2m)
    checkInterval = 500,    -- Instant detection (0.5s)
    warningTime = 5,        -- Almost no time (5s)
}
```

**Effect**: Extremely realistic, players must be dedicated, no room for mistakes.

***

### Example 5: No Restrictions

```lua
Config.LetPlayerMoveAwayFromTable = true -- Can move anywhere

-- Queue settings don't matter when movement is allowed
Config.CraftingQueue = {
    maxDistance = 5.0,
    checkInterval = 1000,
    warningTime = 15,
}
```

**Effect**: Players can walk away completely, no penalties. See [General Settings](https://docs.kojascripts.eu/new/crafting/configuration/broken-reference) for `LetPlayerMoveAwayFromTable`.

***

## 📚 Related Documentation

* For movement configuration, see [General Settings](https://docs.kojascripts.eu/new/crafting/configuration/broken-reference)
* For recovery system, see [Server Settings](https://docs.kojascripts.eu/new/crafting/configuration/broken-reference)
* For crafting setup, see [Crafting Stations](https://docs.kojascripts.eu/new/crafting/configuration/broken-reference)
* For interaction settings, see [Interaction Settings](https://docs.kojascripts.eu/new/crafting/configuration/broken-reference)