How to make a Rust outpost and bandit teleport plugin (/outpost, /bandit)

using System.Linq;
using System;
using System.Collections.Generic;
using Newtonsoft.Json;
using Oxide.Core;
using UnityEngine;

namespace Oxide.Plugins
{
    [Info("Outpost Teleport", "RustPluginGenerator", "1.0.0")]
    [Description("Adds /outpost and /bandit teleports to monuments with warmup, cooldown and permission bypass.")]
    public class OutpostTeleport : RustPlugin
    {
        private const string PermCooldownBypass = "outpostteleport.cooldownbypass";

        private PluginConfig config;
        private Vector3 outpostPosition;
        private Vector3 banditPosition;
        private bool outpostFound;
        private bool banditFound;

        private readonly Dictionary<ulong, double> lastTeleport = new Dictionary<ulong, double>();
        private readonly Dictionary<ulong, Timer> warmups = new Dictionary<ulong, Timer>();

        private class PluginConfig
        {
            [JsonProperty("Warmup seconds")]
            public float WarmupSeconds = 10f;

            [JsonProperty("Cooldown seconds")]
            public float CooldownSeconds = 300f;

            [JsonProperty("Cancel when player moves further than (meters)")]
            public float MoveCancelDistance = 1.5f;

            [JsonProperty("Teleport height offset")]
            public float TeleportHeightOffset = 1.5f;

            [JsonProperty("Teleport side offset")]
            public float TeleportSideOffset = 3f;

            [JsonProperty("Monument names")]
            public MonumentNames MonumentNames = new MonumentNames();
        }

        private class MonumentNames
        {
            [JsonProperty("Outpost")]
            public string Outpost = "Outpost";

            [JsonProperty("Bandit Camp")]
            public string Bandit = "Bandit Camp";
        }

        protected override void LoadDefaultConfig() => config = new PluginConfig();

        protected override void LoadConfig()
        {
            base.LoadConfig();
            try
            {
                config = Config.ReadObject<PluginConfig>();
                if (config == null) throw new Exception();
            }
            catch
            {
                PrintWarning("Configuration file is invalid, using defaults");
                LoadDefaultConfig();
            }
            SaveConfig();
        }

        protected override void SaveConfig() => Config.WriteObject(config);

        protected override void LoadDefaultMessages()
        {
            lang.RegisterMessages(new Dictionary<string, string>
            {
                ["Warmup"] = "Teleporting to {0} in {1} seconds. Do not move.",
                ["Moved"] = "Teleport cancelled: you moved.",
                ["Success"] = "You have been teleported to {0}.",
                ["Cooldown"] = "You can teleport again in {0} seconds.",
                ["NotFound"] = "The {0} monument was not found on this map.",
                ["NotAlive"] = "You cannot teleport while dead, sleeping, mounted or wounded.",
                ["Mounted"] = "You cannot teleport while mounted."
            }, this);
        }

        private string Msg(string key, string userId = null, params object[] args) =>
            string.Format(lang.GetMessage(key, this, userId), args);

        private void Init()
        {
            permission.RegisterPermission(PermCooldownBypass, this);
        }

        private void OnServerInitialized(bool initial)
        {
            outpostFound = false;
            banditFound = false;

            if (TerrainMeta.Path == null || TerrainMeta.Path.Monuments == null)
            {
                PrintWarning("Monument list is not available; teleport commands will report missing monuments");
                return;
            }

            foreach (var monument in TerrainMeta.Path.Monuments)
            {
                if (monument == null || monument.displayPhrase == null) continue;

                string name = monument.displayPhrase.english;
                if (string.IsNullOrEmpty(name)) continue;

                if (!outpostFound && string.Equals(name, config.MonumentNames.Outpost, StringComparison.OrdinalIgnoreCase))
                {
                    outpostPosition = LandPosition(monument.transform.position);
                    outpostFound = true;
                }
                else if (!banditFound && string.Equals(name, config.MonumentNames.Bandit, StringComparison.OrdinalIgnoreCase))
                {
                    banditPosition = LandPosition(monument.transform.position);
                    banditFound = true;
                }
            }

            if (!outpostFound) PrintWarning("Outpost monument not found; check 'Monument names: Outpost' in the config");
            if (!banditFound) PrintWarning("Bandit Camp monument not found; check 'Monument names: Bandit Camp' in the config");
        }

        private Vector3 LandPosition(Vector3 monumentPosition)
        {
            return monumentPosition + new Vector3(config.TeleportSideOffset, config.TeleportHeightOffset, 0f);
        }

