How to Install uMod (Oxide) on a Hurtworld Server

To install uMod on a Hurtworld server, stop the server, download the Hurtworld build from the uMod website, extract the zip into the server's root folder so it overwrites the existing files, and start the server again. A new oxide folder appears. Plugins are .cs files you upload to oxide/plugins, and the server compiles and loads them on its own. uMod is the same framework that used to be called Oxide, which is why every path and command still says "oxide".

uMod is the reason Hurtworld servers still feel different from each other. The base game has few server options, so teleports, kits, stack sizes and vehicle rules all come from plugins.

Before you start

• Take a backup. uMod patches the game's own files. It cannot be cleanly removed except by reinstalling the server files, so you want a copy of the world first.
• Match the server's platform. uMod offers builds per platform. A Linux server needs the Linux build, a Windows server the Windows one. The wrong one starts without uMod or not at all.
• Download only from umod.org. Mirrors and old Oxide archives are often out of date and break on the current game build.

Step 1: Install the framework

1. Stop the Hurtworld server.
2. Download the Hurtworld build from the uMod site.
3. Extract the zip on your PC. Its folders mirror the server install, including the game's Hurtworld_Data folder.
4. Upload everything to the server's root folder, allowing it to overwrite existing files. Do not put it in a subfolder.
5. Start the server.

Step 2: Check that it loaded

Watch the console while the server starts. uMod logs its version and lists each plugin it loads. In the server folder you should now have:

If the oxide folder is not there after a restart, the files went to the wrong place. The most common mistake is uploading the zip's top folder instead of its contents.

Step 3: Add plugins

1. Find the plugin on the Hurtworld section of uMod and download the .cs file.
2. Upload it to oxide/plugins.
3. Watch the console. uMod notices new files and compiles them without a restart. You will see a "loaded plugin" line, or a compile error with a line number.
4. Edit the plugin's settings in oxide/config/PluginName.json, then run oxide.reload PluginName to apply them.

Popular picks for Hurtworld are teleport plugins, stack size changes, vehicle managers and admin map tools. Read each plugin's page for its commands and permissions.

Step 4: Grant permissions

Most plugins do nothing for players until you grant a permission. uMod has two built in groups: default (every player) and admin. Run these in the server console:

oxide.grant group default teleportation.use
oxide.grant user 76561198000000000 vehiclemanager.admin
oxide.group add vip
oxide.usergroup add 76561198000000000 vip
oxide.grant group vip kits.vip

The permission names come from each plugin's page. A typo is silently accepted and does nothing, so copy them exactly or check oxide.show perms.

Admin rights in the game itself (from addadmin or the owner SteamID) are separate from uMod groups. Some plugins check one, some the other, so set both up for your staff.

After a Hurtworld update

Because uMod patches game files, a game update replaces those files and uMod stops loading. Plugins then silently do nothing, which players notice before you do. The fix:

1. Check uMod for a build that matches the new game version.
2. Stop the server and upload the new build over the files, exactly like the first install.
3. Start it and check the console for the uMod version line.

If the game updates often enough to be annoying, consider updating on your own schedule: let the game update, then install uMod straight after, before players log in. Since Hurtworld updates are rare these days, this mostly matters after a reinstall.

Common problems

uMod on a hosted server

On a GamezServers Hurtworld server you do the same steps through the file manager or SFTP: upload the uMod files to the root, drop plugins into oxide/plugins, and run oxide.grant in the live console. One click backups before installing make the "it cannot be uninstalled" warning a non issue. The panel's Server Owner Guid field gives you in game owner rights from the first boot. New to running Hurtworld? Start with our Hurtworld server setup guide, and see our general modded server guide for how plugin frameworks work across games.

FAQ

Is uMod the same as Oxide?

Yes. Oxide was renamed uMod. The folders and console commands still use the oxide name.

Where do Hurtworld plugins go?

In oxide/plugins inside the server folder. Their configs appear in oxide/config after the first load.

Do players need to install anything?

No. uMod and its plugins run only on the server. Players join with the normal game.

Why did my plugins stop working?

Usually a game update replaced uMod's patched files. Upload the latest uMod build for Hurtworld again and restart.