# Configuration

> Configuration reference for ML Smelter Stations

Category: SMELTER STATIONS · Source: https://miciomods.it/docs/ml-smelter-stations-configuration · Last updated: 2026-07-09

## Overview

- `shared/config.lua`: General settings, station definitions, recipe definitions, XP system, fixed stations, categories
- `server/config_server.lua`: Discord webhook URL and log toggles

## General Settings

**shared/config.lua**

```lua
Config.Interaction = nil
Config.Debug = false
Config.Locale = 'en'
Config.EnableStressIntegration = true
Config.Theme = 'Default'
Config.ShowProgression = false
Config.MaxStationsPerPlayer = 3
Config.DuiRenderDistance = 4.0
Config.InteractionDistance = 2.5
```

- `Interaction`: Interaction mode. `nil` = auto-detect via ml_bridge (ox_target preferred), `'target'` = force the target system, `'textui'` = force TextUI
- `Debug`: Print debug messages to server/client console
- `Locale`: Language code for translations
- `EnableStressIntegration`: Adds stress via `ml_hud` when cooking starts. Safe to leave `true` even without ml_hud installed (the integration is skipped when ml_hud is not installed)
- `Theme`: UI theme. Options: `'Default'`, `'Wasteland'`, `'Cyberpunk'`, `'Noir'`, `'Fantasy'`
- `ShowProgression`: Show the Progression tab in the station UI. Requires `Config.XP.Enabled = true`
- `MaxStationsPerPlayer`: Maximum player-placed stations per player. Fixed stations do not count
- `DuiRenderDistance`: Distance in meters at which the floating in-world DUI becomes visible. Set `false` to disable DUI entirely
- `InteractionDistance`: Default distance for ox_target or TextUI interaction. Per-station overrides available

## Hide Recipes

**shared/config.lua**

```lua
Config.HideRecipes = {
    ifMissingItems = false,
    ifLocked = false,
}
```

- `ifMissingItems`: `true` hides recipes when the player lacks the required ingredients
- `ifLocked`: `true` hides recipes when the player does not meet the tier/level requirement

These are global defaults. Each recipe can override with its own `hideIfMissingItems` / `hideIfLocked` field.

## Categories

**shared/config.lua**

```lua
Config.Categories = {
    ['food']    = { label = 'Food',     icon = 'fas fa-drumstick-bite' },
    ['ores']    = { label = 'Metals',   icon = 'fas fa-gem' },
    ['medical'] = { label = 'Medical',  icon = 'fas fa-medkit' },
    ['default'] = { label = 'General',  icon = 'fas fa-cogs' },
}
```

- `label`: Display name in the UI category filter
- `icon`: FontAwesome icon class

## Auto-Deletion

**shared/config.lua**

```lua
Config.DeleteOld = 10

Config.DeleteOptions = {
    DeleteOnlyIfEmpty = true,
    DeleteOnlyIfUnlit = true,
    DeleteOnlyIfBroken = false,
}
```

- `DeleteOld`: Number of days after which inactive stations are deleted. Set `false` to disable
- `DeleteOnlyIfEmpty`: Only delete stations with no items in cooking slots
- `DeleteOnlyIfUnlit`: Only delete stations that are not currently lit/fueled
- `DeleteOnlyIfBroken`: Only delete stations whose durability has reached 0

> **INFO:** Fixed Stations Excluded
>
> Auto-deletion only affects player-placed persistent stations. Fixed stations (with `fixed_id`) are never auto-deleted.

## Station Definitions

Stations are defined in `Config.Stations`. Each key is a unique station type ID.

**shared/config.lua**

```lua
['campfire'] = {
    label = 'Campfire',
    item = 'campfire_kit',
    prop_unlit = 'prop_beach_fire',
    prop_lit = 'prop_beach_fire',
    max_fuel = 1800,
    slots = 3,
    cook_categories = { 'food', 'medical', 'default' },
    persistent = false,
    durability = 1,

    spawnDistance = 50.0,
    interactionDistance = 1.8,
    duiRenderDistance = 3.5,
    duiOffsetZ = 0.8,

    FuelItems = {
        ['legno'] = { required = 1, amount = 600 },
        ['carbone'] = { required = 1, amount = 1200 },
    },
    RepairItems = {
        ['corda'] = { required = 1, repair = 50 },
    }
},
```

