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 Options

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

-- ════════════════════════════════════════════════════════════════════════════════════
--  CRAFTING QUEUE SETTINGS
-- ════════════════════════════════════════════════════════════════════════════════════

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

---

📝 Setting Descriptions

Maximum Distance

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

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

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

1

How the warning works — Step 1

Player moves beyond maxDistance.

2

Step 2

Warning notification appears: "Return to crafting station! (15s)"

3

Step 3

Countdown starts.

4

Step 4

If player returns within time, crafting continues.

5

Step 5

If time expires, crafting is cancelled and resources are lost.

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)

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

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

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

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 for LetPlayerMoveAwayFromTable.

---

📚 Related Documentation

• For movement configuration, see General Settings

• For recovery system, see Server Settings

• For crafting setup, see Crafting Stations

• For interaction settings, see Interaction Settings