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

# Recycle

## World/native item recycling

`bs_recycle` is a highly configurable recycling script allowing you to add a unique feature to your server

***

### Features

* **Recycling Locations**
  * Decide on one or more locations for the recycler prop to spawn
* **World Item Categories**
  * With all the rich item props around the map, you can decide which cans, barrels, tires, etc., correlate to a given category e.g. tires
* **Item Outputs**
  * Configure, for each item category, which items a player will receive when recycling
  * Decide how much, with a minimum and maximum of each item a player will receive
* **Other Item Recycling**
  * If you want to configure other items to be recycled, that are not natively spawned props, you can add those to the configuration
* **Business visibility**
  * Transaction history for purchases and sales.
  * Management dashboard for sales, profitability, and top performers.

***

### Requirements & Dependencies

#### Framework

* **Qbox, QBCore, ESX Legacy, or ox\_core**

#### Required resources

* `ox_lib`
* `ox_inventory`
* `ox_target`
* [BzZz\_recycler](https://bzzz.tebex.io/package/5372116)
* (Optional) [interact-sound](https://github.com/plunkettscott/interact-sound)

***

### Install

{% stepper %}
{% step %}

### Drop in the resource

Place the `bs_recycle` folder in your server’s resources.

Keep the folder name as `bs_recycle`.
{% endstep %}

{% step %}

### Ensure dependencies

Ensure these start before `bs_recycle`:

* `ox_lib`
* `ox_inventory`
* `ox_target`
* `bzzz_recycler`
* `interact-sound`
  {% endstep %}

{% step %}

### Start the script

Add to `server.cfg`:

```cfg
ensure bs_recycle
```

{% endstep %}
{% endstepper %}

***