Install Oxide/uMod on a Rust server
Drop Oxide into the root folder, place your plugins in /oxide/plugins and hot-reload them.
Install Oxide/uMod on a Rust server
uMod (formerly Oxide) is Rust’s modding layer. It lets you add plugins in C# without modifying the game. Installation is done by replacing certain server files.
Cause / The problem
Without uMod, the console doesn’t recognize any oxide.* commands and the /oxide/plugins folder doesn’t exist. The .cs plugins can’t be compiled or loaded.
Solution
- Download uMod for Rust from umod.org/games/rust. Pick the version matching your Rust version (check it in the server console).
- Stop the server from the Pelican panel.
- Extract the uMod archive and upload its contents to the server root (next to
RustDedicated.exe). The filesOxide.Rust.dll,Oxide.CSharp.dlland theOxide.Referencesfolder must overwrite the existing ones. - Start the server. On first launch, uMod automatically creates the
/oxide/folder with the/plugins,/config,/dataand/langsubfolders. - Verify the installation by typing in the console:
The response shows the uMod version (e.g.oxide.version2.0.4516). If the command is unknown, Oxide isn’t installed correctly. - Install a plugin:
- Download a
.csfile from umod.org. - Drop it into
/oxide/plugins/. - Hot-reload it without restarting:
oxide.reload PluginName oxide.reload * # reloads all plugins
- Download a
- Configure the plugin in
/oxide/config/PluginName.jsonafter its first load, then reload it.
After a Rust update, update uMod and your plugins: an outdated version causes compilation errors on startup.