Scavenger-Host

Scavenger Host

Scavenger Host — это модифицированный форк Scavenger под лицензией GPL-3.0 для спидраннов по предметам в Minecraft Fabric. Он позволяет админу сервера, модератору или хосту одиночной игры/LAN выбрать или прокрутить целевой блок или предмет, выбрать дополнительный модификатор испытания, выбрать режим соло/дуо/трио и затем запустить гонку на время командой /scavenger startgame.

Этот форк создан для выделенных серверов, LAN-миров, игры через Radmin VPN и одиночных миров.

Что он добавляет

• Готовые к серверу забеги Scavenger с синхронизированными данными о предмете, модификаторе, таймере, победителе и экране победы.
• Меню управления для админов, модераторов, операторов сервера и хостов одиночной игры/LAN.
• Отдельные этапы подготовки и запуска, так что выбор команд или прокрутка колёс не запускают таймер.
• /scavenger startgame для запуска подготовленного забега.
• Режимы гонки соло, дуо и трио.
• Команды управления командами для забегов дуо/трио.
• Пользовательские никнеймы Scavenger для чата, сообщений о победе и отображения команд.
• Общие объявления о победе, когда игрок или команда находит целевой предмет.
• Процесс победы в соло, который показывает победителя и затем отключает игроков, чтобы хост мог пересоздать мир.
• Поддержка Minecraft с 1.21 по 1.21.11 с требованиями к зависимостям для каждой версии.
• Более безопасная обработка модификаторов генерации мира: забеги на сервере/LAN отклоняют модификаторы, требующие нового мира, а одиночная игра может пересоздать мир при необходимости.

Установка

Установите Fabric Loader 0.18.4 или новее, Fabric API, Architectury API и правильную сборку OctoLib или ShatterLib для вашей версии Minecraft.

Используйте ровно один jar Scavenger для вашей версии Minecraft. Например, используйте jar Scavenger для 1.21.1 только на Minecraft 1.21.1.

На Modrinth каждая версия Minecraft должна быть загружена как отдельная версия проекта с одним основным jar Scavenger. Не загружайте jar для других версий Minecraft как дополнительные файлы. Дополнительные файлы следует использовать только для таких вещей, как sources.jar или Javadocs.

Зависимости версий

Не смешивайте зависимости из разных версий Minecraft. Например, Architectury 19.0.1 предназначен для Minecraft 1.21.11 и не должен устанавливаться на профиль Minecraft 1.21.1.

Как начать забег

1. Зайдите на выделенный сервер, LAN-мир или одиночный мир.
2. Админ, оператор, модератор или хост открывает меню Scavenger или использует команды.
3. Прокрутите или выберите целевой блок/предмет.
4. Прокрутите или выберите модификатор.
5. Выберите solo, duo или trio.
6. Настройте команды, если режим duo или trio.
7. Запустите /scavenger startgame, когда все готовы.

Подготовка забега не запускает таймер. Таймер запускается только после /scavenger startgame.

Режимы

• solo: каждый игрок гоняется в одиночку. Побеждает первый игрок, получивший целевой предмет.
• duo: в командах может быть до 2 игроков. Если один участник команды получает целевой предмет, побеждает вся команда.
• trio: в командах может быть до 3 игроков. Если один участник команды получает целевой предмет, побеждает вся команда.

Игроки без команды в режиме дуо или трио участвуют как одиночки. Слишком большие команды блокируются при старте игры.

Команды

Команды управления требуют прав оператора/администратора сервера либо доступа хоста в одиночной игре/LAN.

/scavenger
/scavenger help
/scavenger menu
/scavenger random
/scavenger random <solo|duo|trio>
/scavenger start <item> <modifier>
/scavenger start <item> <modifier> <solo|duo|trio>
/scavenger startgame
/scavenger stop
/scavenger clear

Команды команд:

/scavenger addteam <leader> add <player>
/scavenger addteam <leader> remove <player>
/scavenger addteam <leader> list
/scavenger addteam <leader> delete
/scavenger addteam <leader> clear
/scavenger team <leader> add <player>
/scavenger teams
/scavenger teamlist
/scavenger teams clear
/scavenger unteam <player>

Команды ников:

/scavenger nick
/scavenger nick <nickname>
/scavenger nick clear
/scavenger nick set <player> <nickname>
/scavenger nick clearplayer <player>
/scavenger nick list

Примеры:

/scavenger random duo
/scavenger addteam minesgames11 add vanya228
/scavenger nick SpeedRunner
/scavenger start minecraft:diamond scavenger:none trio
/scavenger startgame

Конфигурация

Файл конфигурации сохраняется по пути:

config/scavenger.yaml

Можно настроить отображение таймера, поведение колеса, предметы для прокрутки, записи чёрного списка модификаторов, поведение чёрного/белого списка предметов и цвета экрана победы.

Лицензия и атрибуция

Этот проект — изменённый форк Scavenger от catboybinary.

• Оригинальный проект: https://github.com/catboybinary/scavenger
• Исходный репозиторий форка: https://github.com/nrxzwq/scavenger-host
• Лицензия: GNU General Public License v3.0

Этот форк сохраняет лицензию GPL-3.0, включает текст оригинальной лицензии и помечает проект как изменённый. См. NOTICE.md для атрибуции и краткого описания основных изменений форка.