RustSetup: Docs
Thank you so much for purchasing our item.
Installation
Follow the steps below to setup your Rust server:
- First of all, make sure your server is running in Oxide mode.
- 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
- 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)
- Once all the plugins have been downloaded, upload all the .cs files to the plugin folder
rust/oxide/pluginsin your FTP. - Do the same with the .dll files in the following location:
rust/HarmonyMods. - Once the plugins have been uploaded, restart your server. (A complete reboot is necessary for the plugins to install.)
- Once the server has restarted, shut it down again.
- From your FTP, go to
rust/oxide/config, delete all .json files. Replace them with the downloaded files fromConfig Files/config. - Almost the same for
rust/oxide/data: delete all .json files, deleteoxide.groupe.dataand all the folders. Replace them with the downloaded files fromConfig Files/data. - And also for
rust/oxide/lang: delete all the folders. Replace them with the downloaded files fromConfig Files/lang. - 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:
- Download and open the Kits .cs plugin.
- 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; } - 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; } - 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:
- 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.
- (If there are any) place the new plugins in the folder
rust/oxide/plugins - Stop your server.
- Go to
rust/oxide/config, delete all .json files. Replace them with the downloaded files fromConfig Files/config. - Almost the same for
rust/oxide/data: delete all .json files, deleteoxide.groupe.dataand all the folders. Replace them with the downloaded files fromConfig Files/data. - And also for
rust/oxide/lang: delete all the folders. Replace them with the downloaded files fromConfig Files/lang. - 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 pluginoxide/data: configuring plugin dataoxide/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.
Main Plugins Description (Oxide)
Here is the list of main plugins which have configurations that you can modify as you wish:
| Plugin Name | Config Files Path | Description |
|---|---|---|
| AutoBroadcast | oxide/lang/en/AutoBroadcast.jsonoxide/config/AutoBroadcast.json | Allows you to broadcast automatic messages in the chat. |
| AntiItems | oxide/config/AntiItems.json | Allows 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). |
| BetterChat | oxide/lang/en/BetterChat.jsonoxide/config/BetterChat.json | Allows you to change the layout and permissions of the chat. |
| BetterLoot | oxide/data/BetterLoot/LootTables.json | Allows you to modify the quantities of resources in loot boxes. |
| BGrade | oxide/config/BGrade.json | Allows you to build directly to a higher grade. |
| Clans | oxide/config/Clans.json | Allows you to configure the maximum number of players in a clan/group. |
| CraftingController | oxide/config/CraftingController.json | Allows you to modify the crafting time of items. |
| DeathNotes | oxide/config/DeathNotes.json | Show dead people in chat. |
| Economics | oxide/config/Economics.json | Create an economic system in the game. |
| GatherManager | oxide/config/GatherManager.json | Allows you to modify the amount of resource loot. This plugin is mainly configured from the console. |
| Kits | oxide/config/Kits.jsonoxide/data/Kits/kits_data.json | Kit configuration files. The plugins can be configured directly in-game. |
| LoadingMessages | oxide/config/LoadingMessage.json | Change messages displayed during server connection. |
| Loadoutless | oxide/config/Loadoutless.json | Allows players to save their inventory. |
| NoEscape | oxide/config/NoEspace.json | Blocks teleports and construction during fights or raids. |
| RemoveAnimalsAI | Delete the .cs if you don't want it. | Makes animals non-aggressive. |
| RustRewards | oxide/config/RustRewards.json | Allows players to be rewarded with in-game currency for various actions. |
| SkinBox | oxide/config/SkinBox.json | SkinBox settings. Here you must enter your Steam ID. |
| SpawnHeli | oxide/config/SpawnHeli.json | Allows players to spawn, fetch and despawn personal helicopters. |
| StackSizeController | oxide/config/StackSizeController.json | Allows you to control the size of the stacks. |
| WelcomePanel | oxide/config/WelcomePanel.json | Settings file for the WelcomePanel. (Line 150 to modify the background) |
| WPKits, SocialLink, VIP & Wipe | oxide/config/WPKits.jsonoxide/config/WPSocialLinks.jsonoxide/config/WPVIPRanks.jsonoxide/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 Groups | Config Files | Description |
|---|---|---|
| Metabolism | rust/HarmonyConfig/Metabolism.json | Allows changing the players' spawning health, hydration and food value. |
| No Suicide Cooldown | No config | Removes the delay after suiciding. |
| NoTemperatureDamage | No config | Disables cold and heat damage. |
| NoBlueprints | No config | Unlocks all blueprints for each player when they join. |
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 Group | Description |
|---|---|
default | Default group of players. They can enjoy a full server experience except VIP, Moderator and Admin privileges. |
vip | Same group as the default, but with VIP privileges. |
moderator | Moderators have access to certain functions in the admin menu to help players. |
admin | Administrator 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.
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.
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 Path | Lines |
|---|---|
oxide/lang/en/AutoBroadcast.json | Line 2-3 — allows you to broadcast automatic messages in the chat. |
oxide/config/LoadingMessages.json | Lines 8-9, 12-13, 19-20, 23-24, 28-29 — to change the messages displayed when someone logs in. |
oxide/config/WelcomePanel.json | Line 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.