How to make a Rust animal spawn plugin (chat command, capped count)

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

namespace Oxide.Plugins
{
    [Info("Animal Spawner", "RustPluginGenerator", "1.0.0")]
    [Description("Adds a permission-gated /animal command that spawns vanilla animals in front of the player.")]
    public class AnimalSpawner : RustPlugin
    {
        private const string PermUse = "animalspawner.use";
        private const string PermAdmin = "animalspawner.admin";

        private PluginConfig config;
        private readonly Dictionary<ulong, float> lastUse = new Dictionary<ulong, float>();
        private int totalSpawned;

        private class PluginConfig
        {
            [JsonProperty("Maximum animals per command")]
            public int MaxPerCommand { get; set; } = 10;

            [JsonProperty("Spawn distance in front of player")]
            public float SpawnDistance { get; set; } = 4f;

            [JsonProperty("Per-player cooldown in seconds")]
            public float CooldownSeconds { get; set; } = 3f;

            [JsonProperty("Species prefabs")]
            public Dictionary<string, string> Species { get; set; } = new Dictionary<string, string>
            {
                ["bear"] = "assets/rust.ai/agents/bear/bear.prefab",
                ["wolf"] = "assets/rust.ai/agents/wolf/wolf.prefab",
                ["boar"] = "assets/rust.ai/agents/boar/boar.prefab",
                ["stag"] = "assets/rust.ai/agents/stag/stag.prefab",
                ["chicken"] = "assets/rust.ai/agents/chicken/chicken.prefab"
            };
        }

        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>
            {
                ["Usage"] = "Usage: /animal <species> [count]. Available: {0}",
                ["UnknownSpecies"] = "Unknown species '{0}'. Use /animal list to see valid keys.",
                ["SpeciesList"] = "Available species: {0}",
                ["CapApplied"] = "Requested count {0} was capped to {1}.",
                ["Cooldown"] = "Wait {0:0.0}s before spawning again.",
                ["Spawned"] = "Spawned {0}x {1}.",
                ["SpawnFailed"] = "Failed to spawn {0}x {1}. Check the prefab path in the config.",
                ["Partial"] = "Spawned {0}x {1}, {2} failed. Check the prefab path in the config.",
                ["ConsoleUsage"] = "Usage: animalspawner.spawn <species> [count] <player name or id>",
                ["ConsoleNoPlayer"] = "Player '{0}' was not found.",
                ["NoPermission"] = "You do not have permission to use this command."
            }, this);
        }

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

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

        private void Unload()
        {
            lastUse.Clear();
            Puts($"AnimalSpawner unloaded. Animals spawned this session: {totalSpawned}");
        }

        [ChatCommand("animal")]
        private void CmdAnimal(BasePlayer player, string command, string[] args)
        {
            if (player == null) return;
            if (!permission.UserHasPermission(player.UserIDString, PermUse))
            {
                player.ChatMessage(Msg("NoPermission", player.UserIDString));
                return;
            }

            if (args == null || args.Length == 0)
            {
                player.ChatMessage(Msg("Usage", player.UserIDString, string.Join(", ", Keys())));
                return;
            }

            if (args[0].Equals("list", StringComparison.OrdinalIgnoreCase))
            {
                player.ChatMessage(Msg("SpeciesList", player.UserIDString, string.Join(", ", Keys())));
                return;
            }

            string species = args[0].ToLowerInvariant();
            string prefab;
            if (config.Species == null || !config.Species.TryGetValue(species, out prefab) || string.IsNullOrEmpty(prefab))
            {
                player.ChatMessage(Msg("UnknownSpecies", player.UserIDString, args[0]));
                return;
            }

            int count = 1;
            if (args.Length > 1 && !int.TryParse(args[1], out count)) count = 1;
            if (count < 1) count = 1;
            int capped = Mathf.Min(count, Mathf.Max(1, config.MaxPerCommand));
            if (capped < count) player.ChatMessage(Msg("CapApplied", player.UserIDString, count, capped));

            float now = Time.realtimeSinceStartup;
            float last;
            if (config.CooldownSeconds > 0f && lastUse.TryGetValue(player.userID.Get(), out last))
            {
                float remaining = config.CooldownSeconds - (now - last);
                if (remaining > 0f)
                {
                    player.ChatMessage(Msg("Cooldown", player.UserIDString, remaining));
                    return;
                }
            }
            lastUse[player.userID.Get()] = now;

            Vector3 origin = player.eyes.position + player.eyes.HeadForward() * config.SpawnDistance;
            int ok, failed;
            SpawnBatch(prefab, origin, capped, out ok, out failed);

            if (failed == 0)
                player.ChatMessage(Msg("Spawned", player.UserIDString, ok, species));
            else if (ok == 0)
                player.ChatMessage(Msg("SpawnFailed", player.UserIDString, failed, species));
            else
                player.ChatMessage(Msg("Partial", player.UserIDString, ok, species, failed));
        }

        [ConsoleCommand("animalspawner.spawn")]
        private void CcmdSpawn(ConsoleSystem.Arg arg)
        {
            if (arg == null) return;

            string species = arg.GetString(0, string.Empty).ToLowerInvariant();
            int count = arg.GetInt(1, 1);
            string target = arg.GetString(2, string.Empty);

            if (string.IsNullOrEmpty(species) || string.IsNullOrEmpty(target))
            {
                arg.ReplyWith(Msg("ConsoleUsage"));
                return;
            }

            BasePlayer player = BasePlayer.FindAwakeOrSleeping(target);
            if (player == null)
            {
                arg.ReplyWith(Msg("ConsoleNoPlayer", null, target));
                return;
            }

            if (!permission.UserHasPermission(player.UserIDString, PermAdmin) && !arg.IsAdmin)
            {
                arg.ReplyWith(Msg("NoPermission"));
                return;
            }

            string prefab;
            if (config.Species == null || !config.Species.TryGetValue(species, out prefab) || string.IsNullOrEmpty(prefab))
            {
                arg.ReplyWith(Msg("UnknownSpecies", null, species));
                return;
            }

            int capped = Mathf.Min(Mathf.Max(1, count), Mathf.Max(1, config.MaxPerCommand));
            Vector3 origin = player.eyes.position + player.eyes.HeadForward() * config.SpawnDistance;
            int ok, failed;
            SpawnBatch(prefab, origin, capped, out ok, out failed);

            arg.ReplyWith(failed == 0
                ? Msg("Spawned", null, ok, species)
                : Msg("Partial", null, ok, species, failed));
        }

        private void SpawnBatch(string prefab, Vector3 origin, int count, out int ok, out int failed)
        {
            ok = 0;
            failed = 0;
            for (int i = 0; i < count; i++)
            {
                Vector3 offset = UnityEngine.Random.insideUnitSphere * 1.5f;
                offset.y = 0f;
                BaseEntity entity = GameManager.server.CreateEntity(prefab, origin + offset, Quaternion.identity);
                if (entity == null)
                {
                    failed++;
                    continue;
                }
                entity.Spawn();
                ok++;
                totalSpawned++;
            }
        }

        private List<string> Keys()
        {
            var list = new List<string>();
            if (config.Species != null)
                foreach (var key in config.Species.Keys) list.Add(key);
            return list;
        }
    }
}