# Installation

Welcome to **Koja-Crafting**, a fluent crafting system designed to enhance gameplay on your FiveM server. This guide will walk you through the installation process step by step.

***

## 📋 Requirements

Before installing Koja-Crafting, ensure you have the following dependencies:

* [**koja-lib**](https://github.com/Koja-Scripts/koja-lib/releases) - Required library that must be started **before** koja-crafting
* [**ox-mysql**](https://github.com/communityox/oxmysql/releases) - Database resource

***

## 🚀 Installation

::::steps
### Download and install koja-lib

1. Download [**koja-lib**](https://github.com/Koja-Scripts/koja-lib/releases) from the official repository
2. Place it in your `resources` folder

Add to your `server.cfg`:

```cfg title="server.cfg"
ensure koja-lib
```


:::hint{type="warning"}
koja-lib **must** be started before koja-crafting!
:::


### Install Koja-Crafting

1. Download the **koja-crafting** resource
2. Extract it to your `resources` folder

The folder structure should look like this:

```
resources/
├── koja-lib/
└── koja-crafting/
```


### Database setup

You have two options for setting up the database:

#### Option A: Automatic Database Creation (Recommended)

1. Open `shared/config.lua`
2. Ensure this setting is enabled:

```lua title="shared/config.lua"
Config.CreateAutoTable = true
```


The script will automatically create all required tables on first start.

#### Option B: Manual SQL Import

1. Open your database management tool (TablePlus, HeidiSQL, etc.)
2. Import the `koja-crafting.sql` file

This will create three tables:

* `koja-crafting` - Stores player progression (level, exp, blueprints)
* `koja-crafting-objects` - Stores placed crafting station objects
* `koja-crafting-queue` - Stores active and completed crafting queues


### Configure server.cfg (order matters)

Add the following to your `server.cfg` in the correct order:

```cfg title="server.cfg"
# Database
ensure oxmysql

# Dependencies
ensure koja-lib

# Crafting System
ensure koja-crafting
```


:::hint{type="danger"}
The load order matters! koja-lib must start before koja-crafting.
:::
::::

***

## 📚 Additional Resources

* **Documentation**: <https://docs.kojascripts.eu>
* **Discord Support**: <https://discord.gg/kojascripts>
* **GitHub**: Check for updates and report issues

✅ **Installation Complete!** Your crafting system is now ready to use. Enjoy enhancing your server's gameplay experience!

## Related pages

- [Configuration](/new/crafting/configuration) — Welcome to the complete configuration for Koja-Crafting. This guide will help you configure, customize, and optimize your crafting system.
- [Crafting](/new/crafting) — back to the section overview