О плагине

RPCplugin— это многофункциональный плагин для Minecraft серверов, ориентированный на RolePlay проекты. Плагин добавляет чат, команды, модерацию и развлекательные функции.

🎯 Основные возможности
Чат Глобальный(!), локальный, шепот(~), цвета, спойлеры, форматирование
Команды - 35+ команд (рандом, монетка, кубик, RPS, магический шар, AFK)
Модерация - Баны, муты, кики, игнор, логи
Общение - Личные сообщения, почта (оффлайн)
РП Действия - (/me), попытки (/try)
Анонсы - Стримы, видео, глобальные сообщения, боссбар
Утилиты - Координаты, статистика, пинг, геолокация
Прочее - Цвета, переводы (RU/EN), антиспам, фильтр мата

📋 Требования

- Java 21+

- рекомендуется версия не ниже 1.20.5
- LuckPerms

🔗 Ссылки

- Скачать: [ссылка на скачивание]
- Поддержка:

Дискорд discord.gg/vTqZeCKgWq

Телеграмм t.me/Dimapro09

Команды

/rp help номер_страницы - команда, выводящая все доступные команды в плагине

🎲 Команды на удачу

/random [min] [max] - Случайное число (по умолч. 1-11)

/coin - Подбросить монетку (Орёл/Решка)

/rps - Камень-Ножницы-Бумага (рандомный выбор)

/cube [количество] - Бросить кубик (1-10 штук)

🎭 RP команды

/me <действие> - Описать действие персонажа от первого лица

/try <действие> - Выполнить действие с шансом 50/50 (показывает процент)

/8ball <вопрос> - Задать вопрос магическому шару

/afk [причина] - Режим "Отошёл" (движение или чат выведут)

📢 Анонсы (требуют права)

/stream <ссылка> [сообщение] - Анонсировать стрим

/video <ссылка> [сообщение] - Анонсировать новое видео

👑 Админские команды

/ban <игрок> <время|perm> <причина> - Забанить игрока

/unban <игрок> - Разбанить игрока

/mute <игрок> <время> <причина> - Замутить игрока

/unmute <игрок> - Размутить игрока

/kick <игрок> <причина> - Кикнуть игрока

/banlist - Список забаненных игроков

/toponline - Топ игроков по наигранному времени

/logs [страница] - Просмотр логов модерации

/tell <игрок> <сообщение> - Отправить личное сообщение

/ignore [игрок] - Игнорировать игрока (повторно — убрать)

/coordinates [игрок] - Показать свои координаты или другого игрока

/statistics [игрок] - Показать статистику игрока

/geolocate [игрок] - Геолокация по IP

/mail send/read/clear/check - Почта

/broadcast <сообщение> - Глобальное сообщение всем игрокам

/clearchat - Очистить чат

/ping [игрок] - Показать свой пинг или другого игрока

/bossbar create/remove/list - Создать боссбар (цвет, стиль, время, сообщение)

Пример /bossbar create blue segmented_10 10s &6 &l КУ

/helpchat [страница] - Помощь по чату (вставки, цвета, форматирование)

🔧 Админские команды RPADMIN

/rpadmin lock <пароль> - Заблокировать плагин

/rpadmin unlock <пароль> - Разблокировать плагин

/rpadmin announce <сообщение> - Сделать серверный анонс (с цветами)

/rpadmin reload - Перезагрузить конфигурацию и языки

/rpadmin topupdate - Принудительно обновить кеш топа онлайн

/rpadmin geoclear - Очистить кеш геолокации

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

После установки плагина в папке plugins/RpCplugin/ создаётся файл config.yml. Вот его полная структура с описанием всех параметров:

profanity-filter.enabled - trueВключение фильтра мата

profanity-filter.replacement - ***Символы замены мата

profanity-filter.words -Список запрещённых слов

cooldowns. -Задержки команд в секундах

После изменения config.yml нужно перезагрузить конфигурацию командой:text/rpadmin reload

Или перезагрузить сервер

Переменные в чате

В плагине есть специальные переменные, которые можно использовать в обычном чате . При отправке сообщения переменная автоматически заменяется на нужную информацию.

%ping% Пинг игрока в миллисекундах

%cords% Координаты игрока (мир, биом, XYZ)

%stats%Статистика игрока

Включить и отключить их можно в конфиге

Форматирование чата

/helpchat - вывод информацию об возможностях форматирования

1) цвета и шрифты

Плагин поддерживает стандартное форматирование через &(нужно спец право)

2) собственные вариации

**текст**- жирный текст

##текст## - Курсив

__текст__ -Подчёркнутый

~~текст~~ -Зачёркнутый (Примечание, сообщение не может начинаться с него,т.к символ ~ также используется для чата"шепот")

||текст|| - Спойлер

??текст?? - Запутанный

Права

Административные права

rpplugin.admin — Полный доступ ко всем командам плагина. Только для операторов сервера.

rpplugin.admin.reload — Позволяет перезагружать конфигурацию плагина через команду /rpadmin reload.

rpplugin.announce — Позволяет отправлять серверные анонсы через команду /rpadmin announce.

rpplugin.bypass.antispam — Игнорирует антиспам (можно писать часто без задержек).

rpplugin.bypass.profanity — Игнорирует фильтр мата (можно использовать запрещённые слова).

Модераторские права

rpplugin.ban — Позволяет банить игроков через команду /ban.

rpplugin.unban — Позволяет разбанивать игроков через команду /unban.

rpplugin.mute — Позволяет мутить игроков через команду /mute.

rpplugin.unmute — Позволяет размучивать игроков через команду /unmute.

