[{"data":1,"prerenderedAt":32},["ShallowReactive",2],{"doc-en-install-oxide-carbon-plugins-rust":3},{"path":4,"slug":5,"title":6,"description":7,"category":8,"subcategory":9,"icon":10,"date":11,"author":12,"order":13,"image":14,"tags":15,"keywords":21,"docGroup":29,"docGroupIcon":29,"link_fr":30,"bodyHtml":31},"\u002Fdocs\u002Fen\u002Fgaming\u002Frust\u002Finstall-oxide-carbon-plugins-rust","install-oxide-carbon-plugins-rust","How to Install Oxide or Carbon and Plugins on a Rust Server","Enable Oxide (uMod) or Carbon on your Winheberg Rust server from the Startup tab, install a plugin from uMod with Upload from URL and manage its permissions.","jeux","rust","tabler:file-text","2026-11-01","Winheberg",114,"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Frust\u002Finstall-oxide-carbon-plugins-rust.webp",[16,17,18,19,20],"Rust","Oxide","Carbon","Plugins","Game panel",[22,23,24,25,26,27,28],"rust server oxide","install rust plugin","umod rust","carbon rust","rust server plugin","rust hosting","rust modding","","\u002Fdocs\u002Frust\u002Finstaller-oxide-carbon-plugins-rust","\u003Ch2>Context\u003C\u002Fh2>\n\u003Cp>A vanilla Rust server runs perfectly well as it is, but most communities want starter kits, teleportation, clans or a shop. All of this comes from \u003Cstrong>plugins\u003C\u002Fstrong>, and plugins need a \u003Cstrong>modding framework\u003C\u002Fstrong>, Oxide (uMod) or Carbon.\u003C\u002Fp>\n\u003Cp>On your Winheberg Rust server, there is no need to install this framework by hand. The gaming panel downloads it for you at startup, you just have to pick it. This guide shows you how to enable Oxide or Carbon, install a plugin from uMod, then check that it is running.\u003C\u002Fp>\n\u003Ch2>Prerequisites\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>An active \u003Cstrong>Rust server\u003C\u002Fstrong> on your \u003Ca href=\"https:\u002F\u002Fpanel.winheberg.com\">Winheberg gaming panel\u003C\u002Fa>\u003C\u002Fli>\n\u003Cli>The download link of the plugin you want, for example on \u003Ca href=\"https:\u002F\u002Fumod.org\u002Fplugins\">umod.org\u003C\u002Fa>\u003C\u002Fli>\n\u003Cli>A recent \u003Cstrong>backup\u003C\u002Fstrong> from the \u003Cstrong>Backups\u003C\u002Fstrong> tab, before any framework change\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>1. Choose the framework in Startup\u003C\u002Fh2>\n\u003Cp>In the side menu, open \u003Cstrong>Startup\u003C\u002Fstrong> and scroll down to the \u003Cstrong>MODDING FRAMEWORK\u003C\u002Fstrong> variable. Three values are available.\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Value\u003C\u002Fth>\n\u003Cth>Result\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>vanilla\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Server without mods, default value\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>oxide\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Installs Oxide (uMod), the original Rust framework\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>carbon\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Installs Carbon, compatible with most Oxide plugins\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>Select \u003Ccode>oxide\u003C\u002Fcode> or \u003Ccode>carbon\u003C\u002Fcode>. The choice is saved as soon as you change the value, there is no save button.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Frust\u002Finstall-oxide-carbon-plugins-rust-1793567287005-b09a0b819654a1242b052bd9.webp\" alt=\"MODDING FRAMEWORK variable set to oxide in the panel Startup tab\" width=\"600\" \u002F>\n\n\u003Cdiv class=\"markdown-alert markdown-alert-important\">\u003Cspan class=\"alert-icon\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\u003Cpath d=\"M12 22c5.523 0 10-4.477 10-10S17.523 2 12 2 2 6.477 2 12s4.477 10 10 10z\"\u002F>\u003Cpath d=\"M12 8v4\"\u002F>\u003Cpath d=\"M12 16h.01\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>Oxide and Carbon \u003Cstrong>cannot run side by side\u003C\u002Fstrong>. Pick only one. Plugins are written the same way for both, but Carbon stores its files in a \u003Ccode>carbon\u003C\u002Fcode> folder instead of \u003Ccode>oxide\u003C\u002Fcode>.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>2. Restart and check that it loads\u003C\u002Fh2>\n\u003Cp>Go back to the \u003Cstrong>Console\u003C\u002Fstrong> and click \u003Cstrong>Restart\u003C\u002Fstrong>. On every startup, the server updates Rust and then downloads the latest version of the chosen framework. So you never have to update Oxide yourself.\u003C\u002Fp>\n\u003Cp>The first startup with a framework takes a few extra minutes. When Oxide loads, the console shows these lines.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-bash\">Loading Oxide Core v2.0.4143...\nLoading extensions...\nLoaded extension Rust v2.0.7839 by Oxide Team and Contributors\nLoading plugins...\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Frust\u002Finstall-oxide-carbon-plugins-rust-1793567632645-78e5c23cee57118800476f5c.webp\" alt=\"Oxide Core and its extensions loading in the Rust server console\" width=\"800\" \u002F>\n\n\u003Cp>Version numbers change with every update, that is normal. Once the server has started, an \u003Ccode>oxide\u003C\u002Fcode> folder appears at the root of the server, with the \u003Ccode>plugins\u003C\u002Fcode>, \u003Ccode>config\u003C\u002Fcode>, \u003Ccode>data\u003C\u002Fcode>, \u003Ccode>lang\u003C\u002Fcode> and \u003Ccode>logs\u003C\u002Fcode> subfolders.\u003C\u002Fp>\n\u003Ch2>3. Install a plugin from a URL\u003C\u002Fh2>\n\u003Cp>An Oxide plugin is a simple \u003Ccode>.cs\u003C\u002Fcode> file. The panel file manager can download it directly, without going through your PC.\u003C\u002Fp>\n\u003Col>\n\u003Cli>Open \u003Cstrong>Files\u003C\u002Fstrong>, then the \u003Ccode>oxide\u003C\u002Fcode> folder, then \u003Ccode>plugins\u003C\u002Fcode> (with Carbon, \u003Ccode>carbon\u003C\u002Fcode> then \u003Ccode>plugins\u003C\u002Fcode>)\u003C\u002Fli>\n\u003Cli>Click \u003Cstrong>Upload\u003C\u002Fstrong>, then \u003Cstrong>Upload from URL\u003C\u002Fstrong>\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Frust\u002Finstall-oxide-carbon-plugins-rust-1793567406225-62cfedb5dc1e8c2510e575a8.webp\" alt=\"File manager Upload menu with the Upload from URL option\" width=\"600\" \u002F>\n\n\u003Col start=\"3\">\n\u003Cli>Paste the direct link to the \u003Ccode>.cs\u003C\u002Fcode> file into the \u003Cstrong>URL\u003C\u002Fstrong> field. On uMod, it looks like \u003Ccode>https:\u002F\u002Fumod.org\u002Fplugins\u002FPluginName.cs\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>Check the \u003Cstrong>Filename\u003C\u002Fstrong> field. It fills itself in from the URL and must contain only the file name, here \u003Ccode>Kits.cs\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>Click \u003Cstrong>Upload\u003C\u002Fstrong>\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Frust\u002Finstall-oxide-carbon-plugins-rust-1793567527206-627466f8e2248d8de4689a57.webp\" alt=\"Upload from URL window with the Kits plugin link and the Kits.cs file name\" width=\"600\" \u002F>\n\n\u003Cp>The file shows up in the folder a few seconds later.\u003C\u002Fp>\n\u003Cimg src=\"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Frust\u002Finstall-oxide-carbon-plugins-rust-1793567527808-c274f5ac43c34b47edb0dabb.webp\" alt=\"The Kits.cs file in the oxide\u002Fplugins folder\" width=\"600\" \u002F>\n\n\u003Cdiv class=\"markdown-alert markdown-alert-tip\">\u003Cspan class=\"alert-icon\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\u003Ccircle cx=\"12\" cy=\"12\" r=\"10\"\u002F>\u003Cpath d=\"M12 16v-4\"\u002F>\u003Cpath d=\"M12 8h.01\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>Downloaded the plugin to your PC? Use \u003Cstrong>Upload Files\u003C\u002Fstrong> instead, or SFTP for large files, as explained in our guide \u003Ca href=\"https:\u002F\u002Fwinheberg.com\u002Fen\u002Fdocs\u002Fpanel-gaming\u002Fsftp-gaming-server\">How to Connect to Your Gaming Server via SFTP\u003C\u002Fa>.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>4. Check that the plugin is loaded\u003C\u002Fh2>\n\u003Cp>Oxide watches the \u003Ccode>plugins\u003C\u002Fcode> folder and \u003Cstrong>automatically loads\u003C\u002Fstrong> a plugin as soon as its file is added or modified, with no restart. On first load, the plugin creates its configuration file in \u003Ccode>oxide\u002Fconfig\u003C\u002Fcode> (with Carbon, \u003Ccode>carbon\u002Fconfigs\u003C\u002Fcode>).\u003C\u002Fp>\n\u003Cp>To list the active plugins, type this command in the console, \u003Cstrong>without a \u003Ccode>\u002F\u003C\u002Fcode> in front\u003C\u002Fstrong>.\u003C\u002Fp>\n\u003Cpre>\u003Ccode class=\"language-bash\">o.plugins\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cp>Here are the handy commands for managing your plugins.\u003C\u002Fp>\n\u003Cdiv class=\"md-table md-table--info md-table--striped\">\u003Cdiv class=\"md-table__caption\">Plugin management commands\u003C\u002Fdiv>\u003Cdiv class=\"md-table__scroll\">\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Oxide\u003C\u002Fth>\n\u003Cth>Carbon\u003C\u002Fth>\n\u003Cth>Purpose\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>o.plugins\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>c.plugins\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Lists loaded plugins\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>o.reload Kits\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>c.reload Kits\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Reloads a plugin, for example after changing its configuration\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>o.unload Kits\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>c.unload Kits\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Unloads a plugin without deleting its file\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>o.load Kits\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>\u003Ccode>c.load Kits\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Loads an unloaded plugin\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Cdiv class=\"markdown-alert markdown-alert-note\">\u003Cspan class=\"alert-icon\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\u003Ccircle cx=\"12\" cy=\"12\" r=\"10\"\u002F>\u003Cline x1=\"12\" y1=\"16\" x2=\"12\" y2=\"12\"\u002F>\u003Cline x1=\"12\" y1=\"8\" x2=\"12.01\" y2=\"8\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>The panel console sends commands to the server over RCON. During startup, it replies \u003Ccode>Unable to run "o.plugins" due to RCON not being connected yet.\u003C\u002Fcode> Wait for the server status to switch to \u003Cstrong>Online\u003C\u002Fstrong> and try again. If the message persists after startup, replace the default \u003Ccode>CHANGEME\u003C\u002Fcode> password in the \u003Cstrong>RCON PASSWORD\u003C\u002Fstrong> variable in \u003Cstrong>Startup\u003C\u002Fstrong>, then restart.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>5. Grant the plugin permissions\u003C\u002Fh2>\n\u003Cp>Most plugins restrict their commands to players who have the right \u003Cstrong>permission\u003C\u002Fstrong>. The plugin page on uMod lists its permissions. Oxide creates two groups by default, \u003Ccode>default\u003C\u002Fcode> for all players and \u003Ccode>admin\u003C\u002Fcode> for administrators.\u003C\u002Fp>\n\u003Ctable>\n\u003Cthead>\n\u003Ctr>\n\u003Cth>Command\u003C\u002Fth>\n\u003Cth>Effect\u003C\u002Fth>\n\u003C\u002Ftr>\n\u003C\u002Fthead>\n\u003Ctbody>\u003Ctr>\n\u003Ctd>\u003Ccode>o.grant group default <permission>\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Grants the permission to all players\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>o.grant user <name or SteamID64> <permission>\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Grants the permission to a single player\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>o.revoke user <name or SteamID64> <permission>\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Removes the permission\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003Ctr>\n\u003Ctd>\u003Ccode>o.show user <name>\u003C\u002Fcode>\u003C\u002Ftd>\n\u003Ctd>Shows a player's permissions and groups\u003C\u002Ftd>\n\u003C\u002Ftr>\n\u003C\u002Ftbody>\u003C\u002Ftable>\n\u003Cp>With Carbon, replace \u003Ccode>o.\u003C\u002Fcode> with \u003Ccode>c.\u003C\u002Fcode>, for example \u003Ccode>c.grant\u003C\u002Fcode>. Players set as \u003Cstrong>owner\u003C\u002Fstrong> on the server are automatically added to the Oxide \u003Ccode>admin\u003C\u002Fcode> group. To become an owner, follow our guide \u003Cstrong>"How to Become an Admin on a Rust Server"\u003C\u002Fstrong>.\u003C\u002Fp>\n\u003Ch2>If you run into trouble\u003C\u002Fh2>\n\u003Ch3>❌ The plugin does not show up in o.plugins\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>Check that the file is really in \u003Ccode>oxide\u002Fplugins\u003C\u002Fcode> (or \u003Ccode>carbon\u002Fplugins\u003C\u002Fcode>) and that it ends with \u003Ccode>.cs\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>Check its name. If the console shows an error like this one, the \u003Cstrong>Filename\u003C\u002Fstrong> field contained the name twice, rename the file to \u003Ccode>Kits.cs\u003C\u002Fcode>\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Cpre>\u003Ccode class=\"language-bash\">Could not load plugin 'Kits.csKits' (no plugin found with that file name)\n\u003C\u002Fcode>\u003C\u002Fpre>\n\u003Cul>\n\u003Cli>Open the latest file in \u003Ccode>oxide\u002Flogs\u003C\u002Fcode>, plugin compilation errors are detailed there\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ A plugin stopped working after the monthly wipe\u003C\u002Fh3>\n\u003Cp>Every mandatory Rust update can break a plugin. The framework itself updates on its own at restart. Check the plugin page for a new version, download it over the old one, then read the console to confirm it loads.\u003C\u002Fp>\n\u003Ch3>❌ The server crashes after a framework change\u003C\u002Fh3>\n\u003Cp>Oxide modifies some game files, which stay in place if you switch back to \u003Ccode>vanilla\u003C\u002Fcode> or move to \u003Ccode>carbon\u003C\u002Fcode>. Make a backup, then run \u003Cstrong>Reinstall Server\u003C\u002Fstrong> from \u003Cstrong>Settings\u003C\u002Fstrong> so that SteamCMD restores the original Rust files.\u003C\u002Fp>\n\u003Ch2>Best practices\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>\u003Cstrong>Add your plugins one at a time\u003C\u002Fstrong> and read the console after each one, any conflict is then easy to spot\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Edit a plugin's configuration\u003C\u002Fstrong> in \u003Ccode>oxide\u002Fconfig\u003C\u002Fcode>, then apply it with \u003Ccode>o.reload PluginName\u003C\u002Fcode>\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Only download plugins from known sources\u003C\u002Fstrong> such as uMod. A \u003Ccode>.cs\u003C\u002Fcode> plugin runs code on your server\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Back up the \u003Ccode>oxide\u003C\u002Fcode> folder\u003C\u002Fstrong> before a wipe or a major update, it holds your configurations and your players' data\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>Need help?\u003C\u002Fh2>\n\u003Cp>If a plugin still refuses to load after these checks, our team is here to help. Open a ticket in the \u003Cstrong>Technical\u003C\u002Fstrong> department from your \u003Ca href=\"https:\u002F\u002Fbilling.winheberg.com\">client area\u003C\u002Fa>, fill in the \u003Cstrong>Related Product\u003C\u002Fstrong> field with your Rust server and attach the error message from the console.\u003C\u002Fp>\n\u003Cp>Check out our plans on the \u003Ca href=\"https:\u002F\u002Fwinheberg.com\u002Fen\u002Fgaming\u002Frust\">Rust Hosting\u003C\u002Fa> page. Your server is ready for its first plugins 📦\u003C\u002Fp>\n",1794353875361]