Skip to content

README_ru.md

Latest commit

 

History

History
103 lines (78 loc) · 5.74 KB

README_ru.md

File metadata and controls

103 lines (78 loc) · 5.74 KB

PotatoChat 🥔

Java Platform License English Русский

Лёгкое, оптимизированное и настраиваемое решение для управления чатом. Создан для замены тяжеловесных плагинов чата. Включает управление каналами, защиту от спама новичков и полную поддержку современных цветов (RGB/HEX), сохраняя при этом минимальное потребление ресурсов.

✨ Возможности

  • 🚀 Высокая оптимизация: Минимальное использование ресурсов, идеально подходит для нагруженных серверов (проверено через spark!).
  • 📢 Динамические каналы: Создавайте неограниченное количество каналов (Локальный, Глобальный, Персонал и т.д.), разделяемых префиксами.
  • 🎨 Поддержка цветов: Полная поддержка классических цветов (&a) и современных HEX-цветов (&#RRGGBB).
  • 🛡️ Защита от новичков: Автоматически блокирует чат и команды ЛС для новых игроков, пока они не наиграют определённое время.
  • ⏱️ Анти-спам: Настраиваемая задержка (кулдаун) для каждого канала.
  • 🔗 Интеграция: Бесшовная поддержка Vault (Префиксы/Суффиксы) и PlaceholderAPI.
  • 🤖 Авто-сообщения: Встроенная система объявлений с возможностью случайного или последовательного выбора сообщений.

📖 Как использовать

Шаг 1: Настройка каналов

Настройте каналы в config.yml. Плагин использует префиксы (символы перед сообщением), чтобы определить, куда отправить текст.

  • Без префикса: Отправляет в канал по умолчанию (обычно Локальный).
  • Префикс !: Отправляет в Глобальный чат (настраивается).
  • Префикс @: Отправляет в чат Персонала (настраивается).

Шаг 2: Права (Permissions)

Выдайте права вашим группам игроков.

  • pchat.channel.global -> Чтобы писать в глобальный чат.
  • pchat.staff -> Чтобы видеть и писать в чат персонала.
  • pchat.rgb -> Чтобы использовать HEX-цвета.

Шаг 3: Защита от новичков

По умолчанию игроки, наигравшие менее 10 минут, не могут использовать:

  • Чат (Глобальный/Локальный).
  • Команды личных сообщений (/msg, /tell и т.д.).

🛠 Команды и Права

Команда Описание Право
/pchat reload Перезагружает конфигурационный файл pchat.admin (по умолч.: OP)
Узел прав (Permission Node) Описание По умолчанию
pchat.bypass.cooldown Обход задержки (кулдауна) чата OP
pchat.bypass.newbie Обход ограничений для новичков OP
pchat.color Разрешает стандартные цветовые коды (&) OP
pchat.rgb Разрешает HEX-цвета (&#) OP

⚙️ Конфигурация

Файл config.yml позволяет настроить каждый аспект чата.

Пример настройки каналов

channels:
  local:
    format: "&7[L] {prefix}&r {player}&7: &f{message}"
    radius: 100     # Сообщение видно в радиусе 100 блоков
    prefix: ""      # Чат по умолчанию (без символа)
    cooldown: 3

  global:
    format: "&a[G] {prefix}&r &c{player} {suffix}&7: &f{message}"
    radius: -1      # -1 = Видно на всём сервере
    prefix: "!"     # Триггер: "!Привет мир"
    permission: "pchat.channel.global"

Пример авто-сообщений

auto-messages:
  enabled: true
  interval: 300   # Секунды
  list:
    1: ["&aДобро пожаловать на сервер!"]
    2: ["&bНе забудьте зайти в наш Discord."]

📥 Установка

  1. Убедитесь, что ваш сервер работает на Spigot/Paper 1.8 или выше.
  2. Скачайте .jar файл последнего релиза.
  3. Поместите файл в папку /plugins вашего сервера.
  4. (Опционально) Установите Vault и PlaceholderAPI для полного функционала.
  5. Перезапустите сервер.

Сделано с ❤️ и 🥔 от foxdevtime