OneBlock

OneBlock: плагин для мини-игры с островами

OneBlock — это серверный плагин для Minecraft, реализующий популярную мини-игру, где игроки разрушают блоки на специально созданном острове для повышения уровня. Плагин поддерживает широкий спектр версий игры (от 1.8 до 26.3) и работает на платформах Bukkit, Paper, Purpur и Spigot. В комплекте предоставляются инструменты для настройки генерации островов, кастомизации прогресс-бара, управления правами доступа и интеграции с популярными системами плашек, такими как PlaceholderAPI.

🌍 Создание и настройка мира

Для запуска игры необходимо создать отдельный мир, предназначенный исключительно для режима OneBlock. Рекомендуется использовать плагины типа Multiverse-Core для генерации мира с нужными параметрами. После создания мира администратор должен установить точку спавна (спавн-пункт) для игроков, используя команду /ob set. Эта команда позволяет задать начальную позицию и смещение острова. Игроки могут телепортироваться на свой остров, введя команду /ob join или сокращённую версию /ob.

🔧 Справочник команд

Плагин предоставляет обширный набор команд для управления игрой и настройки поведения.

🎨 Кастомизация прогресс-бара

Администратор может настроить внешний вид прогресс-бара, отображающего текущий уровень игрока. Доступна возможность изменения цвета полоски для каждого уровня отдельно через файл конфигурации blocks.yml. Команда /ob progress_bar level позволяет переключить режим отображения уровня в прогресс-баре. Также предусмотрена возможность изменения текста, отображаемого в прогресс-баре.

📊 Поддержка PlaceholderAPI

Плагин поддерживает интеграцию с библиотекой плашек PlaceholderAPI, предоставляя доступ к множеству переменных для отображения статистики игроков и состояния игры. Доступные плашки включают текущий уровень игрока (`%OB_lvl%`), количество блоков для следующего уровня (`%OB_need_to_lvl_up%`), количество игроков на сервере (`%OB_player_count%`) и имя владельца острова (`%OB_owner_name%`).

🎯 Позиционные модификаторы плашек

Особая функция плашек позволяет получать информацию не о собственном острове, а об острове в текущей позиции игрока. Для этого к любой плашке добавляется модификатор _by_position. Например, плашка %OB_lvl_by_position% покажет уровень острова, на котором находится игрок в данный момент. Это особенно полезно при просмотре чужих островов или создании плашек, отображающих информацию о локальном окружении.

🧱 Поддержка кастомных блоков

Плагин поддерживает использование блоков из различных библиотек и плагинов, таких как ItemsAdder, Oraxen, Nexo и CraftEngine, благодаря нативной поддержке их идентификаторов в файле blocks.yml. Также можно использовать блоки из других модов или плагинов, используя команды из блоков конфигурации. Примеры команд для спавна блоков из мода IC2 включают использование команд /execute для установки блоков в мире.

🏝️ Шаблоны островов

Администратор может создать собственные шаблоны островов размером 7x12x7 блоков. Команда /ob islands set_my_by_def сохраняет копию текущего острова и устанавливает её в качестве шаблона по умолчанию для всех новых игроков. Также доступна команда /ob islands default для сброса к стандартному шаблону.