RUST NTeleportation Plugin

RUST NTeleportation Plugin (How to Install, Configure, & Use)

What is the NTeleportation plugin?

NTeleportation (NT) is a RUST plugin that enables players to use pre-specified (or player-set) teleportation functions within RUST. Currently updated and supported by nivex, NT is a free-to-use plugin available for download on UMOD and is an established favorite amongst the modded server community as both a default and Pay-to-Win feature.

Note: This mod will require the server status to be changed from Community to Modded when used. For more information on this, check out Facepunch’s guidelines on plugin use here.

Check out the teleportation command if you’re looking for a built-in command that doesn’t require plugins.

Potential reasons to use the NTeleportation plugin

On servers where the gameplay is intended to be considerably faster paced, for instance, Weekly or higher multiplier loot gain servers, travel is also a factor. Players are often given the ability to ‘fast travel’ across other gaming platforms so the RUST equivalent would be a slight twist on the existing in-game teleportation system.  

In stark contrast to the default teleportation system, NTeleportation enables both limited and unlimited variations depending on client permissions. Other functions include:

  • Integrations into other plugin functions to allow for currency-based teleports
  • Limitations per toggle to prevent exploiting the feature to or from certain monuments or PVP situations
  • Monument-specific teleportation coding
  • Teleport restrictions based on build privilege
  • Team-based teleportation

How to install the NTeleportation plugin

As with all uMod plugins, the server you intend to install them on requires uMod (Oxide) to be installed to facilitate their function. For a step-by-step perspective on how to install this plugin, please reference the following list:

  1. First, you must have uMod/Oxide installed on your server. Use our Installing uMod (Oxide) on Your RUST server guide if you need help; otherwise, if you use a third-party hosting, their user interface will have instructions on how to get started. It may be tooled explicitly to their platform, so reach out to your host for details.
  2. Acquire the latest version of the plugin from uMod’s NTeleportation plugin page, or download the CS file directly.
  3. Locate the downloaded NTeleportation.cs file and install the plugin on your RUST server, or follow your host-specific instructions.
  4. Once NTeleportation is installed in the plugins folder, and if the server is actively running, uMod will immediately create an alternate NTeleportation.json file in your config folder. It is essential to differentiate these files and not mistake them, as you must make configuration changes in the .json file in the config folder.

Additional dependencies

Like many other uMod plugins, NT may work as a standalone mod or in conjunction with other select mods. While not explicitly detailed by the current development team, a partial list of such mods includes:

Permissions

As with all plugins you might try to install, NTeleportation has a small list of permissions. Make sure you reference our Oxide Permissions guide to understand the oxide.grant permission system better. Permissions bearing a warning indicate that adding this permission gives unilateral removal decision-making to any authorized group—exercise extreme caution. 

Specific permission command lines include:

CommandDescription
nteleportation.bypassfoundationcheckPermits for setting teleportation locations regardless of foundation or other ground type currently standing on
nteleportation.craftbanditPermits teleportation to bandit while crafting
nteleportation.crafthomePermits teleportation to home while crafting
nteleportation.craftislandPermits teleportation to island or town while crafting
nteleportation.craftoutpostPermits teleportation to outpost while crafting
nteleportation.crafttownPermits teleportation to town while crafting
nteleportation.crafttprPermits teleportation via TPR while crafting
nteleportation.deletehomePermits use of /home delete & /deletehome
nteleportation.exemptfrominterruptcountdowndisables interruptions while permitted player is teleporting
nteleportation.globalcooldownvipsets vip global cooldown timer
nteleportation.homePermits use of /home, /sethome and /removehome
nteleportation.homehomesPermits use of  /home homes & /homehomes
nteleportation.importhomesPermits use of teleport.importhomes
nteleportation.radiushomePermits use of  /home radius & /radiushome
nteleportation.tp/tp – Administrative command allowing unilateral TP anywhere – do not give to default group
nteleportation.tpbPermits use of /tpb
nteleportation.tpbanditPermits use of /bandit
nteleportation.tpconsolePermits use of teleport.topos & teleport.toplayer
nteleportation.tphomePermits use of /home tp and /tphome
nteleportation.tpislandPermits use of /island and /town island
nteleportation.tplPermits use of /tpl
nteleportation.tpmarker
Permits use of teleport via placing a marker on the map
nteleportation.tpnPermits use of /tpn
nteleportation.tpoutpostPermits use of /outpost
nteleportation.tpr
Permits use of /tpr
nteleportation.tpremovePermits use of /tpremove
nteleportation.tpsavePermits use of /tpsave
nteleportation.tpt
Permits use of instant tpa without countdown
nteleportation.tptownPermits use of /town
nteleportation.wipehomesPermits use of /wipehomes

