TagsManager 1.0.0

використовуючи 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);

}