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 - Required library that must be started before koja-crafting

  • ox-mysql - Database resource

🚀 Installation

1

Download and install koja-lib

  1. Download koja-lib from the official repository

  2. Place it in your resources folder

Add to your server.cfg:

server.cfg
ensure koja-lib

koja-lib must be started before koja-crafting!

2

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/
3

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:

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

4

Configure server.cfg (order matters)

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

server.cfg
# Database
ensure oxmysql

# Dependencies
ensure koja-lib

# Crafting System
ensure koja-crafting

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!

PreviousCraftingNextConfiguration