Activation

Once installed and permitted to use the mod, players may use it in-game via a simple /tphelp or /tpinfo command in chat. Additional chat commands prefaced with ‘/’) are as follows:

Admin Specific:

CommandDescription
bandit setSets Bandit Camp to current admin location
home delete [playerID]Clears a home from player
home homes [playerID]Displays a list of all homes of player
home radius [radius]Displays all homes in radius
home tp [playerID]Teleport admin to player home
home wipe [playerID]Delete all of players homes (or all if not specified)
outpost setSets Outpost to current admin location
town set Sets Town to current admin location
tp [player 1 ID] [player 2 ID]Teleport player1 to player2
tp [pos]Teleport to set of coordinates
tp [playerID]Teleport admin to the target player
tpbReverts admin back to the place where they were before teleporting
tplLists saved locations
tpl [name]Teleport to saved location
tpremove [name]Deletes location from your saved list
tpsave [name]Set current position as the location name
wipehomesDelete all homes

Default Specific:

CommandDescription
banditTeleports player (pending permission) to Bandit Camp (if set)
home add [name]Saves your current position as the location NAME. (aka sethome)
home listShows you a list of all the locations you have saved. (aka listhomes)
home [name]Teleports player (pending permission) to their home (if set)
home [name] payTeleports player (pending permission) to their home (if set), bypassing cooldown by paying from Economics balance (if activated via other mod)
home remove [name] Removes player home (pending permission, if set) (aka removehome)
island [name]Teleports player (pending permission) to island by specified ID (if set)
island add [name]Adds a spawn point listed by name at admins current location (should not be used in player-buildable locations)
outpostTeleports player (pending permission) to Outpost (if set)
townTeleports player (pending permission) to Town (if set)
town/outpost/bandit payTeleports player (pending permission) to (if set) town/outpost/bandit, bypassing cooldown by paying from Economics balance (if activated via other mod)
tpaAccept last incoming teleport request
tpat [name]Toggles automatic tpa on/off for specified player
tpcCancel teleport or request
tphelpShows help
tpinfoShows limits and cooldowns
tpr [name]Sends teleport request to player

Recommended plugin configuration

By default, the configuration of the NTeleportation.json file should be adequate for most server owners’ purposes. The following is a default configuration, prefaced by our own warning disclaimer:

Alteration of any below values could drastically increase the chance of mod failure if not properly done. It is recommended that only those with considerable knowledge of RUST mods alter them.

