Initial commit: Implemented the plugin core (v1.0.0)

Author: foxdevtime

.gitignore

@@ -0,0 +1,118 @@
+# User-specific stuff
+.idea/
+
+*.iml
+*.ipr
+*.iws
+
+# IntelliJ
+out/
+# mpeltonen/sbt-idea plugin
+.idea_modules/
+
+# JIRA plugin
+atlassian-ide-plugin.xml
+
+# Compiled class file
+*.class
+
+# Log file
+*.log
+
+# BlueJ files
+*.ctxt
+
+# Package Files #
+*.jar
+*.war
+*.nar
+*.ear
+*.zip
+*.tar.gz
+*.rar
+
+# virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml
+hs_err_pid*
+
+*~
+
+# temporary files which can be created if a process still has a handle open of a deleted file
+.fuse_hidden*
+
+# KDE directory preferences
+.directory
+
+# Linux trash folder which might appear on any partition or disk
+.Trash-*
+
+# .nfs files are created when an open file is removed but is still being accessed
+.nfs*
+
+# General
+.DS_Store
+.AppleDouble
+.LSOverride
+
+# Icon must end with two \r
+Icon
+
+# Thumbnails
+._*
+
+# Files that might appear in the root of a volume
+.DocumentRevisions-V100
+.fseventsd
+.Spotlight-V100
+.TemporaryItems
+.Trashes
+.VolumeIcon.icns
+.com.apple.timemachine.donotpresent
+
+# Directories potentially created on remote AFP share
+.AppleDB
+.AppleDesktop
+Network Trash Folder
+Temporary Items
+.apdisk
+
+# Windows thumbnail cache files
+Thumbs.db
+Thumbs.db:encryptable
+ehthumbs.db
+ehthumbs_vista.db
+
+# Dump file
+*.stackdump
+
+# Folder config file
+[Dd]esktop.ini
+
+# Recycle Bin used on file shares
+$RECYCLE.BIN/
+
+# Windows Installer files
+*.cab
+*.msi
+*.msix
+*.msm
+*.msp
+
+# Windows shortcuts
+*.lnk
+
+.gradle
+build/
+
+# Ignore Gradle GUI config
+gradle-app.setting
+
+# Cache of project
+.gradletasknamecache
+
+**/build/
+
+# Common working directory
+run/
+
+# Avoid ignoring Gradle wrapper jar file (.jar files are usually ignored)
+!gradle-wrapper.jar

README.md

