Recycler

A plugin for Unturned that lets players recycle items into other items, inspired by Rust's recycling system.

Overview

This plugin allows server owners to configure any storage container to function as a recycler. Players can place items into these containers and receive specified output items in return after a configurable delay.

Configuration Options

Main Settings

• Debug: When set to true, displays detailed debug messages in the console
• Recyclers: List of storage items that will function as recyclers

Recycler Settings

Each recycler can be configured with the following options:

• Name: Display name of the recycler
• StorageId: Unturned item ID of the storage container to use as a recycler
• DelaySeconds: Time it takes to recycle an item
• EffectId: ID of the effect to play when recycling completes (set to 0 for no effect)
• EffectRadius: How far players can see the recycling effect
• Icon: URL to an image shown in chat messages
• Color: Hex color code for chat messages
• EnableChatMessage: Whether to send chat messages when recycling

Recipe Configuration

Each recycler contains a list of recipes with:

• InputItem: The item that players can recycle (ID, Name, Amount, Stackable)
• OutputItems: List of items given to players after recycling (ID, Name, Amount, Stackable)

The Stackable property should be set to true for items that can stack (like ammunition).

How It Works

1. Place a recycler storage barricade in your world
2. Players can put recyclable items into the recycler
3. After the configured delay, the input item is replaced with the output items
4. If output items don't fit in the container, they drop on the ground

Configuration

<RecyclerConfiguration>
  <Debug>false</Debug>
  <Recyclers>
    <Recycler Name="Maple Crate" StorageId="366">
      <DelaySeconds>2</DelaySeconds>
      <EffectId>27</EffectId>
      <EffectRadius>50</EffectRadius>
      <Icon>https://i.imgur.com/OtHjwXB.png</Icon>
      <Color>#4E943E</Color>
      <EnableChatMessage>true</EnableChatMessage>
      <Recipes>
        <Recipe>
          <InputItem Id="363" Name="Maplestrike" />
          <OutputItems>
            <OutputItem Id="67" Name="Metal Scrap" Amount="3" />
            <OutputItem Id="285" Name="Metal Bar" Amount="2" />
          </OutputItems>
        </Recipe>
        <!-- More recipes -->
      </Recipes>
    </Recycler>
  </Recyclers>
</RecyclerConfiguration>

Translations

<?xml version="1.0" encoding="utf-8"?>
<Translations xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Translation Id="recycled" Value="[[b]]{0}[[/b]] was recycled!" />
  <Translation Id="not_recyclable" Value="[[b]]{0}[[/b]] is not recyclable." />
  <Translation Id="recycle_cancelled" Value="Recycling of [[b]]{0}[[/b]] was cancelled." />
</Translations>

Credits

Thanks Gurk for the idea and testing the plugin!