Skip to content

How to Install uMod on Your Rust Server

uMod (formerly Oxide) is the most widely used modding framework for Rust and provides access to thousands of plugins. On EmeraldHost you can enable uMod directly via the dashboard.

Warning

uMod does not work on the staging branch. If uMod is enabled anyway, client connections will fail with the following error:

Disconnected: Connection Attempt Failed
Disconnected: Connection Attempt Failed

Switch the branch before installation as described below.

  1. Open dashboard
    Open the dashboard of your server.

  2. Open settings
    Navigate to the Settings.

  3. Enable uMod
    Set the uMod field to enabled.

  4. Switch branch
    Change the Branch field from staging to workcart and save the settings.

  5. Reinstall the server
    Click the three dots in the top right and select Reinstall. Confirm the action so the server is set up again with the new branch and uMod.

    Warning

    Reinstalling resets all server files. Create a backup beforehand if you want to keep your current save.

  6. Start the server
    Start your server. uMod will be loaded automatically.

Adding plugins

After installing uMod, you can place plugins in the /oxide/plugins/ folder. uMod automatically detects new .cs files and hot-reloads them while the server is running.

You can find plugins here, among others:

Tip

After every Rust update, check whether your plugins are still compatible. Many plugins need to be updated after major game updates.