ChatViramble

🇬🇧 English version

🌟 ChatViramble v1.3 | The Ultimate Chat Management

Welcome to ChatViramble — a highly optimized, feature-rich chat management plugin designed to bring your server's communication to the next level. Whether you are running a small survival server or a massive network, ChatViramble provides immersive mechanics, zero-lag database saving, and complete control over local and global chats.

🔗 Useful Links & Support: 👾 Support Discord: Join our Discord — Get help, report bugs, or ask questions!

🔥 What's new in version 1.3 "Reliability & Control": ⚡ Async SQLite Database: All player GUI preferences and ignore lists are now safely stored in a local database using background tasks. This ensures zero lag and absolutely no TPS drops on your server, even with hundreds of players online.

🕵️ Admin Spy Mode (/spy): A brand-new moderation tool that allows staff members to silently read all local chats bypassing the distance limit. Messages are cleanly marked with a [SPY] tag. Your spy status is safely saved across server restarts.

🎨 Color Chat Support: Added support for color and formatting codes (&a, &l, &n, etc.) in chat for players with specific permissions. Perfect for VIPs and premium ranks.

🌍 Smart Localization: The plugin now automatically generates complete translation files (en.yml, ru.yml). English is now the default language. Everything is fully translatable, including GUI menus, system alerts, and command errors.

🛠 Deep RAM Optimization: Added an automatic memory cleanup system for disconnected players to prevent memory leaks and ensure 24/7 server stability. Console logs have also been standardized to English for better compatibility with server hosts.

✨ Main Features: Local & Global Chat: Radius-based local chat (58 blocks by default, configurable) and a global shout channel using the ! prefix.

Smart Anti-Spam: An intelligent cooldown system that prevents chat flooding with visual on-screen alerts (Titles). It smartly ignores short everyday phrases (up to 3 characters) to allow natural, fast-paced conversations without annoying delays.

Advanced Mentions System: Typing a player's name in the chat highlights it in gold and plays a pleasant amethyst chime sound for the mentioned player, ensuring they never miss a message.

Immersive Feedback: Sending a message spawns beautiful musical note particles above the player's head. Nearby players hear a satisfying "pop" sound when receiving a local message. If no one is around to hear you, the plugin sends a smart Action Bar warning so you don't talk to yourself.

GUI Settings Menu: A sleek, interactive inventory menu where players can personally toggle their chat sounds or disable incoming private messages with a single click.

Ultimate Integration: Native support for LuckPerms, Vault (for prefixes/suffixes), and full PlaceholderAPI compatibility (add any custom stats to your chat format). Built-in bStats tracking.

💻 Commands: /chat — Opens the personal GUI settings menu (toggle sounds and private messages).

/msg

/reply

/ignore — Adds or removes a player from your personal blacklist. Blocked players cannot send you private messages or mention you, and their local messages will be hidden.

/spy — Toggles the admin spy mode to monitor local chat conversations server-wide.

🔐 Permissions: chatviramble.msg — Access to private messages (/msg, /reply).

chatviramble.ignore — Access to the personal ignore system (/ignore).

chatviramble.chat — Access to the personal chat settings GUI (/chat).

chatviramble.spy — Access to the /spy command and chat monitoring.

chatviramble.color — Allows the use of color codes in chat messages.

🇷🇺 Русская версия

🌟 ChatViramble v1.3 | Идеальный контроль чата

Добро пожаловать в ChatViramble — многофункциональный и невероятно оптимизированный плагин для управления чатом. Независимо от того, держите ли вы уютный сервер выживания или крупный проект, ChatViramble обеспечит погружение в игру, работу без лагов (благодаря асинхронной БД) и полный контроль над общением игроков.

🔗 Полезные ссылки и Поддержка: 👾 Discord Сообщество: Присоединиться — Техническая поддержка, вопросы и предложения!

🔥 Что нового в версии 1.3 "Надежность и Контроль": ⚡ Асинхронная БД (SQLite): Все личные настройки игроков (GUI) и черные списки теперь надежно сохраняются в базу данных в фоновом режиме. Это гарантирует отсутствие любых фризов и просадок TPS на сервере даже при огромном онлайне.

🕵️ Режим "Шпиона" (/spy): Мощный новый инструмент для модерации. Позволяет администрации скрыто читать весь локальный чат игроков на сервере в обход дистанции (сообщения помечаются тегом [SPY]). Состояние прослушки сохраняется даже при перезапуске сервера.

🎨 Цветной чат: Добавлена возможность использовать цветовые коды и форматирование (&a, &l, &n и т.д.) для игроков с определенными правами. Отличная фишка для поощрения VIP-игроков.

🌍 Умная локализация: Плагин теперь самостоятельно генерирует файлы перевода (en.yml, ru.yml), при этом английский установлен по умолчанию. Переведено абсолютно всё: интерфейс меню, системные сообщения и ошибки команд.

🛠 Оптимизация ОЗУ: Добавлена система автоматической очистки памяти от кэша вышедших игроков. Это предотвращает утечки памяти при долгой работе сервера. Системные логи консоли переведены на английский язык по стандартам хостингов.

✨ Главные особенности плагина: Локальный и Глобальный чат: Общение в локальном радиусе (по умолчанию 58 блоков, настраивается) или на весь сервер, начиная сообщение с символа !.

Умный Анти-спам: Интеллектуальная задержка сообщений с визуальными предупреждениями (Title). Короткие слова (до 3 символов) пропускаются без задержки, чтобы не мешать быстрому и живому диалогу игроков.

Продвинутая система упоминаний: Если написать ник игрока в чате, он подсветится золотым цветом, а сам игрок услышит приятный звук колокольчика аметиста.

Погружение и Эффекты: При отправке сообщения над головой игрока появляются частицы нот. Соседи слышат звук при получении сообщения. Если рядом никого нет, отправитель получит аккуратное уведомление в Action Bar, чтобы не говорить в пустоту.

GUI Настройки чата: Удобное меню в виде инвентаря, где каждый игрок может в один клик выключить звуки чата или запретить отправлять себе личные сообщения.

Полная Интеграция: Нативная поддержка LuckPerms, Vault (для префиксов) и полная совместимость с PlaceholderAPI (выводите любую статистику в формате чата). Встроена метрика bStats.

💻 Команды: /chat — Открывает GUI меню личных настроек чата (звуки и ЛС).

/msg <ник> <текст> — Отправляет приватное личное сообщение другому игроку.

/reply <текст> — Быстрый ответ последнему собеседнику (с кем вы вели диалог).

/ignore <ник> — Добавляет или удаляет игрока из черного списка. Заблокированные игроки не смогут писать вам в ЛС, упоминать вас, а их локальные сообщения будут скрыты.

/spy — Включает или выключает режим скрытой прослушки локального чата для администрации.

🔐 Права (Permissions): chatviramble.msg — Доступ к личным сообщениям (/msg, /reply).

chatviramble.ignore — Доступ к блокировке игроков (/ignore).

chatviramble.chat — Доступ к меню личных настроек чата (/chat).

chatviramble.spy — Доступ к команде /spy и прослушке локального чата.

chatviramble.color — Разрешает использовать цветовые коды в сообщениях.