# General Settings

***

## 🔧 Configuration Options

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

```lua
-- ════════════════════════════════════════════════════════════════════════════════════
--  GENERAL SETTINGS
-- ════════════════════════════════════════════════════════════════════════════════════

Config.Debug = false
Config.Locale = 'en'
Config.LetPlayerMoveAwayFromTable = false
Config.DuiQueue = false
```

***

## 📝 Setting Descriptions

### Debug Mode

```lua
Config.Debug = false
```

Purpose: Enable or disable debug console logs for troubleshooting.

Options:

* `true` - Shows detailed console logs for debugging (player actions, crafting events, etc.)
* `false` - Normal operation without debug messages (recommended for production)

When to use:

* ✅ Set to `true` when troubleshooting issues
* ✅ During initial setup to verify everything works
* ❌ Set to `false` on live servers to reduce console spam

Example output when enabled:

```
[KOJA-CRAFTING] Player 1 opened crafting menu: weapon_crafting
[KOJA-CRAFTING] Crafting started: bandage (x3)
[KOJA-CRAFTING] Player 1 has level 2, exp: 150/200
```

***

### Language / Locale

```lua
Config.Locale = 'en'
```

Purpose: Set the language for all UI text, notifications, and messages.

Available Languages:

| Code   | Language | File              |
| ------ | -------- | ----------------- |
| `'en'` | English  | `locales/en.json` |
| `'pl'` | Polish   | `locales/pl.json` |
| `'de'` | German   | `locales/de.json` |
| `'es'` | Spanish  | `locales/es.json` |
| `'fr'` | French   | `locales/fr.json` |
| `'hi'` | Hindi    | `locales/hi.json` |
| `'ja'` | Japanese | `locales/ja.json` |
| `'ru'` | Russian  | `locales/ru.json` |
| `'zh'` | Chinese  | `locales/zh.json` |

How to add custom translations:

{% stepper %}
{% step %}

### Copy a locale file

Copy an existing locale file from the `locales/` folder.
{% endstep %}

{% step %}

### Rename the file

Rename it (e.g., `locales/custom.json`).
{% endstep %}

{% step %}

### Translate strings

Translate all text strings in the new file.
{% endstep %}

{% step %}

### Set the locale

Set `Config.Locale = 'custom'`.
{% endstep %}
{% endstepper %}

Example locale structure (`locales/en.json`):

```json
{
  "crafting_menu_title": "Crafting Menu",
  "not_enough_resources": "You don't have enough resources",
  "crafting_started": "Crafting started",
  "item_claimed": "Item claimed successfully"
}
```

{% hint style="info" %}
Not a whole locale file!
{% endhint %}

***

### Player Movement During Crafting

```lua
Config.LetPlayerMoveAwayFromTable = false
```

Purpose: Control whether players can walk away from the crafting station while items are being crafted.

Options:

* `false` - Players must stay near the crafting table (default)
* `true` - Players can freely move away while crafting

How it works:

When `false` (Recommended):

* Player must stay within `Config.CraftingQueue.maxDistance` (default 5m)
* If player moves too far, they get a warning
* After `Config.CraftingQueue.warningTime` seconds (default 15s), crafting is cancelled
* More realistic and prevents abuse

When `true`:

* Player can move anywhere on the map
* Crafting continues in the background
* More convenient but less realistic

Recommendation: Keep this `false` for balanced gameplay. Use `true` only if your server prefers convenience over realism.

***

### DUI Queue Display

```lua
Config.DuiQueue = false
```

Purpose: Enable or disable 3D visual crafting queue display above crafting tables.

Options:

* `false` - No 3D display (lighter on performance)
* `true` - Shows crafting progress on a 3D screen above the table

What is DUI? DUI (Draw User Interface) renders the crafting queue as a 3D object in the game world. Players can see what's being crafted without opening the menu.

Visual Example:

```
┌─────────────────────┐
│  • Bandage (====)   │
│  • Lockpick (====)  │
└─────────────────────┘
           ↓ 
(Floating above table)
   [Crafting Table]
```

Performance Impact:

* ⚠️ Enabling DUI uses more client resources
* Recommended only for servers with good performance
* Test with multiple players before enabling on live server

When to use:

* ✅ High-performance servers
* ✅ Want visual feedback for shared tables
* ❌ Low-end servers or many crafting stations
* ❌ If players experience FPS drops

***

## 💡 Tips & Best Practices

* Always test in dev environment first before changing settings on live server
* Monitor server performance when enabling DUI on multiple stations
* Keep Debug disabled on production to avoid console spam

***

## 🔍 Troubleshooting

<details>

<summary>Locale not loading</summary>

* Check if the locale file exists in the `locales/` folder
* Verify `Config.Locale` matches the filename (without .json)
* Restart the resource after changing locale

</details>

<details>

<summary>DUI not showing</summary>

* Ensure `Config.DuiQueue = true`
* Check if crafting table has items in queue
* Try relogging or restarting the resource

</details>

<details>

<summary>Debug logs not appearing</summary>

* Verify `Config.Debug = true`
* Check server console (not F8 client console)
* Ensure resource is running (`ensure koja-crafting` in server.cfg)

</details>

***

## 📚 Related Settings

* For distance checking configuration, see [Crafting Queue Settings](broken://pages/3b4075402c111c91047469233d3bb7c3fc172624)
* For interaction configuration, see [Interaction Settings](broken://pages/bf4444e5efa03a3e79aa8e4da2128a182a60a4af)
* For database options, see [Server Settings](broken://pages/50ec52b4314ded85934a512d1cfc09c88a8500ce)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.kojascripts.eu/new/crafting/configuration/general-settings.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.