- `label`: Display name shown in the UI
- `item`: Inventory item used to place the station
- `prop_unlit`: GTA V prop model when the station is off
- `prop_lit`: GTA V prop model when the station is on (can be the same as `prop_unlit`)
- `max_fuel`: Maximum fuel capacity in seconds (e.g., `1800` = 30 minutes)
- `slots`: Number of crafting slots. Maximum 8
- `cook_categories`: List of recipe categories this station can handle
- `persistent`: `true` saves the station to the database across restarts. `false` makes it temporary
- `durability`: Station lifespan in hours of active use. Omit or set `nil` for infinite durability

### Optional Station Parameters

- `spawnDistance`: Distance for prop spawn/despawn via `lib.points`. Default: `75.0`
- `interactionDistance`: Distance for ox_target or TextUI. Default: `Config.InteractionDistance`
- `duiRenderDistance`: Distance for DUI rendering. Default: `Config.DuiRenderDistance`
- `duiOffsetZ`: Z-axis offset (height) for the DUI above the station. Default: `1.0`
- `duiScale`: Base scale for the DUI sprite. Default: `0.15`
- `useZone`: `true` attaches the target as a sphere zone at station coords instead of an entity target. Use when the prop has no reliable collision mesh (campfires, decals)
- `forceRadius`: Radius in meters for the zone when `useZone = true` or when the prop-entity target is unreliable. Overrides `interactionDistance` for the sphere zone

### Fuel Items

**shared/config.lua**

```lua
FuelItems = {
    ['legno'] = { required = 1, amount = 600 },
    ['carbone'] = { required = 1, amount = 1200 },
},
```

- `required`: Number of items consumed per fuel action
- `amount`: Seconds of fuel added per action

### Repair Items

**shared/config.lua**

```lua
RepairItems = {
    ['corda'] = { required = 1, repair = 50 },
    ['fiamma_ossidrica'] = { required = 1, repair = 100 },
},
```

- `required`: Number of items consumed per repair action
- `repair`: Percentage of max durability restored per action

## Recipe Definitions

Recipes are defined in `Config.Recipes`. Each key is a unique recipe ID.

**shared/config.lua**

```lua
['grill_meat'] = {
    category = 'food',
    tier = 1,
    cook_time = 15,
    carbonize_time = 60,
    ingredients = {
        { name = 'carne_rossa', count = 1 },
    },
    results = {
        { name = 'carne_essiccata', count = 1 },
    }
},
```

- `category`: Must match one of the station's `cook_categories`
- `tier`: XP tier required to craft (1-5). Requires `Config.XP.Enabled = true` to enforce
- `cook_time`: Seconds to complete crafting
- `carbonize_time`: Seconds after completion before the item is destroyed. The player must collect in time
- `ingredients`: List of `{ name, count }` tables for required input items
- `results`: List of `{ name, count }` tables for output items

## XP System

**shared/config.lua**

```lua
Config.XP = {
    Enabled = true,
    Provider = 'internal',
}
```

- `Enabled`: Enable the XP/leveling system
- `Provider`: XP backend. Options:

- `'internal'`: Standalone, stores in `ml_smelter_xp` table. Works out-of-box

- `'ml_skills'`: Delegates to the ml_skills resource (install `_INSTALL/ml_skills_crafting_tree.sql` + `_INSTALL/ml_skills_config_snippet.lua`)

- `'devhub'`: Hooks into DevHub XP exports (configure `DevHub` section)

- `'custom'`: User-defined functions in `open/server.lua`

### Internal Provider

**shared/config.lua**

```lua
Internal = {
    MaxLevel = 50,
    XpBase = 100,
    XpMultiplier = 1.4,
},
```

- `MaxLevel`: Maximum achievable level
- `XpBase`: Base XP required for level 1
- `XpMultiplier`: Exponential multiplier per level. Level N requires `XpBase * (XpMultiplier ^ (N-1))` XP

### ml_skills Provider

**shared/config.lua**

```lua
MlSkills = {
    Category = 'crafting',
    MaxLevel = 50,
},
```

- `Category`: Must match the category UID configured in ml_skills `Config.Categories`
- `MaxLevel`: Must match `maxLevel` in the ml_skills category config

### DevHub Provider

**shared/config.lua**

```lua
DevHub = {
    AddXpExport = 'devhub_xp:addXp',
    GetLevelExport = 'devhub_xp:getLevel',
    MaxLevel = 50,
},
```

