How to install Oxide (uMod) or Carbon and add plugins to Rust
Plugins let you add features such as kits, teleport, clans and better chat to your Rust server. To use them you need a modding framework, usually Oxide (uMod) or Carbon.
Install the framework
Oxide and Carbon are installed on top of the Rust server files and must be updated after every Rust update. Many hosts, including us, can install this for you. Open a ticket on our Discord and tell us which one you want. If you install it yourself, follow the instructions on the official site and make sure you download the Linux version.
Add a plugin
- Download the plugin file, which ends in .cs, from uMod or the plugin author page.
- Open the Files tab and go to the plugins folder. For Oxide this is oxide/plugins, and for Carbon it is carbon/plugins.
- Upload the .cs file. The server normally loads it on its own.
- Watch the Console tab for a loaded message or an error.
Configure it
The first time a plugin runs it creates a config file, normally under oxide/config or carbon/configs. Edit the values, then reload the plugin from the Console, for example oxide.reload PluginName.
Handy commands
- oxide.plugins lists loaded plugins.
- oxide.reload PluginName reloads one plugin.
- oxide.grant user PlayerName permission.name gives a permission to a player.
- oxide.grant group default permission.name gives it to everybody.
Carbon has similar commands that start with c. rather than oxide. Check the Carbon docs for exact names.
Troubleshooting
- Plugin will not load: read the Console error. It is often a missing dependency or an outdated plugin.
- Everything broke after a Rust update: update the framework first and wait for plugin authors to update theirs.
- Config edits ignored: reload the plugin after saving.
- Use plugins only from trusted sources.