Plugin Mechanics ⚡Ultra Prison Core ⚡️ X-PRISON [1.12.13]

Описание плагина X-PRISON:​

Оптимальное решение для вашего сервера Prison. Это ядро содержит все, что должно быть на каждом тюремном сервере. Включая тюремные шахты, 20+ пользовательских энчантов, Автопродажа, автоминеральный регион, банды, уровни кирки, валюты жетонов и самоцветов, ранги и престижи, множители и многое другое, это одно из лучших тюремных ядер на рынке.

Особенности плагина X-PRISON:​

• Пользовательские зачарования Твои игроки точно получат удовольствие от наших 20+ пользовательских зачарований! Ты также можешь создавать свои собственные зачарования!
• Тюремные шахты Создавай и управляй тюремными шахтами с помощью нашего удобного внутриигрового интерфейса. Идёт с очень хорошо оптимизированными сбросами шахт.
• Автопродажа Позволь своим игрокам продавать добытые блоки мгновенно за деньги.
• Токены и самоцветы Токены используются для покупки различных улучшений. Ты можешь использовать самоцветы для своих идей.
• Престижи и ранги Позволь своим игрокам подниматься по рангам! Добавь столько престижей и рангов, сколько пожелаешь, вместе с их наградами.
• Множители Дай своим игрокам разные множители рангов, глобальные или временные множители.
• Награды Вознаграждай своих игроков за игру. Есть множество различных настраиваемых наград!
• Лёгкий сброс Текущий сезон завершён? Ты можешь легко сбросить данные игроков всего одним кликом!
• Банды Позволь своим игрокам объединяться в группы и доминировать на сервере!

Команды плагина X-PRISON:​

Auto Miner (Автоматический майнер)

• /autominer - Показывает оставшееся время автоматического майнера игрока.
• /adminautominer [give/remove] [player] [time] [time_unit] - Команда администратора для выдачи или удаления времени автоматического майнера у игрока. Поддерживаемые единицы времени: ДНИ, ЧАСЫ, МИНУТЫ, СЕКУНДЫ.

Auto Sell (Автопродажа)

• /autosell - Включает или выключает режим автопродажи.
• /sellprice [price] - Устанавливает цену продажи для предмета в руке и для шахты, в которой находится игрок.
• /sellall - Команда игрока для продажи всех предметов в инвентаре. Игрок должен находиться в тюремной шахте!

Enchants (Зачарования)

• /givefirstjoinpickaxe {player} - Команда администратора для выдачи первой кирки при входе, определенной в enchants.yml, конкретному игроку.
• /givepickaxe {player} [enchant:rawName=level,enchant:rawName=level...] - Команда администратора для выдачи кирок с пользовательскими зачарованиями. (Например, /givepickaxe Drawethree fortune=10,efficiency=50)
• /disenchant - Открывает интерфейс снятия зачарований. Игроку необходимо держать в руке кирку.
• /value - Отображает стоимость текущей кирки игрока в руке. По умолчанию для игроков установлен кулдаун 30 секунд.

Gems (Самоцветы)

• /gems {player} - Команда для показа самоцветов у себя или другого игрока.
• /gemstop - Отображает таблицу лидеров по количеству самоцветов.
• /gems give [player] [amount] - Команда администратора для выдачи определенного количества самоцветов игроку.
• /gems remove [player] [amount] - Команда администратора для удаления определенного количества самоцветов у игрока.
• /gems set [player] [amount] - Команда администратора для установки определенного количества самоцветов у игрока.
• /gems pay [player] [amount] - Команда игрока для передачи определенного количества самоцветов другому игроку.
• /gems help - Отображает справку по командам.
• /gemsmessage - Отключает сообщения, когда ты получаешь самоцветы при добыче.

Multipliers (Множители)

