Rust: Oxide plugins on your server

1. On My Servers, open your Rust server's Detail view and expand the Mods card. The catalog is uMod, the same plugins you would download from umod.org.

2. Search for the plugin, check its box, and press Save changes in the popup at the bottom of the page.

3. The loader chip (Oxide plus its build number) appears in the Mods card header as soon as the save lands. Then restart your server: the restart is what loads the plugin.

Status icons, removing a plugin, and the rest of the check, save, restart flow are in Install mods on your server. A plugin that is not in the catalog yet can be requested from the same card: Request a mod. Catalog plugins keep the exact version you installed; request the newer version when you want it.

Plugins you wrote, bought from a marketplace, or got from somewhere other than uMod go in the folder Oxide reads from:

1. Make sure the loader is on. With no catalog plugins installed, expand your server's Overview card, open the Basic tab, switch Mod Loader from None (Vanilla) to Oxide, save, and restart once. While plugins are installed the picker is locked ("Locked by installed mods. Remove all mods to change."), which is normal.

2. Open the Files card and go to install/rust/oxide/plugins/.

3. Press Upload, choose Files, and pick the .cs file (or drag the file straight onto the card). One file per plugin, directly in that folder, not in a subfolder: Oxide only loads .cs files sitting at the top of oxide/plugins/.

4. Restart your server.

Over SFTP the path is the same: /install/rust/oxide/plugins/. If a paid plugin ships extra files, its instructions say where they belong.

Files you upload here are yours: restarts and catalog installs leave them alone. Unchecking a catalog plugin in the Mods card removes only that plugin's file, and only on the next server start; deleting your own .cs file in the Files card takes it off disk right away. A plugin is code running on your server, so only install plugins from sources you trust.

Most plugins create their settings file the first time they run, so restart once after installing before you go looking for it. Oxide keeps its own folders next to your plugins: open install/rust/oxide/ in the Files card.

• Settings: config/<PluginName>.json, one file per plugin. Open it, edit, and press Save. Every save keeps the previous version in the file's History, so a broken edit is a two-click undo (Edit config files).

• Data (what the plugin has recorded, like kits or player stats): data/. Usually nothing to edit; useful when a plugin's instructions tell you to reset its data.

A settings change applies when the plugin reloads: run oxide.reload <PluginName> in your server's Console (Use the server console), or restart the server.

Wipes delete world and player files only, so your plugins, their settings, their data, and the loader all stay put and load again on the first start after the wipe (Rust: wipes, maps, and seeds). If a plugin keeps per-wipe data (kits claimed, zones placed), resetting that on a new map is the plugin's job; most do it, and the ones that do not say so in their instructions.

• Carbon, or your own Oxide build. Oxide is the only loader on Haptic, and Haptic installs and manages it for you. There is nothing to download or upload for the loader itself.

• Editing server.cfg to load plugins. Plugins are picked up from the folder; no config line is needed.

• Asking players to install anything. There is no client side to an Oxide plugin. If a player cannot join, the cause is elsewhere: I can't connect to my server.

Reach us on Discord or at support@haptic.gg. Include your server name, the plugin's name, and a screenshot of the red triangle tooltip in the Mods card or the console lines that mention the plugin.