rpplugin.kick — Позволяет кикать игроков через команду /kick.

rpplugin.logs — Позволяет просматривать логи модерации через команду /logs.

rpplugin.geolocate — Позволяет получать геолокацию игроков по IP через команду /geolocate.

Защита от модерации

rpplugin.ban.bypass — Защита от бана. Игрока с этим правом нельзя забанить.

rpplugin.ban.override — Игнорирует защиту от бана. Позволяет забанить даже игрока с rpplugin.ban.bypass.

rpplugin.mute.bypass — Защита от мута. Игрока с этим правом нельзя замутить.

rpplugin.mute.override — Игнорирует защиту от мута. Позволяет замутить даже игрока с rpplugin.mute.bypass.

Права для всех игроков (по умолчанию)

rpplugin.afk — Позволяет использовать команду /afk.

rpplugin.tell — Позволяет отправлять личные сообщения через /tell.

rpplugin.ignore — Позволяет игнорировать других игроков через /ignore.

rpplugin.coordinates — Позволяет смотреть координаты через /coordinates.

rpplugin.statistics — Позволяет смотреть статистику игрока через /statistics.

rpplugin.toponline — Позволяет смотреть топ игроков по времени через /toponline.

rpplugin.ping — Позволяет смотреть пинг через /ping.

rpplugin.helpchat — Позволяет использовать команду /helpchat.

Права для контент-мейкеров (опционально)

rpplugin.stream — Позволяет использовать команду /stream для анонса стримов.

rpplugin.video — Позволяет использовать команду /video для анонса видео.

rpplugin.chatcolor — Позволяет использовать цветные коды (&c, &l и т.д.) в чате и команду /colors.

Права для администраторов боссбаров

rpplugin.bossbar — Позволяет создавать боссбары через команду /bossbar.

Права для массовых оповещений

rpplugin.broadcast — Позволяет отправлять глобальные сообщения через /broadcast.

rpplugin.clearchat — Позволяет очищать чат через /clearchat.

Переводы

Плагин поддерживает множество языков. Достаточно создать новый файл перевода, и плагин автоматически подхватит его.

На данный момент есть два языка - русский (ru.yml) и английский (en.yml)

Все языковые файлы хранятся в папке: plugins/RPCplugin/lang/

⚙️ Как сменить язык

В файле config.yml измени значение параметра:

language: ru      # русский

После изменения выполните:

/rpadmin reload

➕ Как добавить новый язык

В папке plugins/RpCplugin/lang/ создайте файл с кодом языка, например:

• de.yml — для немецкого

2. Скопируйте структуру

Скопируйте содержимое ru.yml или en.yml в новый файл.

3. Переведите сообщения

Замените текст после двоеточия на нужный язык. Цветовые коды (&c, &l и т.д.) и переменные (%player%, %time% и т.д.) оставляйте без изменений.

4. Укажите язык в конфиге

yaml

language: de

5. Перезагрузите плагин

text

/rpadmin reload

⚠️ Важно

• Не переводите цветовые коды (&c, &l, &n, &o, &m, &r)
• Не переводите переменные (%player%, %time%, %reason%, %ping% и т.д.)
• Не переводите названия команд (они должны оставаться на английском)
• Сохраняйте структуру — не меняйте названия ключей (то, что слева от двоеточия)

🔧 Обновление переводов

При обновлении плагина новые ключи автоматически добавятся в существующие языковые файлы. Ваши переводы не потеряются.

🧪 Проверка перевода

Если в переводе есть ошибка, плагин покажет вместо сообщения:

text

Missing translation: ban.success_temp

Так вы сразу увидите, какой ключ нужно перевести.

Кастомизация сообщений

Плагин позволяет изменять почти все сообщения без перекомпиляции — через языковые файлы. Вы можете настроить текст, цвета, эмодзи и форматирование под свой сервер.

🎨 Что можно изменить

Текст сообщений — меняется в языковых файлах (lang/ru.yml или lang/en.yml). Можно изменить любое сообщение на любой язык или просто переписать под свой сервер.

Цвета — меняются с помощью кодов &c, &6, &e, &a и других. Можно сделать сообщения красными, зелёными, золотыми — любыми цветами радуги.

Эмодзи — можно заменить стандартные эмодзи (🎲, 🎭, 📢, 👑, ⚙️) на любые другие или вообще убрать.

Форматирование — поддерживается жирный текст (&l), курсив (&o), подчёркнутый (&n) и зачёркнутый (&m). Можно комбинировать с цветами.

Префикс плагина — меняется через параметр prefix в языковом файле. Например, prefix: "&8[&6MyServer&8]&r".

Заголовки в /rp help — все 6 заголовков страниц можно изменить на свои. Например, вместо "КОМАНДЫ НА УДАЧУ" написать "ВЕЗЕНИЕ И УДАЧА".

Описания команд — описания для /rp help можно переписать под свой сервер. Например, вместо "случайное число от 1 до 11" написать "рандом от 1 до 100".

Сообщения об ошибках — все сообщения о недостатке прав, кулдаунах, ошибках ввода — можно переписать в более дружелюбном или строгом стиле.

🔧 Как применить изменения

1. Отредактируйте файл в папке plugins/RpCplugin/lang/
2. Сохраните изменения
3. Введите в игре команду: /rpadmin reload
4. Проверьте результат

⚠️ Важно

Не меняйте ключи — то, что слева от двоеточия (например, ban.success_temp), должно оставаться как есть. Менять можно только текст справа.

Не меняйте переменные — %player%, %time%, %reason%, %ping% будут заменены на реальные значения, поэтому их нельзя удалять или изменять.