RUST BGrade v1.1.6

This plugin can automatically upgrade building blocks upon placement. Allowing players to upgrade their building blocks with ease, preventing the needed use of the Hammer.

Permissions​

This plugin uses the permission system. To assign a permission, use oxide.grant <user or group> <name or steam id> <permission>. To remove a permission, use oxide.revoke <user or group> <name or steam id> <permission>.
This plugin has a set of modular permissions, allowing particular users (i.e VIPs) to upgrade to certain upgrade tiers, where others (i.e non-VIPs) cannot.

• bgrade.all -- Allows the granted user to use all grades possible.
• bgrade.nores -- Allows the user to not have to consume resources when their block is upgraded
• bgrade.1 -- Allows the user to automatically upgrade to grade 1
• bgrade.2 -- Allows the user to automatically upgrade to grade 2
• bgrade.3 -- Allows the user to automatically upgrade to grade 3
• bgrade.4 -- Allows the user to automatically upgrade to grade 4

Chat Commands​

The commands are completely dynamic to the user. So replace the /bgrade to whatever you change your commands to in your configuration file, if you decide to do so.

• /bgrade t <seconds> -- Change the players disable timer
• /bgrade 0 -- Disable BGrade
• /bgrade 1 -- Enable automatic Wood upgrades
• /bgrade 2 -- Enable automatic Stone upgrades
• /bgrade 3 -- Enable automatic Metal upgrades
• /bgrade 4 -- Enable automatic Armoured upgrades

Console Commands​

Again, these commands are completely reliant on your configuration values. So if you change them from default, change the usages here with your desired commands.

• bgrade.up -- Mainly added for binds so users can easily increment their BGrade level by pressing a key. Example of how to bind: bind u bgrade.up

Configuration​

The settings and options can be configured in the BGrade file under the config directory. The use of an editor and validator is recommended to avoid formatting issues and syntax errors.
I have used a fool-proof configuration helper in this plugin so it's pretty hard to break it. But if you do manage to break it, refer to this to restore your values the way you want them.

Localization​

The default messages are in the BGrade file under the lang/en directory. To add support for another language, create a new language folder (e.g. de for German) if not already created, copy the default language file to the new folder and then customize the messages.
The recent update will break existing plugins that use the API methods this plugin used to provide. Please get in touch with the plugins authors and tell them to read the section below.

API Methods (for developers)​

CanAutoGrade (deprecated)​

CanBGrade​

• Return -1 or 0 to block upgrade
• Return 1 to kill the building block and refund depending on config value

This plugin also hooks into OnStructureUpgrade, so you can also use this hook to change upgrade behaviour if you wish. Returning a non null value will prevent the upgrade.