RPG-Factions

# RPG-Factions 1.23.0 **Автор: minimalka** RPG-Factions — комплексный плагин фракций и городского RP для Minecraft-серверов. Он объединяет управление организациями, ранги, рабочие смены, казну, государственные службы, СМИ, розыск, наручники, документы, медицину, образование, мафию и городской банк в одной системе. Плагин рассчитан на серверы, где игрок не создаёт собственную фракцию, а вступает в заранее настроенную организацию по приглашению руководства или решению администратора. Все основные тексты, меню, цены, права рангов, RP-предметы и параметры игровых механик редактируются через YAML-конфигурации. ## Основные возможности ### Фракции и ранги - Готовые фракции: мэрия, полиция, СМИ, армия, больница, школа и мафия. - Поддержка любых дополнительных фракций через конфигурацию. - У каждой фракции есть название, описание, цвет, регион WorldGuard, база, состав, казна, отношения и собственная система рангов. - Для рангов настраиваются название, префикс, уровень, зарплата и внутренние права. - Лидер и заместитель могут приглашать игроков; приглашение принимается командой `/f accept` или кнопкой в чате. - Самостоятельное создание фракций и свободное вступление через `/f join <id>` отключены. - Администратор может назначать лидера, принудительно добавлять игрока, выдавать конкретный ранг и исключать даже офлайн-участников. - Префиксы синхронизируются с LuckPerms. ### Лидерское GUI Команда `/f menu` открывает интерфейс управления фракцией. Руководство может: - просматривать участников, включая офлайн-игроков; - повышать, понижать и исключать участников; - создавать, переименовывать и удалять ранги; - менять префикс, уровень и зарплату ранга; - менять название, описание и цвет фракции; - просматривать баланс казны; - открывать отдельное меню управления казной, пополнять её и снимать деньги. Оформление, слоты, материалы, названия и описания кнопок настраиваются в `gui.yml`. ### Рабочие смены и государственные структуры - `/f work` начинает или завершает рабочую смену. - Доступ к служебным функциям можно ограничить конкретными фракциями и состоянием «на смене». - При начале смены сотруднику может выдаваться форма, наручники и временная оружейная лицензия. - При завершении смены временное снаряжение удаляется, а прежняя броня возвращается. - Встроенные NPC отсутствуют: команду `/f work` можно привязать к NPC из Citizens или другого плагина. - Нового сотрудника можно автоматически телепортировать на базу организации. - Каждой фракции можно назначить отдельный регион WorldGuard. ### Чаты - `/fc` — внутренний чат фракции. - `/gov` — государственная волна для разрешённых организаций. - `/d` — чат департамента для настроенных государственных фракций. - `/rr` — локальная RP-рация. - `/rb` — глобальная non-RP-рация. Доступ к каналам определяется конфигурацией, фракцией, рангом и правами. ## Полиция, наручники и розыск ### Наручники - Служебные наручники работают только у разрешённых сотрудников на рабочей смене. - После задержания игрок следует за сотрудником; движение сглажено и не привязано жёстко к поворотам головы полицейского. - У задержанного временно отображается модель скованных рук из ресурс-пака. - Сотрудник с нужным правом может осмотреть задержанного командой `/f inspect <игрок>`. - ПКМ по спине задержанного открывает его инвентарь сотруднику с разрешением. - Право `faction.confiscate` позволяет изымать предметы во время досмотра. - Наручники можно выдать игроку или из консоли через `/f admin give <игрок> handcuffs`. ### Розыск - Полиция может подавать заявку на объявление игрока в розыск через GUI `/wanted`. - Уровень розыска — от 1 до 5; одна единица соответствует одной звезде. - Заявки можно рассматривать, принимать и отклонять в интерфейсе. - `/f search` показывает список разыскиваемых, а `/f search <игрок>` — сведения о конкретном игроке. - Звёзды над игроком выводятся через relational-placeholder и видны только уполномоченной полиции. - Сам разыскиваемый и обычные игроки звёзды не видят. - Маска скрывает розыск и имеет собственную модель в ресурс-паке. - Обычный `%faction_wanted_stars%` намеренно пуст; для неймтега используется `%rel_faction_wanted_stars%`. ## СМИ и объявления - `/ad` или `/media` открывает компактное GUI подачи объявлений. - Игрок выбирает категорию и срок, затем вводит текст в чат. - Объявление отправляется на модерацию. - Рассматривать заявки могут сотрудники СМИ, заступившие на смену через `/f work`. - Одобренные объявления отображаются в GUI и публикуются по заданным правилам. - Деньги за объявление поступают в казну фракции СМИ. - Интерфейс, категории, сроки, цены, сообщения и форматы полностью редактируются в `media.yml`. - Активные заявки не выгружаются, а история завершённых объявлений ограничена для экономии памяти. ## Городской банк - `/bank` открывает интерфейс банка и показывает личный баланс игрока. - `/bank pay <игрок> <сумма>` переводит деньги другому игроку. - Плагин может перехватывать стандартные `/pay` и `/money pay`, чтобы все переводы проходили через банк. - С каждого перевода удерживается настраиваемый налог; по умолчанию 0,5% поступает в казну мэрии. - Банк привязывается к отдельному региону WorldGuard. - Мафия может начать ограбление банка через `/bank rob`, находясь в регионе банка и на криминальной смене. - Ограбление разрешается только при заданном количестве полицейских онлайн — по умолчанию не менее пяти. - Успешное ограбление приносит грязные деньги и вызывает оповещение полиции. ## Мафия Команда `/mafia` открывает тайное GUI мафии со следующими системами: - криминальные задания в настроенных регионах; - общий нелегальный склад с отдельными правами на просмотр и изъятие; - выдача игрокам займов из казны мафии; - проценты, срок возврата, добровольное погашение и взыскание просроченных долгов; - грязные деньги и их отмывание с комиссией и риском сигнала полиции; - захват территорий WorldGuard и периодический доход; - улики и их анализ; - семейный чат и сбор участников; - дорогое подпольное лечение; - изготовление поддельных паспортов и оружейных лицензий. Поддельные документы выглядят настоящими для обычного игрока, но могут быть распознаны и конфискованы уполномоченными сотрудниками полиции, армии или мэрии. ## Медицина и травмы - Поддерживаются перелом, кровотечение, ожог, сотрясение и пулевое ранение. - Травмы имеют тяжесть от 1 до 3. - Попадания из QualityArmory определяются как пулевые ранения. - При пулевом ранении тяжести 3/3 игрок не может ходить, прыгать и стрелять, но сохраняет возможность осматриваться. - `/med status` показывает собственное состояние. - `/med diagnose <игрок>` позволяет врачу провести диагностику. - `/med treat <игрок>` выполняет официальное лечение. - По умолчанию 50% стоимости лечения получает врач, а 50% поступает в казну больницы. - `/mafia heal <игрок>` выполняет более дорогое подпольное лечение. - После полного лечения больница может выдать медицинскую справку. ## Паспорта, лицензии и военные билеты - Мэрия выдаёт и отзывает паспорта. - Одному игроку нельзя выдать второй действующий паспорт. - Полиция, мэрия и армия могут выдавать оружейные лицензии при наличии соответствующих прав. - Госпошлина за официальную лицензию распределяется между сотрудником, его фракцией и мэрией. Стандартное распределение: 10% / 40% / 50%. - Мафия создаёт более дорогие поддельные паспорта и лицензии. - Армия выдаёт, проверяет и отзывает военные билеты. - Паспорт, лицензия, медицинская справка, документ об образовании и военный билет являются физическими RP-предметами. - ПКМ таким документом по игроку предъявляет его этому игроку. - Документ об образовании не открывается как обычная книга. - Вступление в организации может требовать документы: больнице — паспорт и образование; полиции и армии — паспорт, образование и военный билет. ## Школа и образование - Стандартная фракция `school` выдаёт образование через GUI `/education`. - Учитель видит только учеников в том же мире и в настраиваемом радиусе — по умолчанию 7 блоков. - Перед выдачей образования требуется действующая медицинская справка. - Справка выдаётся больницей только после лечения всех травм. - Стандартная стоимость справки — 600: 400 получает больница, 100 мэрия и 100 школа. - Виды образования, цены, оформление документов, радиус и GUI редактируются в `education.yml` и `rpitems.yml`. - Администратор может менять цены командами `/education setprice` и `/education setmedicalprice`. ## Экономика фракций - Каждая фракция имеет отдельную казну. - Доступны пополнение, снятие средств, зарплаты рангов и просмотр баланса. - В казну автоматически поступают связанные с фракцией доходы: объявления СМИ, лечение, справки, лицензии, налоги, доход территорий и криминальные операции. - Денежные операции работают через Vault и подключённый экономический плагин. - Изменения данных сохраняются асинхронно, чтобы не блокировать основной поток сервера. ## Основные команды ### Фракции - `/f help` — справка. - `/f invite <игрок>` — пригласить игрока. - `/f accept` — принять приглашение. - `/f leave` — выйти из фракции. - `/f kick <игрок>` — исключить участника, в том числе офлайн. - `/f setrank <игрок> <ранг>` — назначить ранг. - `/f menu` или `/f gui` — открыть лидерское меню. - `/f work` — начать или завершить смену. - `/f home`, `/f sethome` — телепортироваться на базу или установить её. - `/f balance`, `/f deposit <сумма>`, `/f withdraw <сумма>` — казна. - `/f online`, `/f info [id]`, `/f list` — информация о фракциях. - `/f inspect <игрок>` — досмотр задержанного. - `/f wanted`, `/f unwant`, `/f search` — управление розыском. - `/f license give|revoke|check <игрок>` — оружейные лицензии. - `/f military issue|revoke|check <игрок>` — военные билеты. - `/f reload` — перезагрузить конфигурации. ### Остальные системы - `/ad` — объявления СМИ. - `/wanted` — GUI заявок и списка розыска. - `/bank` — городской банк. - `/mafia` — интерфейс и команды мафии. - `/med` — травмы, диагностика, лечение и справки. - `/passport` — паспортная система. - `/education` — школа и образование. ### Администрирование Команды `/f admin` требуют право `faction.admin`: - `setleader`, `forcejoin`, `addrank`, `setrank`, `remove`; - `setbalance`, `freeze`, `rename`, `description`, `color`; - `sethome`, `relation`, `announce`; - `getmessage`, `setmessage`; - `give` для выдачи наручников, маски и других RP-предметов. ## PlaceholderAPI Основные плейсхолдеры: - `%faction_name%`, `%faction_colored_name%`, `%faction_id%`, `%faction_description%`; - `%faction_color%`, `%faction_region%`, `%faction_status%`, `%faction_has_faction%`; - `%faction_rank%`, `%faction_rank_id%`, `%faction_rank_prefix%`; - `%faction_balance%`, `%faction_members%`, `%faction_online%`; - `%faction_allies%`, `%faction_enemies%`, `%faction_home_set%`, `%faction_is_leader%`; - `%faction_injury%`, `%faction_has_passport%`, `%faction_passport_forged%`; - `%faction_weapon_license_forged%`, `%faction_education%`, `%faction_education_id%`; - `%faction_medical_certificate%`, `%faction_wanted_level%`, `%faction_wanted_reason%`; - `%faction_wanted_masked%`, `%faction_wanted_status%`; - `%rel_faction_wanted_stars%` — безопасные звёзды розыска для неймтегов. ## Интеграции и хранение - **Vault** — экономика. - **LuckPerms** — префиксы рангов. - **PlaceholderAPI** — плейсхолдеры. - **WorldGuard** — базы, банк, территории и рабочие регионы. - **QualityArmory** — оружие, лицензии и пулевые ранения. - **YAML или MySQL** — хранение основных данных. - **HikariCP** — пул подключений MySQL. Плагин использует кеширование, индексы участников, пакетные обновления LuckPerms и асинхронную очередь сохранения. Bukkit API, GUI и операции с игровым миром остаются в основном потоке ради безопасности. ## Конфигурационные файлы - `config.yml` — общие параметры, хранилище и стандартные фракции. - `faction-settings.yml` — изменяемые названия, цвета, регионы и ранги фракций. - `factions.yml` — составы, отношения, базы и балансы. - `messages_eu.yml`, `messages_ru.yml` — отдельные редактируемые английские и русские сообщения; язык выбирается через `language` в `config.yml`. - `gui.yml` — лидерские меню. - `government.yml` — госфракции, смены, форма, наручники и чаты. - `wanted-settings.yml`, `wanted-gui.yml`, `wanted.yml` — розыск. - `media.yml`, `media-ads.yml` — СМИ и объявления. - `bank.yml` — банк, налог и ограбления. - `mafia.yml`, `mafia-gui.yml` — мафия. - `civic.yml` — травмы, лечение и паспорта. - `weapons.yml` — оружейные лицензии и госпошлины. - `military.yml` — военные билеты и требования вступления. - `education.yml` — школа, справки и образование. - `rpitems.yml` — внешний вид RP-предметов. ## Совместимость - Java-плагин для серверов Spigot/Paper с `api-version: 1.16`. - Предназначен для линейки Minecraft 1.16.5–1.21.x. - В комплекте может использоваться ресурс-пак с моделями наручников, скованных рук, маски и документов. - Для полноценной экономики требуется Vault и совместимый экономический плагин.