# Trucker

:::hint{type="info"}
This documentation is for **server owners**. If you are looking for the in-game help, open the tablet and explore — every screen is self-explanatory.
:::

## What's inside

| Feature                | Summary                                                                                                   |
| ---------------------- | --------------------------------------------------------------------------------------------------------- |
| 🚚 **Orders**          | Van / Truck / Semi-truck jobs with categories: default, urgent, dangerous, fragile, illegal and business. |
| 🏢 **Companies**       | Found a firm, invite drivers, set a delivery cut, manage a shared bank, climb the rankings.               |
| 🤝 **Convoys**         | Up to 4 drivers haul the same contract together and all get paid.                                         |
| 🌟 **Skills**          | Three skill trees (Van / Truck / Semi) with perks bought using skill points.                              |
| 🔑 **Rentals**         | Rent a rig that an NPC delivers to the nearest road.                                                      |
| 📋 **Quests**          | Configurable daily & weekly challenges with money / XP / SP rewards.                                      |
| 🎟️ **Promo codes**    | Redeemable boosts — perfect for events and Tebex packages.                                                |
| 🏆 **Leaderboard**     | Weekly / monthly / all-time company rankings.                                                             |
| 🌍 **9 languages**     | en · pl · de · es · fr · hi · ja · ru · zh, fully translatable.                                           |
| 🛠️ **Admin panel**    | In-tablet editor for orders, depots, vehicles, skills, promos, quests, companies and settings.            |
| 📡 **Discord logging** | Clean embeds for deliveries, companies, skills + an anti-cheat channel.                                   |
| 🔌 **Developer API**   | Documented exports & events to integrate with your other resources.                                       |

## Requirements

* A supported framework: **ESX**, **QBCore**
* [`oxmysql`](https://github.com/overextended/oxmysql)
* `koja-lib` (bundled dependency)

## Start here

:::steps

### Install it

[Installation](/jobs/trucker/installation) — Make sure these are installed and started before Koja Trucker.

### Configure it

[Configuration](/jobs/trucker/configuration) — Almost everything is editable live from the in-game admin panel (no restart), and persisted to data/config.json. You can also edit that file directly.

### Learn what it does

[Features](/jobs/trucker/features) — Koja Trucker includes a full set of progression, social, and admin-driven systems.

### Use it from your own code

[Commands](/jobs/trucker/commands) — Every admin command lives under one root: /truckeradmin.

:::

## In this section

::::cards{cols="2"}
:::card{title="Installation" href="/jobs/trucker/installation" icon="download"}
Make sure these are installed and started before Koja Trucker.
:::
:::card{title="Commands" href="/jobs/trucker/commands" icon="terminal"}
Every admin command lives under one root: /truckeradmin.
:::
:::card{title="Features" href="/jobs/trucker/features" icon="sparkles"}
Koja Trucker includes a full set of progression, social, and admin-driven systems.
:::
:::card{title="Configuration" href="/jobs/trucker/configuration" icon="settings"}
Almost everything is editable live from the in-game admin panel (no restart), and persisted to data/config.json. You can also edit that file directly.
:::
::::