Skip to content

RustSetup: Docs

Thank you so much for purchasing our item.

Version
1.8
Author
Tan
Created
01 March 2024
Last Update
16 February 2025
If you have any questions that are beyond the scope of this help file, please feel free to contact via the Support Page.

Installation

Important: the plugin AntiItems causes conflicts with other plugins. Please read carefully below.

Follow the steps below to setup your Rust server:

  1. First of all, make sure your server is running in Oxide mode.
  2. Unzip the downloaded package. Inside it, you will find several files and two folders:
    • Config Files — a folder that contains 3 other folders (config, data & lang)
    • Designs — a folder that contains the different designs used
    • Plugins.pdf — plugins list
    • README.pdf — docs link
  3. For each setup, we provide a list of used plugins that you must download. You will find it in your folder under the name "Plugins.pdf". Download all plugins from the list. (Rust plugins are .cs or .dll files)
  4. Once all the plugins have been downloaded, upload all the .cs files to the plugin folder rust/oxide/plugins in your FTP.
  5. Do the same with the .dll files in the following location: rust/HarmonyMods.
  6. Once the plugins have been uploaded, restart your server. (A complete reboot is necessary for the plugins to install.)
  7. Once the server has restarted, shut it down again.
  8. From your FTP, go to rust/oxide/config, delete all .json files. Replace them with the downloaded files from Config Files/config.
  9. Almost the same for rust/oxide/data: delete all .json files, delete oxide.groupe.data and all the folders. Replace them with the downloaded files from Config Files/data.
  10. And also for rust/oxide/lang: delete all the folders. Replace them with the downloaded files from Config Files/lang.
  11. Once all the files have been transferred, you can restart your server.

Your server is now operational with your desired configuration!

If you only want to add your server name, click here.

Fix AntiItem conflict

The AntiItems plugin may create conflicts with other plugins — in particular the "Kits" plugin. The creator of AntiItems has shared a fix for the "Kits" plugin that resolves the issue (original post):

You can download the modified/corrected version of the plugin by clicking here. (Last update: 16.02.25)

Or you can fix the plugin yourself by following the steps below:

  1. Download and open the Kits .cs plugin.
  2. From your code editor, search until you find this section (lines 2993-3002):
    internal bool HasSpaceForItems(BasePlayer player)
    {
        int wearSpacesFree = 8 - player.inventory.containerWear.itemList.Count;
        int mainSpacesFree = 24 - player.inventory.containerMain.itemList.Count;
        int beltSpacesFree = 6 - player.inventory.containerBelt.itemList.Count;
    
        return (wearSpacesFree >= WearItems.Length &&
                beltSpacesFree >= BeltItems.Length &&
                mainSpacesFree >= MainItems.Length) || ItemCount <= mainSpacesFree + beltSpacesFree;
    }
  3. And replace this entire section with the one below:
    internal bool HasSpaceForItems(BasePlayer player)
    {
       int wearSpacesFree = player.inventory.containerWear.capacity - player.inventory.containerWear.itemList.Count;
       int mainSpacesFree = player.inventory.containerMain.capacity - player.inventory.containerMain.itemList.Count;
       int beltSpacesFree = player.inventory.containerBelt.capacity - player.inventory.containerBelt.itemList.Count;
    
       return (wearSpacesFree >= WearItems.Length &&
       beltSpacesFree >= BeltItems.Length &&
       mainSpacesFree >= MainItems.Length) || ItemCount <= mainSpacesFree + beltSpacesFree;
    }
  4. Save, and place the file in your plugins folder.

How to update your setup

When you receive a product update notification on CodeFling, here's what you need to do to update your setup:

  1. The procedure for updating your setup is relatively similar to that of installation. However, there will be no need to download all the plugins again — only those that are new. For this, see the "Updates" section on the product page.
  2. (If there are any) place the new plugins in the folder rust/oxide/plugins
  3. Stop your server.
  4. Go to rust/oxide/config, delete all .json files. Replace them with the downloaded files from Config Files/config.
  5. Almost the same for rust/oxide/data: delete all .json files, delete oxide.groupe.data and all the folders. Replace them with the downloaded files from Config Files/data.
  6. And also for rust/oxide/lang: delete all the folders. Replace them with the downloaded files from Config Files/lang.
  7. Once all the files have been transferred, you can restart your server.

