OnDefaultItemsReceive

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

namespace Oxide.Plugins
{
    [Info("Custom Starter Items", "RustPluginGenerator", "1.0.0")]
    [Description("Replaces the default loadout with a configurable starter kit")]
    public class CustomStarterItems : RustPlugin
    {
        private const string PermUse = "customstarteritems.use";

        private PluginConfig config;
        private readonly Dictionary<ulong, float> lastGranted = new Dictionary<ulong, float>();

        private class KitEntry
        {
            [JsonProperty("Item shortname")]
            public string Shortname;
            [JsonProperty("Amount")]
            public int Amount;
        }

        private class PluginConfig
        {
            [JsonProperty("Items in the starter kit")]
            public List<KitEntry> Items = new List<KitEntry>
            {
                new KitEntry { Shortname = "rock", Amount = 1 },
                new KitEntry { Shortname = "torch", Amount = 1 },
                new KitEntry { Shortname = "bandage", Amount = 3 }
            };
            [JsonProperty("Cooldown between grants (seconds)")]
            public float CooldownSeconds = 120f;
        }

        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>
            {
                ["KitGiven"] = "You received the starter kit.",
                ["NoPermission"] = "You do not receive the starter kit."
            }, 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(PermUse, this);
        }

        private object OnDefaultItemsReceive(PlayerInventory playerInventory)
        {
            if (playerInventory == null) return null;
            BasePlayer player = playerInventory.baseEntity;
            if (player == null || player.IsNpc || player.IsDead()) return null;

            ulong id = player.userID.Get();
            float now = UnityEngine.Time.realtimeSinceStartup;
            float last;
            if (lastGranted.TryGetValue(id, out last) && now - last < config.CooldownSeconds)
                return true;

            lastGranted[id] = now;

            if (!permission.UserHasPermission(player.UserIDString, PermUse))
                return true;

            BasePlayer target = player;
            NextTick(() =>
            {
                if (target == null || !target.IsConnected) return;
                GiveKit(target);
            });
            return true;
        }

        private void GiveKit(BasePlayer player)
        {
            foreach (KitEntry entry in config.Items)
            {
                if (entry == null || string.IsNullOrEmpty(entry.Shortname) || entry.Amount <= 0) continue;
                Item item = ItemManager.CreateByName(entry.Shortname, entry.Amount, 0UL);
                if (item == null) continue;
                if (!player.inventory.GiveItem(item))
                    item.Drop(player.transform.position + new Vector3(0f, 1f, 0f), Vector3.zero);
            }
            player.ChatMessage(Msg("KitGiven", player.UserIDString));
        }

        private void Unload()
        {
            lastGranted.Clear();
        }
    }
}