        [ChatCommand("outpost")]
        private void CmdOutpost(BasePlayer player, string command, string[] args)
        {
            HandleTeleportRequest(player, "Outpost", outpostFound, outpostPosition);
        }

        [ChatCommand("bandit")]
        private void CmdBandit(BasePlayer player, string command, string[] args)
        {
            HandleTeleportRequest(player, "Bandit Camp", banditFound, banditPosition);
        }

        private void HandleTeleportRequest(BasePlayer player, string monumentName, bool found, Vector3 position)
        {
            if (player == null || !player.IsConnected) return;

            if (!found)
            {
                SendReply(player, Msg("NotFound", player.UserIDString, monumentName));
                return;
            }

            if (player.IsDead() || player.IsSleeping() || player.IsWounded())
            {
                SendReply(player, Msg("NotAlive", player.UserIDString));
                return;
            }

            if (player.isMounted)
            {
                SendReply(player, Msg("Mounted", player.UserIDString));
                return;
            }

            if (warmups.ContainsKey(player.userID.Get()))
            {
                return;
            }

            if (!permission.UserHasPermission(player.UserIDString, PermCooldownBypass))
            {
                double remaining = RemainingCooldown(player.userID.Get());
                if (remaining > 0.0)
                {
                    SendReply(player, Msg("Cooldown", player.UserIDString, Math.Ceiling(remaining)));
                    return;
                }
            }

            StartWarmup(player, monumentName, position);
        }

        private double RemainingCooldown(ulong userId)
        {
            double last;
            if (!lastTeleport.TryGetValue(userId, out last)) return 0.0;

            double elapsed = UnityEngine.Time.realtimeSinceStartup - last;
            double remaining = config.CooldownSeconds - elapsed;
            return remaining > 0.0 ? remaining : 0.0;
        }

        private void StartWarmup(BasePlayer player, string monumentName, Vector3 target)
        {
            ulong userId = player.userID.Get();
            Vector3 startPosition = player.transform.position;
            int ticks = Mathf.Max(1, Mathf.RoundToInt(config.WarmupSeconds / 0.25f));
            bool cancelled = false;
            Timer repeatTimer = null;

            SendReply(player, Msg("Warmup", player.UserIDString, monumentName, Mathf.RoundToInt(config.WarmupSeconds)));

            repeatTimer = timer.Repeat(0.25f, ticks, () =>
            {
                if (cancelled) return;

                if (player == null || !player.IsConnected || player.IsDead() || player.IsSleeping())
                {
                    cancelled = true;
                    warmups.Remove(userId);
                    return;
                }

                if (Vector3.Distance(player.transform.position, startPosition) > config.MoveCancelDistance)
                {
                    cancelled = true;
                    warmups.Remove(userId);
                    SendReply(player, Msg("Moved", player.UserIDString));
                }
            });

            warmups[userId] = repeatTimer;

            timer.Once(config.WarmupSeconds, () =>
            {
                warmups.Remove(userId);
                if (cancelled) return;
                if (player == null || !player.IsConnected) return;
                if (player.IsDead() || player.IsSleeping() || player.IsWounded()) return;
                if (Vector3.Distance(player.transform.position, startPosition) > config.MoveCancelDistance) return;

                DoTeleport(player, monumentName, target);
            });
        }

        private void DoTeleport(BasePlayer player, string monumentName, Vector3 position)
        {
            if (player == null || !player.IsConnected) return;

            player.Teleport(position);
            lastTeleport[player.userID.Get()] = UnityEngine.Time.realtimeSinceStartup;
            SendReply(player, Msg("Success", player.UserIDString, monumentName));
        }

        private void OnPlayerDisconnected(BasePlayer player, string reason)
        {
            if (player == null) return;

            ulong userId = player.userID.Get();

            Timer warmup;
            if (warmups.TryGetValue(userId, out warmup))
            {
                warmup.Destroy();
                warmups.Remove(userId);
            }

            double last;
            if (lastTeleport.TryGetValue(userId, out last) &&
                UnityEngine.Time.realtimeSinceStartup - last > config.CooldownSeconds)
            {
                lastTeleport.Remove(userId);
            }
        }

        private void Unload()
        {
            foreach (var entry in warmups)
            {
                if (entry.Value != null) entry.Value.Destroy();
            }

            warmups.Clear();
            lastTeleport.Clear();
        }
    }
}