Crafting Queue Settings#

🔧 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:

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:

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

Related pages#

• General Settings — This page covers the basic configuration options for Koja-Crafting that control debug mode, language, and player behavior.
• Server Settings — This page covers server-side configuration options including database management, crafting recovery, and shared table functionality.
• Images Settings — This page explains how to configure item images, add custom graphics, and manage image paths in Koja-Crafting.
• 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 — This page covers admin permission configuration and available admin commands for managing Koja-Crafting.
• Interaction Settings — This page covers how players interact with crafting stations - either through key press or target system (ox_target,qb-target,).
• Configuration — back to the section overview