Your server is now updated!


Rust Server Structure

If you are new to Rust server management, here is a short explanation:

All of the files that we are going to modify are located in the rust/oxide folder.

Each plugin, once uploaded to the plugin folder, will create configuration files after restarting the server. You will find these configuration files in the following locations:

  • oxide/config: general configuration of the plugin
  • oxide/data: configuring plugin data
  • oxide/lang: configuration of texts and writings

To modify the display of your server (its name, banner, etc.), you will find a file called "server.cfg". This file may change location depending on your host — you can generally edit it from your hosting panel. If not, you might be able to find it here: rust/server/rust/cfg.

More information here
For simple management of your server, we recommend using the RustAdmin tool.
If you need more information, please visit the Facepunch wiki: wiki.facepunch.com

Main Plugins Description (Oxide)

Here is the list of main plugins which have configurations that you can modify as you wish:

Plugin NameConfig Files PathDescription
AutoBroadcastoxide/lang/en/AutoBroadcast.json
oxide/config/AutoBroadcast.json
Allows you to broadcast automatic messages in the chat.
AntiItemsoxide/config/AntiItems.jsonAllows you to put items in a player's ghost inventory. It is with this plugin that we can build "without resources". Pay attention: this plugin can easily conflict with other plugins (e.g. the Kits plugin).
BetterChatoxide/lang/en/BetterChat.json
oxide/config/BetterChat.json
Allows you to change the layout and permissions of the chat.
BetterLootoxide/data/BetterLoot/LootTables.jsonAllows you to modify the quantities of resources in loot boxes.
BGradeoxide/config/BGrade.jsonAllows you to build directly to a higher grade.
Clansoxide/config/Clans.jsonAllows you to configure the maximum number of players in a clan/group.
CraftingControlleroxide/config/CraftingController.jsonAllows you to modify the crafting time of items.
DeathNotesoxide/config/DeathNotes.jsonShow dead people in chat.
Economicsoxide/config/Economics.jsonCreate an economic system in the game.
GatherManageroxide/config/GatherManager.jsonAllows you to modify the amount of resource loot. This plugin is mainly configured from the console.
Kitsoxide/config/Kits.json
oxide/data/Kits/kits_data.json
Kit configuration files. The plugins can be configured directly in-game.
LoadingMessagesoxide/config/LoadingMessage.jsonChange messages displayed during server connection.
Loadoutlessoxide/config/Loadoutless.jsonAllows players to save their inventory.
NoEscapeoxide/config/NoEspace.jsonBlocks teleports and construction during fights or raids.
RemoveAnimalsAIDelete the .cs if you don't want it.Makes animals non-aggressive.
RustRewardsoxide/config/RustRewards.jsonAllows players to be rewarded with in-game currency for various actions.
SkinBoxoxide/config/SkinBox.jsonSkinBox settings. Here you must enter your Steam ID.
SpawnHelioxide/config/SpawnHeli.jsonAllows players to spawn, fetch and despawn personal helicopters.
StackSizeControlleroxide/config/StackSizeController.jsonAllows you to control the size of the stacks.
WelcomePaneloxide/config/WelcomePanel.jsonSettings file for the WelcomePanel. (Line 150 to modify the background)
WPKits, SocialLink, VIP & Wipeoxide/config/WPKits.json
oxide/config/WPSocialLinks.json
oxide/config/WPVIPRanks.json
oxide/config/WPWipeCycle.json
Settings for addons that you can add to your Welcome Panel. Consult the official plugin documentation for more information.
HarmonyMods Plugins (.dll files)
Permission GroupsConfig FilesDescription
Metabolismrust/HarmonyConfig/Metabolism.jsonAllows changing the players' spawning health, hydration and food value.
No Suicide CooldownNo configRemoves the delay after suiciding.
NoTemperatureDamageNo configDisables cold and heat damage.
NoBlueprintsNo configUnlocks all blueprints for each player when they join.
Obviously, almost all the plugins on your servers have configuration files. But many do not necessarily require editing.
For more information on plugin configurations and their permissions, go to the official plugin pages.

Permissions

How to put yourself admin

To give yourself admin permissions, type this command in your server console: oxide.usergroup add :YourSteamID: admin

