C#:
/*
* Copyright (C) 2026 Game4Freak.io
* This mod is provided under the Game4Freak EULA.
* Full legal terms can be found at https://game4freak.io/eula/
*/
using Newtonsoft.Json;
using Oxide.Core;
using ProtoBuf;
using Rust;
using System.Collections.Generic;
using UnityEngine;
namespace Oxide.Plugins
{
[Info("Map Marker Teleport", "VisEntities", "1.2.0")]
[Description("Teleport to any location by placing a map marker.")]
public class MapMarkerTeleport : RustPlugin
{
#region Fields
private static MapMarkerTeleport _plugin;
private static Configuration _config;
public const int GROUND_LAYERS = Layers.Mask.Terrain | Layers.Mask.World | Layers.Mask.Default | Layers.Mask.Construction;
#endregion Fields
#region Configuration
private class Configuration
{
[JsonProperty(PropertyName = "Version")]
public string Version { get; set; }
[JsonProperty(PropertyName = "Toggle Command")]
public string ToggleCommand { get; set; }
}
protected override void LoadConfig()
{
base.LoadConfig();
_config = Config.ReadObject<Configuration>();
if (string.Compare(_config.Version, Version.ToString()) < 0)
UpdateConfig();
SaveConfig();
}
protected override void LoadDefaultConfig()
{
_config = GetDefaultConfig();
}
private void UpdateConfig()
{
PrintWarning("Config changes detected! Updating...");
Configuration defaultConfig = GetDefaultConfig();
if (string.Compare(_config.Version, "1.2.0") < 0)
_config = defaultConfig;
PrintToConsole("Config update complete! Updated from version " + _config.Version + " to " + Version.ToString());
_config.Version = Version.ToString();
}
private Configuration GetDefaultConfig()
{
return new Configuration
{
Version = Version.ToString(),
ToggleCommand = "mmt"
};
}
protected override void SaveConfig()
{
Config.WriteObject(_config, true);
}
#endregion Configuration
#region Oxide Hooks
private void Init()
{
_plugin = this;
PermissionUtil.RegisterPermissions();
cmd.AddChatCommand(_config.ToggleCommand, this, nameof(cmdToggleTeleportation));
}
private void Unload()
{
_config = null;
_plugin = null;
}
private void OnMapMarkerAdded(BasePlayer player, MapNote note)
{
if (player == null || note == null)
return;
if (!PermissionUtil.HasPermission(player, PermissionUtil.USE))
return;
if (player.isMounted)
{
SendReplyLocalized(player, Lang.Teleportation_BlockedWhileMounted);
return;
}
Vector3 dest = note.worldPosition;
RaycastHit hit;
const float range = 100f;
if (GetGroundInfo(dest, out hit, range, GROUND_LAYERS))
dest = hit.point + Vector3.up * 0.25f;
float waterLevel = WaterLevel.GetWaterLevel(dest, waves: true);
if (waterLevel > dest.y)
dest.y = waterLevel;
object hookResult = Interface.CallHook("OnMapMarkerTeleport", player, dest);
if (hookResult != null)
return;
Teleport(player, dest);
player.State.pointsOfInterest = null;
player.SendMarkersToClient();
}
#endregion Oxide Hooks
#region Commands
private void cmdToggleTeleportation(BasePlayer player, string command, string[] args)
{
if (player == null)
return;
if (!PermissionUtil.HasPermission(player, PermissionUtil.USE))
{
SendReplyLocalized(player, Lang.Command_NoPermission);
return;
}
if (args.Length == 0)
{
SendReplyLocalized(player, Lang.Command_Usage, command);
return;
}
string option = args[0].ToLower();
if (option == "on" || option == "enable")
{
Subscribe(nameof(OnMapMarkerAdded));
SendReplyLocalized(player, Lang.Teleportation_Enabled);
}
else if (option == "off" || option == "disable")
{
Unsubscribe(nameof(OnMapMarkerAdded));
SendReplyLocalized(player, Lang.Teleportation_Disabled);
}
else
{
SendReplyLocalized(player, Lang.Command_Usage, command);
}
}
#endregion Commands
#region Teleportation
public static void Teleport(BasePlayer player, Vector3 destination, bool putToSleep = false, bool wakeUp = false)
{
if (player.isMounted)
player.GetMounted().DismountPlayer(player, true);
if (player.GetParentEntity())
player.SetParent(null, true, true);
player.RemoveFromTriggers();
try
{
player.DisablePlayerCollider();
if (putToSleep && player.IsConnected)
{
player.StartSleeping();
player.SetPlayerFlag(BasePlayer.PlayerFlags.ReceivingSnapshot, true);
player.SetServerFall(true);
}
player.MovePosition(destination);
player.ClientRPC(RpcTarget.Player("ForcePositionTo", player), destination);
if (player.IsConnected)
{
player.UpdateNetworkGroup();
player.SendNetworkUpdateImmediate();
if (putToSleep)
{
player.ClearEntityQueue(null);
player.SendCompleteSnapshot();
}
}
}
finally
{
player.EnablePlayerCollider();
player.SetServerFall(false);
}
if (putToSleep && wakeUp)
{
player.EndSleeping();
player.SendNetworkUpdateImmediate();
}
}
#endregion Teleportation
#region Permissions
private static class PermissionUtil
{
public const string USE = "mapmarkerteleport.use";
private static readonly List<string> _permissions = new List<string>
{
USE,
};
public static void RegisterPermissions()
{
foreach (var permission in _permissions)
{
_plugin.permission.RegisterPermission(permission, _plugin);
}
}
public static bool HasPermission(BasePlayer player, string permissionName)
{
return _plugin.permission.UserHasPermission(player.UserIDString, permissionName);
}
}
#endregion Permissions
#region Helpers
public static bool GetGroundInfo(Vector3 startPosition, out RaycastHit raycastHit, float range, LayerMask mask)
{
return Physics.Linecast(startPosition + new Vector3(0.0f, range, 0.0f), startPosition - new Vector3(0.0f, range, 0.0f), out raycastHit, mask);
}
#endregion Helper Helpers
#region Localization
private class Lang
{
public const string Command_NoPermission = "Command.NoPermission";
public const string Command_Usage = "Command.Usage";
public const string Teleportation_Enabled = "Teleportation.Enabled";
public const string Teleportation_Disabled = "Teleportation.Disabled";
public const string Teleportation_BlockedWhileMounted = "Teleportation.BlockedWhileMounted";
}
protected override void LoadDefaultMessages()
{
lang.RegisterMessages(new Dictionary<string, string>
{
[Lang.Command_NoPermission] = "You don't have permission to use this command.",
[Lang.Command_Usage] = "Usage: /{0} <on|off>",
[Lang.Teleportation_Enabled] = "Map marker teleportation is now <color=#ADFF2F>enabled</color>.",
[Lang.Teleportation_Disabled] = "Map marker teleportation is now <color=#FF6347>disabled</color>.",
[Lang.Teleportation_BlockedWhileMounted] = "You can't teleport while mounted.",
}, this, "en");
}
private static string GetLangText(BasePlayer player, string langKey, params object[] args)
{
string userId;
if (player != null)
userId = player.UserIDString;
else
userId = null;
string message = _plugin.lang.GetMessage(langKey, _plugin, userId);
if (args.Length > 0)
message = string.Format(message, args);
return message;
}
public static void SendReplyLocalized(BasePlayer player, string langKey, params object[] args)
{
string message = GetLangText(player, langKey, args);
if (!string.IsNullOrWhiteSpace(message))
_plugin.SendReply(player, message);
}
#endregion Localization
}
}