• /gmulti [sell/token] [multiplier] [duration] [time_unit] - Команда администратора для установки глобального множителя продаж или токенов на определенное время. Поддерживаемые единицы времени: ДНИ, ЧАСЫ, МИНУТЫ, СЕКУНДЫ.
• /gmulti [sell/token] reset - Команда администратора для сброса глобального множителя продаж или токенов.
• /sellmulti [player] [multiplier] [duration] [time_unit] - Команда администратора для установки множителя продаж игрока на определенное время. Поддерживаемые единицы времени: ДНИ, ЧАСЫ, МИНУТЫ, СЕКУНДЫ.
• /tokenmulti [player] [multiplier] [duration] [time_unit] - Команда администратора для установки множителя токенов игрока на определенное время. Поддерживаемые единицы времени: ДНИ, ЧАСЫ, МИНУТЫ, СЕКУНДЫ.
• /multi - Команда игрока для отображения всех текущих активных множителей.

Ranks & Prestiges (Ранги и Престижи)

• /rankup - Попытка повысить ранг. Если у игрока достаточно денег для следующего ранга, повышение будет успешным.
• /maxrankup - Попытка купить максимальный доступный ранг, который игрок может себе позволить.
• /setrank [player] [rank_id] - Команда администратора для принудительной установки ранга онлайн игроку.
• /prestige - Попытка повысить престиж. Если у игрока достаточно денег для следующего престижа, повышение будет успешным.
• /maxprestige - Попытка купить максимальный доступный престиж, который игрок может себе позволить.
• /prestigetop - Отображает таблицу лидеров по престижам.
• /prestigeadmin add [player] [amount] - Добавляет уровни престижа игроку.
• /prestigeadmin set [player] [amount] - Устанавливает уровни престижа игроку.
• /prestigeadmin remove [player] [amount] - Удаляет уровни престижа у игрока.

Tokens (Токены)

• /tokens {player} - Отображает токены у себя или другого игрока.
• /tokenmessage - Отключает сообщения, когда ты получаешь токены при зачаровании.
• /tokens give [player] [amount] - Команда администратора для выдачи определенного количества токенов игроку.
• /tokens remove [player] [amount] - Команда администратора для удаления определенного количества токенов у игрока.
• /tokens set [player] [amount] - Команда администратора для установки определенного количества токенов у игрока.
• /tokens pay [player] [amount] - Команда игрока для передачи определенного количества токенов другому игроку.
• /tokens withdraw [amount] [value] - Команда игрока для вывода токенов и их превращения в физический предмет.
• /tokens help - Отображает справку по командам.

Gangs (Банды)

• /gang create [name] - Создать новую банду с указанным именем.
• /gang invite [player] - Пригласить игрока в свою банду.
• /gang kick [player] - Исключить игрока из своей банды.
• /gang info [player/gang] - Отображает информацию о банде.
• /gang chat - Переключает режим чата банды.
• /gang top - Отображает топ 10 банд.
• /gang accept - Принять приглашение в банду (вступить в банду).
• /gang value add [gang] [value] - Добавить очки банде.
• /gang value remove [gang] [value] - Удалить очки у банды.
• /gang admin add [player] [gang] - Принудительно добавить игрока в конкретную банду.
• /gang admin remove [player] [gang] - Принудительно удалить игрока из конкретной банды.
• /gang admin disband [gang] - Принудительно расформировать банду.

Mines (Шахты)

• /mines create [name] - Создать новую шахту.
• /mines delete [name] - Удалить шахту.
• /mines redefine [name] - Переопределить область шахты.
• /mines rename [name] [new_name] - Переименовать шахту.
• /mines reset [name] - Принудительно сбросить шахту в зависимости от типа сброса (мгновенный/постепенный).
• /mines panel [name] - Открывает панель (GUI настройки) для конкретной шахты.
• /mines save [name] - Принудительно сохранить шахту.
• /mines addblock [name] - Добавляет блок, который ты держишь в руке, в указанную шахту.
• /mines settp [name] - Устанавливает точку телепортации для конкретной шахты.
• /mines tp [name] - Телепортирует тебя в шахту (Требует права xprison.mines.tp.[name]).
• /mines list - Показывает все шахты в GUI.
• /mines tool - Выдает инструмент для выбора области шахты.

Права плагина :​

Разрешения​

Общие

• xprison.admin - Администраторское право для перезагрузки плагина или сброса баз данных.

Tokens (Токены)

• xprison.tokens.admin - Администраторское право.
• xprison.tokens.command.give - Право выдавать токены игроку.
• xprison.tokens.command.pay - Право позволять отправлять токены между игроками.
• xprison.tokens.command.remove - Право удалять токены у игрока.
• xprison.tokens.command.set - Право устанавливать токены игроку.
• xprison.tokens.command.withdraw - Право выводить токены в физический предмет.

