Beacon Flight 2

BeaconFlight

BeaconFlight позволяет активным маякам давать креативный полёт при выполнении настраиваемых условий.

Игровая логика работает на стороне сервера, так что мод работает на выделенных серверах с ванильными клиентами. Тот же jar можно использовать и в одиночной игре. Если установить на клиент Mod Menu и Cloth Config, мод также покажет экран настроек прямо в игре.

Совместимость

• Minecraft 1.21 – 1.21.11
• Fabric Loader 0.15.11+
• Java 21+
• Требуется Fabric API
• Mod Menu опционально
• Cloth Config опционально

Как это работает

• Маяк должен быть активен и иметь выбранный основной эффект.
• По умолчанию BeaconFlight требует маяк 4 уровня и достижение minecraft:end/elytra.
• Пока игрок находится в радиусе действия и выполняет все настроенные требования, полёт разрешён.
• Когда игрок выходит из радиуса, полёт может сохраняться ещё настраиваемое время.
• Если полёт пропадает, пока игрок в воздухе, автоматически может применяться Замедленное падение.

Установка

1. Установите Fabric Loader и Fabric API для нужной версии Minecraft.
2. Поместите jar BeaconFlight в папку mods.
3. На выделенном сервере мод нужен только серверу, чтобы полёт работал.
4. В одиночной игре просто установите jar на клиент.
5. Запустите игру или сервер один раз, чтобы создался файл конфига.

Файл конфига создаётся по пути:

config/beaconflight_config.json

Настройка

Можно редактировать JSON напрямую или использовать экран настроек Mod Menu, если установлены Mod Menu и Cloth Config.

Доступные опции:

• minBeaconLevel: минимальный требуемый уровень пирамиды маяка. Допустимые значения — от 1 до 4.
• mainHandItem: требуемый предмет в основной руке игрока, или null.
• offHandItem: требуемый предмет во второй руке игрока, или null.
• anyHandItem: требуемый предмет в любой руке, или null.
• headItem: требуемый предмет в слоте шлема, или null.
• chestItem: требуемый предмет в слоте нагрудника, или null.
• legsItem: требуемый предмет в слоте штанов, или null.
• feetItem: требуемый предмет в слоте ботинок, или null.
• advancementsRequired: список id достижений, которые игрок должен получить.
• xpDrainRate: сколько опыта тратится в секунду активного полёта. Используйте 0.0, чтобы отключить расход опыта.
• flightLingerTime: своя длительность сохранения полёта в тиках после выхода игрока из радиуса маяка. Используйте 0, чтобы использовать обычную длительность эффекта маяка.
• slowFallingTime: длительность Замедленного падения в секундах после потери полёта.
• logLevel: уровень логирования BeaconFlight. Полезные значения — INFO, DEBUG, TRACE, ALL и OFF.

Примечания:

• Поля предметов должны использовать id предметов, например minecraft:diamond_chestplate.
• Поля достижений должны использовать id достижений, например minecraft:end/elytra.
• Сброс конфига возвращает стандартные требования, а это не минимальная тестовая настройка.

Конфиг по умолчанию:

{
  "minBeaconLevel": 4,
  "mainHandItem": null,
  "offHandItem": null,
  "anyHandItem": null,
  "headItem": null,
  "chestItem": null,
  "legsItem": null,
  "feetItem": null,
  "advancementsRequired": [
    "minecraft:end/elytra"
  ],
  "xpDrainRate": 0.0,
  "flightLingerTime": 0,
  "slowFallingTime": 10,
  "logLevel": "INFO"
}

Минимальный конфиг для тестирования:

{
  "minBeaconLevel": 1,
  "mainHandItem": null,
  "offHandItem": null,
  "anyHandItem": null,
  "headItem": null,
  "chestItem": null,
  "legsItem": null,
  "feetItem": null,
  "advancementsRequired": [],
  "xpDrainRate": 0.0,
  "flightLingerTime": 0,
  "slowFallingTime": 10,
  "logLevel": "ALL"
}

Решение проблем

• Если полёт не включается, убедитесь, что маяк действительно активен и у него выбран основной эффект.
• Если вы использовали «reset» в интерфейсе конфига, помните, что стандартные настройки всё ещё требуют маяк 4 уровня и достижение Elytra.
• Установите logLevel в ALL, чтобы получать сообщения о выдаче и отказе в игровом логе.
• Если хотите чистый тест, уберите все требования к предметам, очистите advancementsRequired и поставьте minBeaconLevel под ваш маяк.

Сборка из исходников

Используйте обёртку Gradle:

.\gradlew.bat build

Собранный jar-файл находится в:

build/libs/

Благодарности

• Оригинальный мод: ExtraCrafTX/BeaconFlight
• Оригинальный автор: ExtraCrafTX
• Спасибо @xAlicatt за оригинальную идею, заказ мода и тестирование.