# F.A.Q

> Frequently asked questions for ML Recycler

Category: RECYCLER · Source: https://miciomods.it/docs/ml-recycler-faq · Last updated: 2026-10-05

## Setup

**How do I change the language?**

Set `Config.Language` in `shared/config.lua`. See the `locales/` folder.

**shared/config.lua**

```lua
Config.Language = 'en'
```

**How do I add a new recipe?**

Add an entry to `Config.RecycleRecipes` with the input item as the key:

**shared/config.lua**

```lua
Config.RecycleRecipes['my_item'] = {
    baseTime = 45,
    outputs = {
        { item = 'scrap_metal', min = 1, max = 3, chance = 100 },
        { item = 'rare_part',   min = 1, max = 1, chance = 15 },
    },
    tierBonuses = {
        [2] = { chanceBoost = 5,  quantityBoost = 1 },
        [3] = { chanceBoost = 15, quantityBoost = 2 },
    },
}
```

The input item and every output item must exist in your inventory.

## Recipes and Tiers

**What is the recycler tier?**

The recycler runs at tier `1` by default. Recipes can reward higher recycler tiers in two ways: an output with `tierRequired = 2` only drops at tier 2 or above, and `tierBonuses` raise chance and quantity per tier. Raise the machine tier by setting `tier = 2` (or `3`) on `Config.Recycler`.

**Do tier bonuses stack with upgrades?**

Yes. Tier bonuses change loot chance and quantity. The turbo motor upgrade changes processing speed. They apply independently.

## Loot Collection

**Can only the player who deposited the items collect the loot?**

Yes. Set `AllowSteal` to `false` in `shared/config.lua`. Add the table below if it is missing:

**shared/config.lua**

```lua
Config.Queue = {
    AllowSteal = false,
}
```

Each slot's loot is reserved for the character who deposited its items. Owning the recycler does not grant access to another character's reserved loot. The same rule applies to fixed stations and survives reconnects and resource restarts.

Set `AllowSteal` to `true` to allow public collection. Other machine permissions still apply.

**Does private collection apply to items already in the recycler?**

Deposits made before private loot collection was added have no recorded owner and remain public. New deposits record the depositor even while collection is public.

## Fuel

**How does the fuel system work?**

With `Config.Features.fuelSystem = true`, a running machine burns `Config.Fuel.perMinute` units per minute. When the tank hits zero, processing pauses. Refuel with the one-shot items in `Config.Fuel.items`, or with reusable `ml_fuel` jerrycans, which are kept and only emptied. The solar panel upgrade regenerates fuel passively.

**Can I disable fuel entirely?**

Set `Config.Features.fuelSystem = false`. The fuel bar is hidden and processing never needs fuel. Fixed stations with `infiniteFuel = true` always skip fuel as well.

**How do I accept ml_fuel jerrycans?**

Set `Config.Fuel.mlFuel.enabled = true` and list the fuel types you accept in `acceptedFuelTypes`. Any item carrying `metadata.fuelAmount` and `metadata.fuelType` is treated as a jerrycan. One liter becomes `litersToUnits` recycler units.

## Durability

**How does durability work?**

Each completed slot lowers durability by `Config.Durability.degradePerProcess`. Below the slowdown threshold the machine runs slower. Below the malfunction threshold it can jam. At the broken threshold it stops until repaired with an item from `Config.RepairItems`.

**Can I disable durability?**

Set `Config.Features.durabilitySystem = false`.

**Can one station be exempt from durability while the rest of the server keeps it?**

Yes. Add `infiniteDurability = true` to that entry in `Config.FixedStations`. That station never degrades, never jams and never asks for a repair item, and its durability bar is hidden. Every player-placed recycler keeps using the durability system as configured. Useful for a safezone or a job-owned machine.

## Upgrades

**How do upgrades work?**

Players install upgrades from inventory, up to `Config.MaxUpgradesPerRecycler` per machine. The item is consumed on install and returned on removal, and survives pickup and re-placement through item metadata. Four modules ship: turbo motor, extra tank, silencer kit, solar panel.

**Can I add a slot-expansion upgrade?**

Yes. Add an upgrade to `Config.Upgrades` with `effects = { slotBonus = N }` and give it an item. The machine unlocks `N` extra slots, capped at `Config.Recycler.maxSlots`. The `upgrade_slot_expansion` label already exists in the locale files.

**Do upgrades wear out?**

Not by default. Add a `wear` table to an upgrade definition to give it a durability curve that drains on use and auto-removes the module at zero.

## Zombies

**How does zombie noise work?**

With `Config.ZombieNoise.enabled = true` and the zombie resource running, a working machine attracts zombies within `defaultRadius`. The silencer kit upgrade shrinks that radius. The noise stops when processing stops.

## Updates

**How do I update the script?**

1. Download latest from CFX Portal
2. Backup `shared/config.lua` and `server/config_server.lua`
3. Replace all files except config
4. Apply any new config entries from the changelog to the saved config files.
5. Restart the resource

Recycler positions, slots, upgrades and durability live in the database and survive updates.

The depositor field for private loot collection is added automatically at resource start. Deposits without a recorded owner remain public.