# Configuration

## 📖 Overview

This repository contains the main configuration and resource structure for Koja-Crafting. For full installation instructions, see the Installation Guide.

* Installation Guide: [LINK](https://docs.kojascripts.eu/~/revisions/wtS8RQ73KLBYIwBpyLwg/new/crafting/installation)

***

## 📋 Configuration File Structure

## 📚 Additional Resources

### Official Links

* Documentation: <https://docs.kojascripts.eu>
* Store: <https://kojascripts.eu>
* Discord Support: <https://discord.gg/kojascripts>
* GitHub: <https://github.com/Koja-Scripts>

***

## 📝 Configuration Checklist

Before going live, verify:

* [ ] koja-lib installed and configured
* [ ] Database tables created (auto or manual)
* [ ] Language set correctly
* [ ] Images loading properly
* [ ] At least one crafting station configured
* [ ] Items have valid resources
* [ ] Progression system balanced
* [ ] Admin permissions configured
* [ ] Interaction method working
* [ ] Tested with real players
* [ ] Backup of config saved
* [ ] No console errors

***

## 🔄 Update Process

:::steps
### Backup

Save current shared/config.lua

### Read Changelog

Check for breaking changes

### Update Files

Replace resource files

### Restore Config

Copy back your config (check for new options)

### Check Database

Run any new SQL migrations if provided

### Test

Verify everything works on test server

### Deploy

Update live server
:::

***

## 📞 Getting Support

### Before Asking for Help

:::steps
### Step 1

Read relevant documentation page

### Step 2

Check troubleshooting sections

### Step 3

Enable debug mode and check console

### Step 4

Search Discord for similar issues

### Step 5

Try on clean test server
:::

### When Asking for Help, Provide

* Server framework (ESX/QBCore/Etc)
* koja-crafting & koja-lib version
* Error messages from console
* Config sections related to issue
* Steps to reproduce problem
* What you've already tried

### Support Channels

* Discord Tickets: Best for complex issues
* Discord Quick Support: Quick questions
* Documentation: Self-service answers

***

Happy Crafting! 🎨

## Start here

:::steps

### Use it from your own code

[Commands](/new/crafting/configuration/commands) — This page covers all available commands in Koja-Crafting, their usage, permissions, and examples.

### Know what it stores

[Database](/new/crafting/configuration/database) — SQL file needed when automatic database creation does not work properly

:::

## In this section

::::cards{cols="2"}
:::card{title="General Settings" href="/new/crafting/configuration/general-settings" icon="sliders"}
This page covers the basic configuration options for Koja-Crafting that control debug mode, language, and player behavior.
:::
:::card{title="Server Settings" href="/new/crafting/configuration/server-settings" icon="sliders"}
This page covers server-side configuration options including database management, crafting recovery, and shared table functionality.
:::
:::card{title="Images Settings" href="/new/crafting/configuration/images-settings" icon="sliders"}
This page explains how to configure item images, add custom graphics, and manage image paths in Koja-Crafting.
:::
:::card{title="Player Progression Settings" href="/new/crafting/configuration/player-progression-settings" icon="sliders"}
This page covers the player progression system including levels, experience points, and how to configure the leveling system in Koja-Crafting.
:::
:::card{title="Admin Settings" href="/new/crafting/configuration/admin-settings" icon="sliders"}
This page covers admin permission configuration and available admin commands for managing Koja-Crafting.
:::
:::card{title="Interaction Settings" href="/new/crafting/configuration/interaction-settings" icon="sliders"}
This page covers how players interact with crafting stations - either through key press or target system (ox\_target,qb-target,).
:::
:::card{title="Crafting Queue Settings" href="/new/crafting/configuration/crafting-queue-settings" icon="sliders"}
This page covers the crafting queue system that manages distance checking, warnings, and crafting cancellation when players move away from stations.
:::
:::card{title="Crafting Stations Settings" href="/new/crafting/configuration/crafting-stations-settings" icon="sliders"}
This comprehensive guide covers how to configure crafting stations, add items, create categories, configure blueprints, and customize your crafting system.
:::
:::card{title="Commands" href="/new/crafting/configuration/commands" icon="terminal"}
This page covers all available commands in Koja-Crafting, their usage, permissions, and examples.
:::
:::card{title="API" href="/new/crafting/configuration/api" icon="code"}
This page covers the API exports, events, and triggers that allow you to integrate Koja-Crafting with other scripts and resources.
:::
:::card{title="Database" href="/new/crafting/configuration/database" icon="database"}
SQL file needed when automatic database creation does not work properly
:::
::::