NEW 📢 Black Friday: our launch offer ends 30 Nov. Up to 70% off your first month on every game!See plans
Black FridayUp to 70% off your first month, ends 30 NovEnds in 9d 04h 15mBlack FridayUp to 70% off your first month, ends 30 NovEnds in 9d 04h 15mBlack FridayUp to 70% off your first month, ends 30 NovEnds in 9d 04h 15m

How to add mods to your Rust server

RustUpdated Oct 23, 20264 min read

Rust server mods are plugins, .cs files that run on a modding framework. PlayNHost offers two: Oxide (the uMod framework) and Carbon, a drop-in replacement that runs Oxide plugins. Open the Modding tab, choose one, restart, then install plugins from the catalogue on the same page.

Back up first. See How to back up and restore your Rust world.

Add a mod

  1. Open your server in the panel and click the Modding tab.
  2. In the Oxide (uMod) and Carbon card, set Modding Framework to Oxide or Carbon. Pick one: they cannot run together. Vanilla runs no framework.
The Oxide and Carbon card on the Modding tab
  1. Click Restart to apply in the Saved, and not applied yet box. The framework is fetched again at every start.
  2. Under the card, on the Plugins tab, click Browse, choose uMod or Codefling under Source, search for a plugin and click Install. Free Codefling plugins that come as one .cs file install from the panel; paid ones you buy on Codefling and upload yourself.
The Plugins tab with the Browse list
  1. Check it loaded: How to install and update plugins on your Rust server shows how.

On Vanilla the panel refuses to install a plugin and says Plugins need Oxide or Carbon. A plugin that sits on disk with no framework does nothing.

Oxide or Carbon

  • Oxide is the long-standing framework with the largest plugin ecosystem, from uMod.
  • Carbon is built as a drop-in replacement: the folders and plugins are the same, and it only turns on the hooks that loaded plugins need. Some very specific plugins can behave differently, so check a plugin's page.
  • Pick one framework only. To change later, see How to switch your Rust server between Oxide and Carbon.

Plugin files

Open Files. Oxide uses oxide/plugins for plugins, oxide/config for their settings, oxide/data for their data and oxide/logs for logs. Carbon keeps the same kind of folders under carbon: carbon/plugins for plugins and carbon/configs for their settings. A plugin put in oxide/plugins on a Carbon server never loads.

You can also upload a plugin .cs file by hand into the right plugins folder in Files. Oxide and Carbon load a new or changed plugin file by themselves, so you do not normally need to restart.

Give permissions to a plugin

Most plugins use permissions. Type these in the Console tab. Oxide uses the prefix oxide.:

  • oxide.grant user <name or SteamID> <permission>
  • oxide.group add <group>
  • oxide.usergroup add <user> <group>

Carbon uses the prefix c. instead, for example c.grant. More in How to change plugin settings and permissions on your Rust server.

Check it worked

Open the Console. Problems show under Errors and Warnings. Type oxide.plugins (Carbon: c.plugins) to list the plugins that are loaded. On the Installed list, a plugin that did not start shows Not running: How to fix a plugin that is not running on your Rust server.

If the server stops after you add a plugin, remove the newest plugin or restore your backup. See How to fix a server that will not start.

Good to know

Already hosting it somewhere else? Move your server to us

OUR LATEST BLOGS