RUS

🏆 RandomItemHunt — Охота за Предметами

RandomItemHunt — это соревновательный мини-игровой плагин для Minecraft, в котором игроки или команды должны как можно быстрее найти или скрафтить случайно выбранный предмет. Плагин поддерживает гибкие настройки, модификаторы сложности и режимы игры.

⚙️ Технические характеристики

• Версия игры: Minecraft 1.21.1+ (Paper/Purpur).
• Версия Java: 21.
• Поддержка языков: Русский (RU) и Английский (EN). Переключается в config.yml или через панель администратора.

🏛️ Структура миров и Подготовка

Плагин разделяет пространство на две зоны: Хаб (Лобби) и Игровой мир.

Хаб (мир world по умолчанию):

• Основной мир сервера считается «безопасной зоной» или хабом.
• Важно: Рекомендуется предварительно оформить этот мир (построить красивые постройки, настроить спавн), так как именно здесь игроки будут ждать начала игры и голосовать за настройки.
• При входе в хаб игроки автоматически получают Компас лобби, через который открывается меню готовности.

Игровые миры (hunt_world_...):

• Для каждой новой игры плагин создаёт отдельные временные миры.
• Это позволяет игрокам начинать выживание с чистого листа в нетронутом мире.
• После завершения игры эти миры автоматически удаляются через 15 секунд, чтобы не занимать место на диске.

🎮 Как запустить игру

Существует два способа запуска:

Через Голосование (Для игроков):

• Все участники должны подтвердить готовность (нажать на звезду Незера в меню компаса).
• После этого начнётся фаза голосования за режим (Solo/Duo), тип мира (Shared/Separate) и модификаторы.

Быстрый запуск (Для администратора):

• Администратор открывает панель через /itemhunt admin.
• Переходит на вторую страницу (иконка стрелки).
• Настраивает параметры вручную и нажимает на изумрудный блок (START GAME). Игра начнется мгновенно с выбранными настройками.

📜 Команды и Права

• /itemhunt admin - Открывает панель настроек и быстрого запуска. Доступ itemhunt.admin
• /itemhunt stop - Принудительно останавливает текущую игру. Доступ itemhunt.admin
• /itemhunt info - Показывает текущий целевой предмет (дублирует BossBar).
• /itemhunt invite [ник] - Пригласить игрока в группу (для режима Duo).
• /itemhunt leave - Покинуть текущую группу.
• /itemhunt surrender - Начать голосование за досрочное завершение игры.
• /itemhunt help - Показать список всех команд.

🔥 Особенности и Режимы

• Solo / Duo: Играйте в одиночку против всех или объединяйтесь в пары.
• Shared Inventory (Duo): Уникальная механика, где у напарников общий инвентарь и общее здоровье. Любой урон по одному игроку наносится и второму!
• Модификаторы (Испытания):
  • Серверные: Темнота, ускоренное время, гигантизм, отсутствие регенерации и т.д.
  • Клиентские: Задания на стороне игрока (например, ограничение FOV или запрет на спринт).
• Система BossBar: Вверху экрана всегда отображается иконка нужного предмета, таймер и активный модификатор.
• Безопасный старт: В первую минуту игры PvP отключено, чтобы игроки успели разбежаться.

ENG

🏆 RandomItemHunt — Item Hunt

RandomItemHunt is a competitive minigame plugin for Minecraft where players or teams must find or craft a randomly selected item as quickly as possible. The plugin supports flexible settings, difficulty modifiers, and game modes.

⚙️ Specifications

• Game version: Minecraft 1.21.1+ (Paper/Purpur).
• Java version: 21.
• Language support: Russian (RU) and English (EN). Can be switched in config.yml or through the admin panel.

🏛️ World Structure and Setup

The plugin divides the space into two zones: the Hub (Lobby) and the Game World.

Hub (default world):

• The server's main world is considered the "safe zone" or hub.
• Important: It is recommended to pre-design this world (build beautiful structures, set up spawns), as this is where players will wait for the game to start and vote on settings.
• Upon entering the hub, players automatically receive a Lobby Compass, which opens the Ready menu.

Game Worlds (hunt_world_...):

• For each new game, the plugin creates separate temporary worlds.
• This allows players to start their survival with a clean slate in a pristine world.
• After the game ends, these worlds are automatically deleted after 15 seconds to save disk space.

🎮 How to launch the game

There are two ways to launch:

Vote (For players):

• All participants must confirm their readiness (click the Nether star in the compass menu).
• After this, the voting phase will begin for the mode (Solo/Duo), world type (Shared/Separate), and modifiers.

Quick Launch (For Admin):

• Admin opens the panel via /itemhunt admin.
• Goes to the second page (arrow icon).
• Manually configure settings and click the emerald block (START GAME). The game will start instantly with the selected settings.

📜 Commands and Permissions

• /itemhunt admin - Opens the settings and quick launch panel. Access itemhunt.admin
• /itemhunt stop - Forces stop of the current game. Access itemhunt.admin
• /itemhunt info - Shows the current target item (duplicates the BossBar).
• /itemhunt invite [nickname] - Invite a player to a group (for Duo mode).
• /itemhunt leave - Leave the current group.
• /itemhunt surrender - Start a vote to end the game early.
• /itemhunt help - Show a list of all commands.

🔥 Features and Modes

• Solo / Duo: Play solo against everyone or team up in duos.
• Shared Inventory (Duo): A unique mechanic where partners share inventory and health. Any damage dealt to one player also affects the other!
• Modifiers (Challenges):
• Server-side: Darkness, accelerated time, gigantism, no regeneration, etc.
• Client-side: Player-specific tasks (e.g., limited FOV or no sprinting).
• BossBar System: The icon of the required item, a timer, and the active modifier are always displayed at the top of the screen.
• Safe Start: PvP is disabled during the first minute of the game to allow players time to scatter.