Koja Scripts
NEW

Configuration

Welcome to the complete configuration for Koja-Crafting. This guide will help you configure, customize, and optimize your crafting system.

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

📋 Configuration File Structure

📚 Additional Resources

📝 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

  1. Backup

    Save current shared/config.lua

  2. Read Changelog

    Check for breaking changes

  3. Update Files

    Replace resource files

  4. Restore Config

    Copy back your config (check for new options)

  5. Check Database

    Run any new SQL migrations if provided

  6. Test

    Verify everything works on test server

  7. Deploy

    Update live server

📞 Getting Support

Before Asking for Help

  1. Step 1

    Read relevant documentation page

  2. Step 2

    Check troubleshooting sections

  3. Step 3

    Enable debug mode and check console

  4. Step 4

    Search Discord for similar issues

  5. 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

  1. Use it from your own code

    Commands — This page covers all available commands in Koja-Crafting, their usage, permissions, and examples.

  2. Know what it stores

    Database — SQL file needed when automatic database creation does not work properly

In this section

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,).

Crafting Queue Settings

This page covers the crafting queue system that manages distance checking, warnings, and crafting cancellation when players move away from stations.

Crafting Stations Settings

This comprehensive guide covers how to configure crafting stations, add items, create categories, configure blueprints, and customize your crafting system.

Commands

This page covers all available commands in Koja-Crafting, their usage, permissions, and examples.

API

This page covers the API exports, events, and triggers that allow you to integrate Koja-Crafting with other scripts and resources.

Database

SQL file needed when automatic database creation does not work properly