RandomItemHunt - Spedrun Item

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.