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:
- 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.
- Acquire the latest version of the plugin from uMod’s NTeleportation plugin page, or download the CS file directly.
- Locate the downloaded
NTeleportation.csfile and install the plugin on your RUST server, or follow your host-specific instructions. - Once NTeleportation is installed in the plugins folder, and if the server is actively running, uMod will immediately create an alternate
NTeleportation.jsonfile 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:
| Command | Description |
| nteleportation.bypassfoundationcheck | Permits for setting teleportation locations regardless of foundation or other ground type currently standing on |
| nteleportation.craftbandit | Permits teleportation to bandit while crafting |
| nteleportation.crafthome | Permits teleportation to home while crafting |
| nteleportation.craftisland | Permits teleportation to island or town while crafting |
| nteleportation.craftoutpost | Permits teleportation to outpost while crafting |
| nteleportation.crafttown | Permits teleportation to town while crafting |
| nteleportation.crafttpr | Permits teleportation via TPR while crafting |
| nteleportation.deletehome | Permits use of /home delete & /deletehome |
| nteleportation.exemptfrominterruptcountdown | disables interruptions while permitted player is teleporting |
| nteleportation.globalcooldownvip | sets vip global cooldown timer |
| nteleportation.home | Permits use of /home, /sethome and /removehome |
| nteleportation.homehomes | Permits use of /home homes & /homehomes |
| nteleportation.importhomes | Permits use of teleport.importhomes |
| nteleportation.radiushome | Permits use of /home radius & /radiushome |
| nteleportation.tp | /tp – Administrative command allowing unilateral TP anywhere – do not give to default group |
| nteleportation.tpb | Permits use of /tpb |
| nteleportation.tpbandit | Permits use of /bandit |
| nteleportation.tpconsole | Permits use of teleport.topos & teleport.toplayer |
| nteleportation.tphome | Permits use of /home tp and /tphome |
| nteleportation.tpisland | Permits use of /island and /town island |
| nteleportation.tpl | Permits use of /tpl |
| nteleportation.tpmarker | Permits use of teleport via placing a marker on the map |
| nteleportation.tpn | Permits use of /tpn |
| nteleportation.tpoutpost | Permits use of /outpost |
| nteleportation.tpr | Permits use of /tpr |
| nteleportation.tpremove | Permits use of /tpremove |
| nteleportation.tpsave | Permits use of /tpsave |
| nteleportation.tpt | Permits use of instant tpa without countdown |
| nteleportation.tptown | Permits use of /town |
| nteleportation.wipehomes | Permits 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:
| Command | Description |
| bandit set | Sets 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 set | Sets 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 |
| tpb | Reverts admin back to the place where they were before teleporting |
| tpl | Lists 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 |
| wipehomes | Delete all homes |
Default Specific:
| Command | Description |
| bandit | Teleports player (pending permission) to Bandit Camp (if set) |
| home add [name] | Saves your current position as the location NAME. (aka sethome) |
| home list | Shows 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] pay | Teleports 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) |
| outpost | Teleports player (pending permission) to Outpost (if set) |
| town | Teleports player (pending permission) to Town (if set) |
| town/outpost/bandit pay | Teleports player (pending permission) to (if set) town/outpost/bandit, bypassing cooldown by paying from Economics balance (if activated via other mod) |
| tpa | Accept last incoming teleport request |
| tpat [name] | Toggles automatic tpa on/off for specified player |
| tpc | Cancel teleport or request |
| tphelp | Shows help |
| tpinfo | Shows 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:
- Visit the uMod NTeleportation plugin page
- Download the latest version of the NTeleportation plugin
- Overwrite the existing
NTeleportation.cs filein 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.
- Prepare and properly shut down the RUST server
- Open the Oxide plugins folder in your server directory
- Locate and delete the
NTeleportation.csfile - Open the Oxide config folder in your server directory
- Locate and delete the
NTeleportation.jsonconfiguration file - 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.