@@ -0,0 +1,103 @@
+# PotatoChat 🥔
+
+![Java](https://img.shields.io/badge/Java-8%2B-orange) ![Platform](https://img.shields.io/badge/Platform-Spigot%201.8%2B-blue) ![License](https://img.shields.io/badge/License-MIT-green)
+[![English](https://img.shields.io/badge/Language-English-blue)](README.md) [![Русский](https://img.shields.io/badge/Язык-Русский-red)](README_ru.md)
+
+**A lightweight, optimized, and customizable chat management solution.**
+Designed to replace bloated chat plugins. Features channel management, newbie protection, and full modern color support (RGB/HEX) while keeping resource usage at a minimum.
+
+---
+
+## ✨ Features
+
+*   **🚀 Highly Optimized:** Minimal resource usage, perfect for high-load servers (tested with spark!).
+*   **📢 Dynamic Channels:** Create unlimited chat channels (Local, Global, Staff, etc.) distinguished by prefixes.
+*   **🎨 Color Support:** Full support for Legacy colors (`&a`) and modern HEX colors (`&#RRGGBB`)
+*   **🛡️ Newbie Protection:** Automatically blocks chat and PM commands for new players until they reach a specific playtime.
+*   **⏱️ Anti-Spam:** Configurable cooldowns for each channel.
+*   **🔗 Integration:** Seamless support for **Vault** (Prefixes/Suffixes) and **PlaceholderAPI**.
+*   **🤖 Auto-Announcer:** Built-in broadcasting system with random or sequential messages.
+
+---
+
+## 📖 How to Use
+
+### Step 1: Channels Setup
+Configure your channels in `config.yml`. The plugin uses **prefixes** to determine where to send the message.
+*   **No Prefix:** Sends to the default channel (usually Local)
+*   **`!` Prefix:** Sends to Global chat (configurable)
+*   **`@` Prefix:** Sends to Staff chat (configurable)
+
+### Step 2: Permissions
+Grant permissions to your groups.
+*   `pchat.channel.global` -> To speak in global chat
+*   `pchat.staff` -> To see and speak in staff chat
+*   `pchat.rgb` -> To use HEX colors
+
+### Step 3: Newbie Protection
+By default, players with less than **10 minutes** of playtime cannot use:
+*   Chat (Global/Local)
+*   Private message commands (`/msg`, `/tell`, etc.)
+
+---
+
+## 🛠 Commands & Permissions
+
+| Command | Description | Permission |
+| :--- | :--- | :--- |
+| `/pchat reload` | Reloads the configuration file | `pchat.admin` (default: OP) |
+
+| Permission Node | Description | Default |
+| :--- | :--- | :--- |
+| `pchat.bypass.cooldown` | Bypasses channel cooldowns | OP |
+| `pchat.bypass.newbie` | Bypasses newbie restrictions | OP |
+| `pchat.color` | Allows standard color codes (`&`) | OP |
+| `pchat.rgb` | Allows HEX color codes (`&#`) | OP |
+
+---
+
+## ⚙️ Configuration
+
+The `config.yml` allows you to customize every aspect of the chat.
+
+### Channel Configuration Example
+```yaml
+channels:
+  local:
+    format: "&7[L] {prefix}&r {player}&7: &f{message}"
+    radius: 100     # Message visible within 100 blocks
+    prefix: ""      # Default chat
+    cooldown: 3
+
+  global:
+    format: "&a[G] {prefix}&r &c{player} {suffix}&7: &f{message}"
+    radius: -1      # -1 = Global visibility
+    prefix: "!"     # Trigger: "!Hello world"
+    permission: "pchat.channel.global"
+```
+
+### Auto-Messages Example
+```yaml
+auto-messages:
+  enabled: true
+  interval: 300   # Seconds
+  list:
+    1: ["&aWelcome to the server!"]
+    2: ["&bDon't forget to join our Discord."]
+```
+
+---
+
+## 📥 Installation
+
+1.  Ensure you are running **Spigot/Paper 1.8** or higher.
+2.  Download the latest release `.jar`.
+3.  Drop the file into your server's `/plugins` folder.
+4.  (Optional) Install **Vault** and **PlaceholderAPI** for full functionality.
+5.  Restart the server.
+
+---
+
+<p align="center">
+Made with ❤️ and 🥔 by foxdevtime
+</p>

README_ru.md

@@ -0,0 +1,103 @@
+# PotatoChat 🥔
+
+![Java](https://img.shields.io/badge/Java-8%2B-orange) ![Platform](https://img.shields.io/badge/Platform-Spigot%201.8%2B-blue) ![License](https://img.shields.io/badge/License-MIT-green)
+[![English](https://img.shields.io/badge/Language-English-blue)](README.md) [![Русский](https://img.shields.io/badge/Язык-Русский-red)](README_ru.md)
+
+**Лёгкое, оптимизированное и настраиваемое решение для управления чатом.**
+Создан для замены тяжеловесных плагинов чата. Включает управление каналами, защиту от спама новичков и полную поддержку современных цветов (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` позволяет настроить каждый аспект чата.
+
+### Пример настройки каналов
+```yaml
+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"
+```
+
+### Пример авто-сообщений
+```yaml
+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.  Перезапустите сервер.
+
+---
+
+<p align="center">
+Сделано с ❤️ и 🥔 от foxdevtime
+</p>

build.gradle

@@ -0,0 +1,69 @@
+plugins {
+    id 'java'
+    id("xyz.jpenilla.run-paper") version "2.3.1"
+}
+
+group = 'xyz.foxdevtime'
+version = '1.0.0'
+
+def api_mc_ver = '1.13'
+
+repositories {
+    mavenCentral()
+    maven {
+        name = "spigotmc-repo"
+        url = "https://hub.spigotmc.org/nexus/content/repositories/snapshots/"
+    }
+    maven {
+        name = "sonatype"
+        url = "https://oss.sonatype.org/content/groups/public/"
+    }
+    maven {
+        url = 'https://repo.extendedclip.com/content/repositories/placeholderapi/'
+    }
+    maven {
+        url = 'https://jitpack.io'
+    }
+}
+
+dependencies {
+    compileOnly "org.spigotmc:spigot-api:1.16.5-R0.1-SNAPSHOT"
+    compileOnly 'com.github.MilkBowl:VaultAPI:1.7'
+    compileOnly 'me.clip:placeholderapi:2.11.5'
+}
+
+tasks {
+    runServer {
+        // Configure the Minecraft version for our task.
+        // This is the only required configuration besides applying the plugin.
+        // Your plugin's jar (or shadowJar if present) will be used automatically.
+        minecraftVersion("1.16.5")
+    }
+}
+
+def targetJavaVersion = 8
+java {
+    def javaVersion = JavaVersion.toVersion(targetJavaVersion)
+    sourceCompatibility = javaVersion
+    targetCompatibility = javaVersion
+    if (JavaVersion.current() < javaVersion) {
+        toolchain.languageVersion = JavaLanguageVersion.of(targetJavaVersion)
+    }
+}
+
+tasks.withType(JavaCompile).configureEach {
+    options.encoding = 'UTF-8'
+
+    if (targetJavaVersion >= 10 || JavaVersion.current().isJava10Compatible()) {
+        options.release.set(targetJavaVersion)
+    }
+}
+
+processResources {
+    def props = [version: version, api_mc_ver: api_mc_ver]
+    inputs.properties props
+    filteringCharset 'UTF-8'
+    filesMatching('plugin.yml') {
+        expand props
+    }
+}