Find more about Rust Oxide permissions here.

Pre-configured permission group
Permission GroupDescription
defaultDefault group of players. They can enjoy a full server experience except VIP, Moderator and Admin privileges.
vipSame group as the default, but with VIP privileges.
moderatorModerators have access to certain functions in the admin menu to help players.
adminAdministrator role which allows you to manage the server with all permissions. (Don't play with this role.)
How to manage permissions

To manage your permissions, you need a plugin that will allow you to do it from the game. For this, there are two main plugins:

AdminMenu — a very complete plugin which, in addition to allowing you to manage your permissions, will allow you to do a lot of other things: give yourself and moderate players, and teleport. This plugin is absolutely a must have.

Permissions Manager — a plugin that will allow you to manage your permissions, and for free.

For more information about permissions, we recommend this tutorial.

Map Customization

If you want to change the map for your server, simply go to your main configuration file server.cfg.

Inside this file, you will find the following lines (the values will probably be different on your side):

server.seed 42070
server.worldsize 2000

server.seed is the unique id of your map. server.worldsize is the size of your map.

You can go to RustMaps.com to choose between different maps. Once your choice is made, simply copy the seed and the size of the map into your file and restart your server.

For battlefield game mode, we recommend using small sized maps.

Place your server name

To replace the "YourServer" tags with the name of your server, here are the files that must be modified:

Config Files PathLines
oxide/lang/en/AutoBroadcast.jsonLine 2-3 — allows you to broadcast automatic messages in the chat.
oxide/config/LoadingMessages.jsonLines 8-9, 12-13, 19-20, 23-24, 28-29 — to change the messages displayed when someone logs in.
oxide/config/WelcomePanel.jsonLine 8, 30-39 — to edit the logo, line 9; to edit the background, line 150.

Server Info Settings

In your server.cfg file (or your dashboard) you will find the different lines to modify the title of your server.

To modify your server tags, add the following line to the end of your file:

server.tags EU,weekly,battlefield

You can view the list of tags here.

To modify your server's banner, add this line:

server.headerimage YourImageLink

Replace "YourImageLink" with your image link. The server header image size must be 512x256 or 1024x512.

To modify your server's description, edit this line:

server.description "Welcome to YourServer 3x!\nFore more information please write /info in chat.\n\nMap Size : 2000 - Max Group : 5\nWipe schedule: Every Monday @ 8:00AM (UTC+1)\n\n-3x (Loot Tables / Gathering)\n-Custom Outpost\n Home System\n TP, Clans & BP Tier 1 unlocked\n VIP Kit"

To create spaces, use \n.


Online Store / Tebex

If you want to monetize your server (for VIP kits for example), here is a quick tutorial:

To automate everything without hassle, we will use the Tebex platform — a very well-known and expert site in the field.

  • Create an account.
  • To set up your store, follow the tutorial and instructions from Tebex. (Their tutorial being very well done, we leave you in their expert hands for this part.)

How to link your VIP Kit with your package:

When creating a kit using the RustKits plugin, you can create a permission with the kit in the "permission" section. To do this, simply write kits.NameOfYourPermission, for example: kits.vip.

Now, with your plugin that manages permissions, you can give your permission (kits.NameOfYourPermission) to a group you want. For example, in your setup, there is a VIP kit which is only accessible to the VIP group.

  • Now go to your package from Tebex. In the last section at the bottom you will find the "Game Server Commands" section.
  • Select the server then click on "Add Command".
  • Select "When the package is purchased".
  • In the command section, enter this: oxide.usergroup add {id} kits.vip
  • This command will add the Steam ID to the desired group (here, for example: VIP Group).
  • From Tebex, when you type {id}, it will automatically place the Steam ID of the user purchasing the package.

You can now distribute your VIP kits to your players.


Automatic Wipe

If you want to be able to wipe your server using a simple command in the console, here's how to do it:

To create a simple command that will wipe your server, we recommend using Server Wipe System.

The plugin is a .dll file, so you need to place it in the folder rust/HarmonyMods then restart your server.

Once restarted, a .json configuration file will be created in the "HarmonyMods" folder.

Once the plugin is configured to your liking, all you need to do is program the automatic command (wipe forced or wipe weekly) from your dashboard.

For more information about wipe in general, we recommend this tutorial.