# Admin Settings

***

## 🔧 Configuration Options

All admin settings are located in `shared/config.lua` under the **ADMIN PERMISSIONS** section.

```lua
-- ════════════════════════════════════════════════════════════════════════════════════
--  ADMIN PERMISSIONS
-- ════════════════════════════════════════════════════════════════════════════════════

Config.AdminGroups = { 'admin', 'owner', 'superadmin', 'god' }
```

***

## 📝 Setting Description

### Admin Groups

```lua
Config.AdminGroups = { 'admin', 'owner', 'superadmin', 'god' }
```

Purpose: Define which player groups have access to admin commands.

How it works:

* The script checks if a player's group matches any entry in this list
* Case-sensitive (must match exact group names in your framework)

***

## 🛠️ Available Admin Commands

{% stepper %}
{% step %}

### Add Blueprint Command

Command: `/addblueprint [playerID] [blueprintItem]`

Purpose: Grant a blueprint to a player, allowing them to craft special items.

Syntax:

```
/addblueprint [playerID] [blueprintItem]
```

Parameters:

| Parameter       | Type   | Description                     | Example               |
| --------------- | ------ | ------------------------------- | --------------------- |
| `playerID`      | Number | Target player's server ID       | `1`, `5`, `42`        |
| `blueprintItem` | String | Blueprint item name from config | `parachute_blueprint` |

Examples:

```bash
# Give parachute blueprint to player 1
/addblueprint 1 parachute_blueprint

# Give weapon blueprint to player 5
/addblueprint 5 weapon_blueprint
```

What happens:

* Blueprint is added to player's database record
* Player receives notification
* Blueprint item becomes available in crafting menu
* Player can now craft the associated item

Requirements:

* Player must be online
* Blueprint must exist in crafting config
* Item must have `blueprintItem` field defined

Blueprint Configuration Example:

```lua
blueprints = {
    {
        respname = 'parachute',
        name = 'Parachute',
        category = 'tools',
        image = './images/parachute.webp',
        blueprintItem = 'parachute_blueprint', -- This is what you use in command
        craftingTime = 120,
        requiredLevel = 4,
        resources = {
            { name = 'cloth', amount = 10 },
            { name = 'rope', amount = 5 }
        },
        exp = 100
    }
}
```

{% endstep %}

{% step %}

### Add Experience Command

Command: `/addexp [playerID] [amount]`

Purpose: Grant experience points to a player for crafting level progression.

Syntax:

```
/addexp [playerID] [amount]
```

Parameters:

| Parameter  | Type   | Description               | Example              |
| ---------- | ------ | ------------------------- | -------------------- |
| `playerID` | Number | Target player's server ID | `1`, `5`, `42`       |
| `amount`   | Number | XP amount to add          | `100`, `500`, `1000` |

Examples:

```bash
# Give 100 XP to player 1
/addexp 1 100

# Give 500 XP to player 5 (might level up)
/addexp 5 500
```

What happens:

* XP is added to player's current experience
* Player's level is recalculated automatically
* If enough XP, player levels up (possibly multiple times)
* Player receives notification with new level
* Progress saved to database immediately
  {% endstep %}
  {% endstepper %}

***

***

## 📋 Permission Errors

<details>

<summary><strong>"No permissions! You need admin rights to use this command."</strong></summary>

* Player doesn't have required group
* Check `Config.AdminGroups` configuration
* Verify player's actual group in framework

</details>

<details>

<summary><strong>"Command error - contact administrator"</strong></summary>

* Framework detection failed
* koja-lib not loaded properly
* Check console for detailed error

</details>

### Debugging Permission Issues

1. Enable debug mode:

```lua
Config.Debug = true
```

2. Check console output:

```
[KOJA-CRAFTING] Player 5 attempting admin command
[KOJA-CRAFTING] Player group: 'user'
[KOJA-CRAFTING] Required groups: admin, superadmin, owner
[KOJA-CRAFTING] Permission denied
```

4. Check framework initialization:

```
[koja-crafting] INITIALIZING FRAMEWORK: ESX
```

***

## 📊 Admin Command Reference

| Command         | Syntax                | Purpose                   | Permission Required |
| --------------- | --------------------- | ------------------------- | ------------------- |
| `/addblueprint` | `[playerID] [item]`   | Grant blueprint to player | Admin group         |
| `/addexp`       | `[playerID] [amount]` | Give XP to player         | Admin group         |

***

## 📚 Related Documentation

* For progression system details, see [Player Progression](https://docs.kojascripts.eu/new/crafting/configuration/broken-reference)
* For crafting configuration, see [Crafting Stations](https://docs.kojascripts.eu/new/crafting/configuration/broken-reference)
* For server setup, see [Server Settings](https://docs.kojascripts.eu/new/crafting/configuration/broken-reference)
* For command implementation, see [Commands](https://docs.kojascripts.eu/new/crafting/configuration/broken-reference)