Gems (Самоцветы)

• xprison.gems.admin - Администраторское право.
• xprison.gems.command.give - Право выдавать самоцветы игроку.
• xprison.gems.command.pay - Право позволять отправлять самоцветы между игроками.
• xprison.gems.command.remove - Право удалять самоцветы у игрока.
• xprison.gems.command.set - Право устанавливать самоцветы игроку.
• xprison.gems.command.withdraw - Право выводить самоцветы в физический предмет.

Ranks & Prestiges (Ранги и Престижи)

• xprison.ranks.admin - Администраторское право для управления рангами и престижами.
• xprison.ranks.maxrankup - Право использовать команду /maxrankup.
• xprison.prestiges.admin - Администраторское право для управления престижами.
• xprison.prestiges.maxprestige - Право использовать команду /maxprestige.

Mines (Шахты)

• xprison.mines.admin - Администраторское право для управления шахтами.

Gangs (Банды)

• xprison.gangs.admin - Администраторское право для управления бандами.
• xprison.gangs.create - Право игрока на создание банды.

Multipliers (Множители)

• xprison.multipliers.admin - Администраторское право для управления множителями (глобальными/персональными).
• xprison.multiplier.{rank} - Право игрока на получение множителей рангов.

AutoSell (Автопродажа)

• xprison.autosell.admin - Администраторское право для установки цены продажи предмета для конкретной шахты и других вещей, связанных с автопродажей.
• xprison.autosell.toggle - Право игрока на переключение команды /autosell.

AutoMiner (Автоматический майнер)

• xprison.autominer.admin - Администраторское право для управления автоматическим майнером.

Плэйсхолдеры плагина X-PRISON:​

Tokens Placeholders (Токены)​

• %xprison_tokens% - Отображает токены игрока в виде числа.
• %xprison_tokens_formatted% - Отображает токены игрока в формате строки.
• %xprison_blocks% - Отображает общее количество добытых блоков игрока в виде числа.
• %xprison_tokens_1% - Отображает токены игрока в виде числа (например, 1000).
• %xprison_tokens_2% - Отображает токены игрока с разделением тысяч запятой (например, 1,000).
• %xprison_tokens_3% - Отображает токены игрока в формате (например, 1.0k).
• %xprison_blocks_1% - Отображает количество добытых блоков игрока в виде числа (например, 1000).
• %xprison_blocks_2% - Отображает количество добытых блоков игрока с разделением тысяч запятой (например, 1,000).
• %xprison_blocks_3% - Отображает количество добытых блоков игрока в формате (например, 1.0k).

Gems Placeholders (Самоцветы)​

• %xprison_gems% - Отображает самоцветы игрока.
• %xprison_gems_formatted% - Отображает самоцветы игрока в формате строки.
• %xprison_gems_1% - Отображает самоцветы игрока в виде числа (например, 1000).
• %xprison_gems_2% - Отображает самоцветы игрока с разделением тысяч запятой (например, 1,000).
• %xprison_gems_3% - Отображает самоцветы игрока в формате (например, 1.0k).

Ranks Placeholders (Ранги)​

• %xprison_rank% - Отображает текущий тюремный ранг игрока с префиксом.
• %xprison_next_rank% - Отображает следующий ранг игрока.
• %xprison_rankup_progress% - Отображает прогресс повышения ранга/престижа в процентах.
• %xprison_rankup_progress_bar% - Отображает прогресс-бар текущего повышения ранга/престижа.
• %xprison_next_rank_cost% - Отображает стоимость следующего ранга для игрока или стоимость следующего престижа, если у игрока максимальный ранг. (например, 1,000.00)
• %xprison_next_rank_cost_formatted% - Отображает форматированную стоимость следующего ранга (например, 1.0k).

Prestige Placeholders (Престижи)​

• %xprison_prestige% - Отображает текущий престиж игрока.
• %xprison_prestige_id% - Отображает ID (числовое значение) текущего престижа игрока.

Multiplier Placeholders (Множители)​