{
  "Settings": { - Baseline, global configs that impact all group types.
    "Chat Command Color": "#FFFF00",
    "Chat Command Argument Color": "#FFA500",
    "Enable Popup Support": false,
    "Block All Teleporting From Inside Authorized Base": false,
    "TPB Available After X Seconds": 0.0,
    "Global Teleport Cooldown": 0.0,
    "Global VIP Teleport Cooldown": 0.0,
    "Play Sounds After Teleport": false,
    "Sounds To Play After Teleport": [
      "assets/prefabs/misc/xmas/presents/effects/unwrap.prefab",
      "assets/bundled/prefabs/fx/player/howl.prefab",
      "assets/content/vehicles/minicopter/debris_effect.prefab",
      "assets/prefabs/npc/patrol helicopter/damage_effect_debris.prefab",
      "assets/prefabs/npc/patrol helicopter/effects/rocket_fire.prefab"
    ],
    "Interrupt TP": { - Baseline, global configs that impact all group types relating to teleportation being denied or interrupted if moved into.
      "Interrupt Teleport At Specific Monuments": [],
      "Above Water": true,
      "Balloon": true,
      "Boats": false,
      "Cargo Ship": true,
      "Cold": false,
      "Excavator": false,
      "Hot": false,
      "Hostile": false,
      "Hurt": true,
      "Junkpiles": false,
      "Lift": true,
      "Monument": false,
      "Ignore Monument Marker Prefab": false,
      "Mounted": true,
      "Oil Rig": false,
      "Safe Zone": true,
      "Swimming": false
    },
    "Block Teleport (NoEscape)": false,
    "Block Teleport (ZoneManager)": false,
    "Chat Name": "<color=red>Teleportation</color> \n\n",
    "Chat Steam64ID": 76561199056025689,
    "Check Boundaries On Teleport X Y Z": true,
    "Data File Directory (Blank = Default)":" ",
    "Draw Sphere On Set Home": true,
    "Homes Enabled": true,
    "TPR Enabled": true,
    "Strict Foundation Check": false,
    "Cave Distance Small": 50.0,
    "Cave Distance Medium": 70.0,
    "Cave Distance Large": 110.0,
    "Default Monument Size": 50.0,
    "Minimum Temp": 0.0,
    "Maximum Temp": 40.0,
    "Blocked Items": {},
    "Bypass CMD": "pay",
    "Use Monument Topology Check": false,
    "Use Cave Topology Check": false,
    "Use Economics": false,
    "Use Server Rewards": false,
    "Wipe On Upgrade Or Change": true,
    "Auto Generate Outpost Location": true,
    "Auto Generate Bandit Location": true,
    "Show Time As Seconds Instead": false
  }, - admin-specific configs that impact permission groups
  "Admin": {
    "Announce Teleport To Target": false,
    "Usable By Admins": true,
    "Usable By Moderators": true,
    "Location Radius": 25,
    "Teleport Near Default Distance": 30
  },
  "Home": { - most toggled features - allows for custom limits to be placed (top default, then specified) by user group.
    "Homes Limit": 2, - # of homes default user is allowed at a time
    "VIP Homes Limits": {
      "nteleportation.vip": 5 - # of homes VIP user is allowed at a time
    },
    "Allow Sethome At Specific Monuments": [ - remove to disable
      "HQM Quarry",
      "Stone Quarry",
      "Sulfur Quarry",
      "Ice Lake"
    ],
    "Allow Sethome At All Monuments": false,
    "Allow TPB": true, - allow teleport back feature at monuments
    "Cooldown": 600,
    "Countdown": 15,
    "Daily Limit": 5,
    "VIP Daily Limits": {
      "nteleportation.vip": 5
    },
    "VIP Cooldowns": {
      "nteleportation.vip": 5
    },
    "VIP Countdowns": {
      "nteleportation.vip": 5
    },
    "Location Radius": 25,
    "Force On Top Of Foundation": true,
    "Check Foundation For Owner": true,
    "Use Friends": true,
    "Use Clans": true,
    "Use Teams": true,
    "Usable Out Of Building Blocked": false,
    "Usable Into Building Blocked": false,
    "Usable From Safe Zone Only": false,
    "Allow Cupboard Owner When Building Blocked": true,
    "Allow Iceberg": false,
    "Allow Cave": false,
    "Allow Crafting": false,
    "Allow Above Foundation": true,
    "Check If Home Is Valid On Listhomes": false,
    "Pay": 0,
    "Bypass": 0
  },
  "TPT": {
    "Use Friends": false,
    "Use Clans": false,
    "Use Teams": false,
    "Allow Cave": false
  },
  "TPR": { - Baseline, global configs that impact VIP group tprequests.
    "Require Player To Be Friend, Clan Mate, Or Team Mate": false,
    "Allow Cave": false,
    "Allow TPB": true,
    "Cooldown": 600,
    "Countdown": 15,
    "Daily Limit": 5,
    "VIP Daily Limits": {
      "nteleportation.vip": 5
    },
    "VIP Cooldowns": {
      "nteleportation.vip": 5
    },
    "VIP Countdowns": {
      "nteleportation.vip": 5
    },
    "Request Duration": 30,
    "Block TPA On Ceiling": true,
    "Usable Out Of Building Blocked": false,
    "Usable Into Building Blocked": false,
    "Allow Cupboard Owner When Building Blocked": true,
    "Allow Crafting": false,
    "Pay": 0,
    "Bypass": 0
  },
  "Dynamic Commands": { - town-specific configs
    "Town": {
      "Command Enabled": true,
      "Allow TPB": true,
      "Allow Cave": false,
      "Cooldown": 600,
      "Countdown": 15,
      "Daily Limit": 5,
      "VIP Daily Limits": {
        "nteleportation.vip": 5
      },
      "VIP Cooldowns": {
        "nteleportation.vip": 5
      },
      "VIP Countdowns": {
        "nteleportation.vip": 5
      },
      "Location": "0 0 0",
      "Locations": [],
      "Teleport To Random Location": false,
      "Usable Out Of Building Blocked": false,
      "Allow Crafting": false,
      "Pay": 0,
      "Bypass": 0
    },
    "Island": { - island-specific configs
      "Command Enabled": true,
      "Allow TPB": false,
      "Allow Cave": false,
      "Cooldown": 600,
      "Countdown": 15,
      "Daily Limit": 5,
      "VIP Daily Limits": {
        "nteleportation.vip": 5
      },
      "VIP Cooldowns": {
        "nteleportation.vip": 5
      },
      "VIP Countdowns": {
        "nteleportation.vip": 5
      },
      "Location": "0 0 0",
      "Locations": [],
      "Teleport To Random Location": true,
      "Usable Out Of Building Blocked": false,
      "Allow Crafting": false,
      "Pay": 0,
      "Bypass": 0
    },
    "Outpost": { - outpost-specific configs
      "Command Enabled": true,
      "Allow TPB": true,
      "Allow Cave": false,
      "Cooldown": 600,
      "Countdown": 15,
      "Daily Limit": 5,
      "VIP Daily Limits": {
        "nteleportation.vip": 5
      },
      "VIP Cooldowns": {
        "nteleportation.vip": 5
      },
      "VIP Countdowns": {
        "nteleportation.vip": 5
      },
      "Location": "0 0 0",
      "Locations": [],
      "Teleport To Random Location": true,
      "Usable Out Of Building Blocked": false,
      "Allow Crafting": false,
      "Pay": 0,
      "Bypass": 0
    },
    "Bandit": { - bandit camp-specific configs
      "Command Enabled": true,
      "Allow TPB": true,
      "Allow Cave": false,
      "Cooldown": 600,
      "Countdown": 15,
      "Daily Limit": 5,
      "VIP Daily Limits": {
        "nteleportation.vip": 5
      },
      "VIP Cooldowns": {
        "nteleportation.vip": 5
      },
      "VIP Countdowns": {
        "nteleportation.vip": 5
      },
      "Location": "0 0 0",
      "Locations": [],
      "Teleport To Random Location": true,
      "Usable Out Of Building Blocked": false,
      "Allow Crafting": false,
      "Pay": 0,
      "Bypass": 0
    }
  }
}

