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

RUST Extended Recycler Plugin

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:

CommandDescription
extendedrecycler.useAllows permitted players to use the craft command
extendedrecycler.unlimitedGrants unlimited crafting balance to group

Chat commands (prefaced with / ):

CommandDescription
/recycler.craftCraft recycler pending materials
/recycler.balanceDisplay current recyclers allowed to create / deploy

Console commands

CommandDescription
recycler.give‘name or steamID’ – give recycler to person
recycler.setbalance [player name or id] [#]Set # of recyclers each player may create
rec_wipeWipe current crafting balances to default value [2]

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.

Tempest Hosting
No Limit Llama's avatar

About No Limit Llama

An aspiring woodworker and web designer. Father, husband, and Rust veteran. Llama has written op-eds and official game documents for over two decades. The earliest writings were on Asheron’s Call, followed by World of Warcraft and eventually Rust. The vast majority of his indoor time is spent running Rust servers or helping friends with their Rust-related projects. He enjoys working around the house, continuing his education when time permits, and creating new processes to simplify activities of daily living for his friends and family. He has an incredible wife, a dog, three children, and one granddaughter.

View all posts by No Limit Llama →