• %xprison_multiplier_sell% - Отображает множитель продаж игрока.
• %xprison_multiplier_token% - Отображает множитель токенов игрока.
• %xprison_multiplier_global_sell% - Отображает глобальный множитель продаж.
• %xprison_multiplier_global_token% - Отображает глобальный множитель токенов.

Pickaxe Levels Placeholders (Уровни кирки)​

• %xprison_pickaxe_progress% - Отображает прогресс-бар текущего уровня кирки, которую держит игрок.

Autominer Placeholders (Автоматический майнер)​

• %xprison_autominer_time% - Отображает оставшееся время автоматического майнера игрока.

Gang Placeholders (Банды)​

• %xprison_gang_name% - Отображает название банды, в которой находится игрок.
• %xprison_gang_value% - Отображает ценность банды, в которой находится игрок.
• %xprison_gang_has_gang% - Возвращает "Yes", если у игрока есть банда, или "No", если нет.
• %xprison_gang_is_leader% - Возвращает "Yes", если у игрока есть банда, и он является её лидером, или "No", если он не лидер.
• %xprison_gang_leader_name% - Возвращает имя лидера банды, если у игрока есть банда, или пустую строку, если нет.
• %xprison_gang_members_amount% - Возвращает количество членов банды игрока, если у него есть банда, или пустую строку, если нет.
• %xprison_gang_members_online% - Возвращает количество онлайн членов банды игрока, если у него есть банда, или пустую строку, если нет.

Mines Placeholders (Шахты)​

• %xprison_mine_[mine_name]_blocks_left% - Отображает текущее количество оставшихся блоков в указанной шахте.
• %xprison_mine_[mine_name]_blocks_left_percentage% - Отображает текущий процент оставшихся блоков в указанной шахте (например, 50.49, без знака '%').
• %xprison_mine_[mine_name]_reset_time% - Отображает отформатированное время до следующего сброса шахты (например, 1h 30m 50s).

Установка плагина X-PRISON:​

Установка плагина на сервер:​

1. Скачай последнюю версию UltraPrisonCore.
2. Скачай и установи плагины helper, WorldEdit, WorldGuard и Vault, так как они необходимы как зависимости. Не переживай за helper — это просто библиотека
3. Перемести файл UltraPrisonCore-X.X.X.jar в папку /plugins на сервере Minecraft.
4. Перезапусти или перезагрузи сервер.
5. После перезапуска выбери систему базы данных в файле /plugins/UltraPrisonCore/config.yml. Ты можешь использовать SQLite как локальную базу данных или MySQL как удаленную базу данных. Если ты выберешь MySQL, также укажи учетные данные для подключения в соответствующем разделе конфигурации.

Примечание: Требуется Java 8 и выше. Примечание: Если ты хочешь использовать наборы (Kits) из Essentials вместе с пользовательскими зачарованиями из этого плагина, ознакомься с аддоном Essentials Kits.

Настройка плагина:​

Примечание: В плагине есть много полезных команд, чтобы получить максимум от его использования. Обязательно ознакомься с вики страницей команд! Примечание: Большинство настроек выполняется через конфигурационные файлы.

1. Создай тюремные шахты командой /mines create [name]. Перед этим тебе нужно подготовить выделенную область с помощью команды /mines tool.
2. После создания шахты добавь в неё блоки (содержимое), держа блок в руке и запустив команду /mines addblock [name].
3. После добавления блоков открой панель шахты командой /mines panel [name] и выполни детальную настройку через GUI.
4. Для каждой из твоих тюремных шахт создай регион WorldGuard командой /rg define [name]. После создания региона обязательно установи флаг 'upc-enchants' в значение ALLOW командой /rg flag [name] upc-enchants ALLOW, иначе зачарования не будут работать в этом регионе.
5. Для каждой из твоих тюремных шахт установи цену продажи для блока, который добывается в этой шахте, командой /sellprice [price], держа блок в руке. Для этого ты должен находиться в регионе шахты!
6. Если ты хочешь использовать регион для автомайнера, создай регион WorldGuard с нужным названием. Затем открой конфигурационный файл autominer.yml и обнови значения.

Не забудь проверить все конфигурационные файлы и изменить сообщения по своему усмотрению! Также есть много заранее настроенных элементов, которые ты можешь изменить, добавить или удалить.