How to update the NTeleportation plugin

Updating the Nteleportation plugin is simple and quick:

  1. Visit the uMod NTeleportation plugin page
  2. Download the latest version of the NTeleportation plugin
  3. Overwrite the existing NTeleportation.cs file in your Oxide plugins folder.

It is best practice not to uninstall the mod, as you do not need to alter the JSON file. It will remain with your existing settings (unless the developer otherwise suggests a complete reinstall).

How to remove the NTeleportation plugin

Since the NTeleportation plugin does impact the player experience and game features, removing the plugin will take a few extra steps.

  1. Prepare and properly shut down the RUST server
  2. Open the Oxide plugins folder in your server directory
  3. Locate and delete the NTeleportation.cs file
  4. Open the Oxide config folder in your server directory
  5. Locate and delete the NTeleportation.json configuration file
  6. Restart the RUST server

Suppose you want to disable the NTeleportation plugin for a short period. You can use the oxide.unload NTeleportation command, which you may also run in the F1 console, RCON, or Web Console.

Disclaimer and seeking assistance

Corrosion Hour does not maintain the RUST NTeleportation plugin, nor do we assist with modifying the plugin outside the config scope. Visit the plugin’s uMod page to support the plugin creators, report bugs, or propose feature requests. Please get in touch with an admin in our Discord community for help with the steps and instructions in this guide.

Tempest Hosting
No Limit Llama's avatar

About No Limit Llama

An aspiring woodworker and web designer. Father, husband, and Rust veteran. Llama has written op-eds and official game documents for over two decades. The earliest writings were on Asheron’s Call, followed by World of Warcraft and eventually Rust. The vast majority of his indoor time is spent running Rust servers or helping friends with their Rust-related projects. He enjoys working around the house, continuing his education when time permits, and creating new processes to simplify activities of daily living for his friends and family. He has an incredible wife, a dog, three children, and one granddaughter.

View all posts by No Limit Llama →