TeleportSystem

TeleportSystem for Rust (Oxide / uMod)

TeleportSystem is a feature-rich, optimized teleportation manager for Rust servers. It provides safe teleportation to player sleeping bags/beds, dynamic map monuments, and direct player-to-player teleport requests (/tpr). It features a modern GUI interface and seamless integration with economy plugins.

Features

• Sleeping Bag & Bed Teleportation: Allows players to browse and teleport to their active sleeping bags or beds via an intuitive UI.
• Dynamic Monument Teleportation: Automatically detects, filters, and indexes all valid monuments across custom and procedural maps.
• Player-to-Player Teleport Requests (/tpr): Send teleport requests to active players with an interactive accept/decline pop-up UI.
• Safe Arrival Detection: Advanced ground-raycasting, building/structure overlap detection, and NavMesh sampling ensure players never spawn underwater, inside rocks, or inside base walls.
• Economy & Rewards Integration: Native support for Economics (Currency: $) and ServerRewards (Currency: RP).
• Multi-Page GUI Navigation: Paginated grid UI handling large numbers of sleeping bags or monuments without screen clutter.
• Localization (Lang API): Fully customizable and translatable player messages via Oxide's built-in language system.

Permissions

Commands

Chat Commands

Console / UI Commands

Note: These commands are executed internally by UI interactions or console inputs.

• tp_accept - Accepts an incoming player teleport request.
• tp_decline - Declines an incoming player teleport request.
• tp_open_tab <tab> [page] - Switches between UI tabs (bags / monuments) and page numbers.
• tp_to_bag <net_id> - Teleports the player to a selected sleeping bag by Network ID.
• tp_to_monument "<monument_name>" - Teleports the player to a specified monument.
• tp_close_ui - Destroys the main UI container.

Installation

1. Download or save TeleportSystem.cs.
2. Place the file into your server's oxide/plugins directory.
3. Oxide will compile the plugin automatically.
4. (Optional) Configure permissions for player groups via Oxide console/RCON:
   
   
   • oxide.grant group default teleportsystem.tp
   • oxide.grant group default teleportsystem.tpr

Configuration Options

• Use Economy System (true/false): Enable or disable charging players for teleporting.
• Currency Type: Set to "Economics" or "ServerRewards".
• Teleport Request Cost: Cost charged to the sender when a /tpr is accepted.
• Sleeping Bag Cost: Cost per bag teleport.
• Monument Teleport Cost: Cost per monument teleport.
• Monuments Configuration: Automatically populates with map monuments. You can individually enable/disable monuments or adjust safe teleport radiuses.

Configuration:

{
"Use Economy System": true,
"Currency Type (Economics or ServerRewards)": "Economics",
"Teleport Request Cost": 25.0,
"Sleeping Bag Cost": 10.0,
"Monument Teleport Cost": 50.0,
"Monuments Configuration": {
"Harbor 2": {
"Enabled": true,
"Radius": 30.0
},
"Airfield 1": {
"Enabled": true,
"Radius": 30.0
},
"Launch Site 1": {
"Enabled": true,
"Radius": 30.0
},
"Arctic Research Base A": {
"Enabled": true,
"Radius": 30.0
},
"Satellite Dish": {
"Enabled": true,
"Radius": 30.0
},
"Desert Military Base C": {
"Enabled": true,
"Radius": 30.0
},
"Junkyard 1": {
"Enabled": true,
"Radius": 30.0
},
"Radtown Small 3": {
"Enabled": true,
"Radius": 30.0
},
"Oilrig 1": {
"Enabled": true,
"Radius": 30.0
},
"Oilrig 2": {
"Enabled": true,
"Radius": 30.0
},
"Harbor 1": {
"Enabled": true,
"Radius": 30.0
},
"Lighthouse": {
"Enabled": true,
"Radius": 30.0
},
"Trainyard 1": {
"Enabled": true,
"Radius": 30.0
},
"Bandit Town": {
"Enabled": true,
"Radius": 30.0
},
"Outpost": {
"Enabled": true,
"Radius": 30.0
},
"Dome": {
"Enabled": true,
"Radius": 30.0
},
"Mining Quarry A": {
"Enabled": true,
"Radius": 30.0
},
"Mining Quarry B": {
"Enabled": true,
"Radius": 30.0
},
"Mining Quarry C": {
"Enabled": true,
"Radius": 30.0
},
"Water Treatment Plant 1": {
"Enabled": true,
"Radius": 30.0
},
"Fishing Village A": {
"Enabled": true,
"Radius": 30.0
},
"Fishing Village B": {
"Enabled": true,
"Radius": 30.0
},
"Underwater Lab A": {
"Enabled": true,
"Radius": 30.0
},
"Large Barn": {
"Enabled": true,
"Radius": 50.0
},
"Ranch": {
"Enabled": true,
"Radius": 50.0
}
}
}