RUST BGrade Plugin (How to Install, Configure & Use)

What is the BGrade plugin?

BGrade (BG) is a RUST plugin that allows players with adequate permissions to automatically have any placed building structures, such as foundations, walls, and more, upgraded to their preferred material type. This plugin removes the need for players to take additional resources and steps to upgrade their buildings. It is patched and supported by Ryan. It is a free-to-use plugin available for download on uMod and a favorite amongst the RUST-modded community, particularly on build and creative servers.

Note: This mod will require the server status to be designated as Modded in the server listing. For more information on this, check out the Developers Guide on plugin use for RUST servers.

Potential reasons to use the BGrade plugin

The BGrade plugin, for all intents and purposes, drastically changes the building dynamics in RUST. People with adequate permissions may upgrade their buildable structures (with or without resource consumption) with a simple chat command for those servers with the plugin enabled. Using this plugin can save players significant time when practicing their base building.

Additional features (permissions pending) include;

• Capacity for builders to create blocking at a designated grade level without needing to upgrade from twig
• Bind instant upgrading to a key such as:  bind 0 bgrade.up

Installing the BGrade 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 BGrade page, or download the CS file directly.
3. Locate the downloaded BGrade.cs file and install the plugin on your RUST server, or follow your host-specific instructions.
4. Once you’ve installed BGrade in the plugins folder, and if the server is actively running, uMod will immediately create an alternate BGrade.json file in your config folder. You will make all configuration changes to the .json file in the config folder.

Permissions

As with all uMod plugins, they will each have a small list of plugin-specific permissions. Make sure you reference our uMod Permissions Guide to better understand the oxide.grant permission system. Specific permission command lines for BGrade include:

Activation steps

Once installed and permitted to use the mod, players with permission may use their designated bind (when applicable) to upgrade structures or enable building at a particular grade via the following chat commands:

Recommended plugin configurations

By default, the configuration of the BGrade.json file should be adequate for most server owners’ purposes. This RUST BGrade plugin guide will go through the configuration file line by line as it pertains to the most commonly changed settings to better understand potential option changes. Below is an example configuration file for BGrade. It has been altered to better explain the impact of settings changes – DO NOT copy and paste this example into your configuration.

{
  "Building Attack Settings": {
    "Cooldown Time": 30, - Cooldown Timer is adjustable, in seconds
    "Enabled": true -  May be toggled false to disable attack timer
  },
  "Command Settings": { - Chat commands may be altered to anything
    "Chat Commands": [
      "bgrade",
      "grade"
    ],
    "Console Commands": [ - Console commands may be altered to anything
      "bgrade.up"
    ]
  },
  "Refund Settings": { - Allows for material refund from prior block material to new material
    "Refund on Block": true
  },
  "Timer Settings": {
    "Default Timer": 30,
    "Enabled": true,
    "Max Timer": 180
  }
}

How to update the BGrade plugin

Updating the BGgrade plugin is simple and quick:

1. Visit the uMod BGrade plugin page
2. Download the latest version of the BGrade plugin
3. Overwrite the existing BGrade.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 BGrade plugin

As the BGrade 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 BGrade.cs file
4. Open the Oxide config folder in your server directory
5. Locate and delete the BGrade.json configuration file
6. Restart the RUST server

Suppose you want to disable the BGrade plugin for a short period. You can use the oxide.unload BGrade 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 BGrade 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.