Ядро плагина TagsManager 1.0

using CounterStrikeSharp.API.Core;

public interface ITagsApi
{
    /// <summary>
    /// Устанавливает (или обновляет) клан-тег для указанного игрока с заданным приоритетом.
    /// При этом:
    /// 1. Если у игрока уже был клан-тег с тем же приоритетом, он будет заменён на новый.
    /// 2. Если у игрока есть несколько клан-тегов с разными приоритетами,
    ///    отображаться будет тег с наибольшим «весом» приоритета, но по вашей логике
    ///    чем МЕНЬШЕ число, тем ВЫШЕ приоритет. То есть приоритет 1 «важнее», чем приоритет 2 и т.д.
    /// </summary>
    /// <param name="player">
    /// Игрок, которому будет установлен (или обновлён) клан-тег.
    /// </param>
    /// <param name="clanTag">
    /// Строка, описывающая клан-тег (например, "MyClan -").
    /// Если указать пустую строку <c>""</c>, будет установлен «пустой» клан-тег.
    /// </param>
    /// <param name="priority">
    /// Числовое значение, определяющее приоритет (важность) клан-тега.
    /// Чем МЕНЬШЕ это число, тем «выше» считается его приоритет.
    /// Например, приоритет 1 отображается «раньше» (важнее), чем приоритет 2.
    /// </param>
    void SetClanTag(CCSPlayerController player, string clanTag, int priority);

    /// <summary>
    /// Удаляет у игрока конкретный клан-тег с указанным приоритетом.
    /// Если среди тегов игрока не найдётся тег с таким же названием и приоритетом,
    /// то ничего удалено не будет.
    /// </summary>
    /// <param name="player">
    /// Игрок, у которого необходимо удалить клан-тег.
    /// </param>
    /// <param name="clanTag">
    /// Тот самый клан-тег, который ранее был установлен через
    /// <see cref="SetClanTag(CCSPlayerController, string, int)"/>.
    /// Важно, чтобы название тега (включая регистр, пробелы и символы) совпадало полностью.
    /// </param>
    /// <param name="priority">
    /// Приоритет клан-тега, который требуется удалить.
    /// Должен совпадать с тем, что был указан при установке.
    /// (Например, если тег был установлен с приоритетом 1, то именно 1 нужно и указывать)
    /// </param>
    void RemoveClanTag(CCSPlayerController player, string clanTag, int priority);

    /// <summary>
    /// Возвращает приоритет заданного клан-тега у игрока, если такой тег существует.
    /// </summary>
    /// <param name="player">
    /// Игрок, чьи клан-теги проверяются.
    /// </param>
    /// <param name="clanTag">
    /// Тот самый клан-тег, приоритет которого нужно получить.
    /// </param>
    /// <returns>
    /// Числовое значение приоритета, если тег у игрока найден, в противном случае <c>null</c>.
    /// Обратите внимание, что в текущей логике чем МЕНЬШЕ число, тем ВЫШЕ приоритет.
    /// </returns>
    int? GetClanTagPriority(CCSPlayerController player, string clanTag);
}