RUST Extended Recycler Plugin (How to Install, Configure & Use)

What is the Extended Recycler plugin?

Extended Recycler (ER) is a RUST plugin that allows players to create and deploy their own recyclers. It is patched and supported by TheFriendlyChap. It is a free-to-use plugin available for download on uMod and a favorite amongst the RUST modding community for use as a VIP feature.

Note: This mod will require server status to be changed from Community to Modded. For more information on this, check out the Facepunch’s guidelines on plugin use here.

Potential reasons to use the Extended Recycler plugin

While not usually used on traditional PVP servers, the PVE community adores the idea of having, using, and even sharing base-specific recyclers. They are a mainstay at roleplay farms, player-owned shops, and garages. On many RUST servers, deployable recyclers are used as a unique benefit to attract VIP customers.

How to install the Extended Recycler plugin

As with all uMod plugins, the server you intend to install them on requires uMod (Oxide) to be installed to facilitate their function. For a step-by-step perspective on how to install this plugin, please reference the following list:

1. First, you must have uMod/Oxide installed on your server. Use our Installing uMod (Oxide) on Your RUST server guide if you need help; otherwise, if you use a third-party hosting, their user interface will have instructions on how to get started. It may be tooled explicitly to their platform, so reach out to your host for details.
2. Acquire the latest version of the plugin from uMod’s Extended Recycler plugin page, or download the CS file directly.
3. Locate the downloaded ExtendedRecycler.cs file and install the plugin on your RUST server, or follow your host-specific instructions.
4. Once Extended Recycler is installed in the plugins folder, and if the server is actively running, uMod will immediately create an alternate ExtendedRecycler.json file in your config folder. It is essential to differentiate these files and not mistake them, as you must make configuration changes in the .json file in the config folder.  

Permissions

As with all plugins you might try to install, Extended Recycler has a small list of permissions. Make sure you reference our Oxide Permissions guide to understand the oxide.grant permission system better. Permissions bearing a warning indicate that adding this permission gives unilateral removal decision-making to any authorized group—exercise extreme caution. 

Specific permission command lines include:

Chat commands (prefaced with / ):

Console commands

Recommended plugin configurations

By default, the configuration of the ExtendedRecycler.json file should be adequate for most server owners’ purposes. To better understand potential option changes, this guide will go through the configuration file line by line as it pertains to the most commonly changed settings.

Below is an example configuration file for the Extended Recycler plugin. It has been altered slightly to better explain setting change impact – DO NOT copy and paste this example into your configuration.

Most toggles are fairly straightforward, and annotations are added to more complex settings.

{
  "1. Pickup settings: ": { - enable recyclers to be moved
    "1. Enabled for personal recyclers (placed by player)": false,
    "2. Check ability to build for pickup": true,
    "3. Only owner can pickup": false
  },
  "2. Craft settings: ": { - change recycler crafting cost
    "1. Enabled": true,
    "2. Cost (shortname - amount): ": {
      "scrap": 500,
      "metal.fragments": 5000,
      "metal.refined": 50,
      "gears": 10
    },
    "3. Default Balance per Player:": 2
  },
  "3. Destroy settings: ": { - determine what happens if recycler foundation removed
    "1. Check ground for recyclers (destroy on missing)": true,
    "2. Give item on destroy recycler": true,
    "3. Effects on destroy recycler": [
      "assets/bundled/prefabs/fx/item_break.prefab",
      "assets/bundled/prefabs/fx/impacts/stab/rock/stab_rock_01.prefab"
    ]
  }
}

How to update the Extended Recycler plugin 

Updating the RUST Extended Recycler plugin is simple and quick.

1. Visit the uMod Extended Recycler plugin page
2. Download the latest version of the Extended Recycler plugin
3. Overwrite the existing ExtendedRecycler.cs file in your Oxide plugins folder.

It is best practice not to uninstall the mod, as you do not need to alter the JSON file. It will remain with your existing settings (unless the developer otherwise suggests a complete reinstall).

How to remove the Extended Recycler plugin

As the Extended Recycler plugin does impact the player experience and game features, removing the plugin will take a few extra steps.

1. Prepare and properly shut down the RUST server
2. Open the Oxide plugins folder in your server directory
3. Locate and delete the ExtendedRecycler.cs file
4. Open the Oxide config folder in your server directory
5. Locate and delete the ExtendedRecycler.json configuration file
6. Restart the RUST server

Suppose you want to disable the Extended Recycler plugin for a short period. You can use the oxide.unload ExtendedRecycler command, which you may also run in the F1 console, RCON, or Web Console. 

Disclaimer and seeking assistance

Corrosion Hour does not maintain the RUST Extended Recycler plugin, nor do we assist with modifying the plugin outside the config scope. Visit the plugin’s uMod page directly to support the plugin creators, report bugs, or propose feature requests. Please get in touch with an admin in our Discord community for help with the steps and instructions in this guide.