> For the complete documentation index, see [llms.txt](https://kevingirardx.gitbook.io/scripts/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kevingirardx.gitbook.io/scripts/recyclers-pro/upgrades.md).

# Upgrades

Recycler Upgrades allow players to improve their personal recycler over time. Instead of receiving every feature immediately, players can collect materials and rare industrial components to unlock additional functionality.

Installed upgrades are associated with the player's recycler and persisted in the database.

{% hint style="warning" %}
**Note:** Upgrades are designed for player-owned recyclers. Public/default recyclers cannot be upgraded.
{% endhint %}

Kevin Recyclers currently includes three main upgrades:

**Generator → Storage Expansion → Auto Loader**

The Generator and Storage Expansion provide the foundation for the recycler's advanced functionality, while the Auto Loader requires both upgrades before it can be installed.

This creates a progression path where players must gather increasingly valuable salvage components to fully upgrade their recycler.

***

## Generator

The **Generator** provides power to the recycler and acts as one of the core upgrades required for advanced progression.

#### Features

* Adds a physical generator prop to the recycler
* Configurable prop model and positioning
* Configurable installation cost
* Configurable material requirements
* Used as a prerequisite for advanced upgrades
* Saved to the recycler after installation

## Storage Expansion

The **Storage Expansion** adds additional storage capacity to the recycler.

Once installed, players gain access to a dedicated **Recycler Storage** inventory.

#### Features

* Adds a physical storage crate
* Unlocks a separate storage inventory
* Configurable inventory slots
* Configurable inventory weight
* Configurable prop and positioning
* Configurable money and material requirements
* Used by the Auto Loader
* Saved after installation

## Auto Loader

The **Auto Loader** is the recycler's automation upgrade.

Once installed, the recycler can automatically search its storage inventory for recyclable items, transfer supported items into the recycler, and begin another processing cycle.

This allows players to progress from manually operating their recycler to running an automated recycling setup.

#### Features

* Automatically checks Recycler Storage
* Detects items with valid recycling recipes
* Moves recyclable items into the input inventory
* Automatically starts the recycler
* Configurable check interval
* Configurable load amount
* Ignores unsupported items
* Requires previous upgrades
* Automatically continues processing available recyclable items

The server validates the selected storage item before moving it into the recycler. If the recycling cycle cannot be started, the item is returned instead of being lost.

## Auto Loader Requirements

The Auto Loader requires both:

**Generator**\
**Storage Expansion**

These upgrades must already be installed before the Auto Loader can be purchased.

This makes the Auto Loader the final major upgrade in the default progression.