- `AddXpExport`: Export string in `resource:function` format for adding XP
- `GetLevelExport`: Export string in `resource:function` format for getting player level
- `MaxLevel`: Max level used for bonus calculations

### XP Rewards

**shared/config.lua**

```lua
Rewards = {
    craft_start = 10,
    craft_complete = 25,
    fuel_added = 5,
    repair = 5,
},
```

- `craft_start`: XP awarded when starting a craft
- `craft_complete`: XP awarded when collecting a finished item
- `fuel_added`: XP awarded when adding fuel
- `repair`: XP awarded when repairing a station

### Recipe XP Overrides

**shared/config.lua**

```lua
RecipeXpOverride = {
    -- ['titan_feast']        = 80,
    -- ['forge_carbon_fiber'] = 60,
},
```

Override the base XP for specific recipes by recipe ID. When a recipe ID is present in this table, the value replaces `Rewards[actionType]` for that action.

### Tiers

**shared/config.lua**

```lua
Tiers = {
    [1] = { level = 1,  label = 'Novice',      speed = 0.00, antiCarbonize = 0.00 },
    [2] = { level = 5,  label = 'Apprentice',   speed = 0.05, antiCarbonize = 0.08 },
    [3] = { level = 15, label = 'Journeyman',   speed = 0.12, antiCarbonize = 0.20 },
    [4] = { level = 25, label = 'Expert',       speed = 0.20, antiCarbonize = 0.35 },
    [5] = { level = 40, label = 'Master',       speed = 0.30, antiCarbonize = 0.50 },
},
```

- `level`: Minimum player level to unlock this tier
- `label`: Display name in the UI
- `speed`: Cook time reduction as a fraction (0.10 = 10% faster)
- `antiCarbonize`: Carbonization time extension as a fraction (0.20 = 20% longer before items burn)

### Tier Bonuses Toggle

**shared/config.lua**

```lua
Bonuses = {
    speed = true,
    antiCarbonize = true,
},
```

- `speed`: Enable/disable cook time reduction from tier bonuses
- `antiCarbonize`: Enable/disable carbonize time extension from tier bonuses

## Fixed Stations

**shared/config.lua**

```lua
Config.FixedStations = {
    {
        id = 'main_forge_sandy',
        stationType = 'forge',
        coords = vec3(-1102.2462, 2689.7517, 19.3630),
        heading = 180.0,
        infiniteFuel = true,
        infiniteHealth = true,
        spawnProp = true,
    },
    {
        id = 'paleto_bay_campfire',
        stationType = 'campfire',
        coords = vec3(-1096.6827, 2692.7454, 19.7475),
        heading = 270.0,
        infiniteFuel = false,
        infiniteHealth = false,
        spawnProp = false,
        zoneType = 'sphere',
        zoneRadius = 2.0,
    },
}
```

- `id`: Unique string identifier. Used as `fixed_id` in the database
- `stationType`: Must match a key in `Config.Stations`
- `coords`: World position as `vec3`
- `heading`: Rotation in degrees
- `infiniteFuel`: `true` skips fuel consumption entirely. Station is always lit
- `infiniteHealth`: `true` skips durability degradation
- `spawnProp`: `true` spawns the prop model from the station definition. `false` uses an existing map prop and creates a target zone instead
- `zoneType`: Zone shape when `spawnProp = false`. Options: `'sphere'`, `'box'`
- `zoneRadius`: Radius when `zoneType = 'sphere'`
- `zoneSize`: Size when `zoneType = 'box'` (vec3)
- `zoneRotation`: Rotation when `zoneType = 'box'`

## Server Logging

**server/config_server.lua**

```lua
Config.DiscordWebhook = ''

Config.Log = {
    Createpersistent = true,
    Temporary = true,
    Destroy = true,
    Repair = true,
    Addfuel = true,
    Additem = true,
    TakeItem = true,
    TakeAll = true,
    TakeAllCarbonized = true,
}
```

- `DiscordWebhook`: Discord webhook URL for all logs. Set empty string to disable
- `Createpersistent`: Log persistent station creation
- `Temporary`: Log temporary station creation
- `Destroy`: Log station pickup/destruction
- `Repair`: Log station repairs
- `Addfuel`: Log fuel additions
- `Additem`: Log items added for crafting
- `TakeItem`: Log single item collection
- `TakeAll`: Log batch item collection
- `TakeAllCarbonized`: Log carbonized item collection

Set any log to `false` to disable that log entirely.